Get shopping product detail

curl --request GET \
  --url https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "name": "<string>",
  "mentionCount": 123,
  "dateRange": {
    "from": "2023-11-07T05:31:56Z",
    "to": "2023-11-07T05:31:56Z"
  },
  "description": "<string>",
  "summary": "<string>",
  "image": "<string>",
  "images": [
    {}
  ],
  "tag": "<string>",
  "rating": 123,
  "reviews": 123,
  "link": "<string>",
  "trend": {},
  "vendors": [
    {}
  ],
  "platforms": [
    {}
  ],
  "responses": [
    {
      "responseId": "<string>",
      "promptId": "<string>",
      "promptText": "<string>",
      "platform": "<string>",
      "respondedAt": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "error": "<string>",
  "message": "<string>",
  "howToFix": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresUpgrade": true,
  "retryable": true,
  "timeout": true,
  "quotaExceeded": true,
  "current": 123,
  "limit": 123,
  "bulkLimitExceeded": true,
  "requested": 123,
  "maxAllowed": 123,
  "details": {
    "formErrors": [
      "<string>"
    ],
    "fieldErrors": {}
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "error": "<string>",
  "message": "<string>",
  "howToFix": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresUpgrade": true,
  "retryable": true,
  "timeout": true,
  "quotaExceeded": true,
  "current": 123,
  "limit": 123,
  "bulkLimitExceeded": true,
  "requested": 123,
  "maxAllowed": 123,
  "details": {
    "formErrors": [
      "<string>"
    ],
    "fieldErrors": {}
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "error": "<string>",
  "message": "<string>",
  "howToFix": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresUpgrade": true,
  "retryable": true,
  "timeout": true,
  "quotaExceeded": true,
  "current": 123,
  "limit": 123,
  "bulkLimitExceeded": true,
  "requested": 123,
  "maxAllowed": 123,
  "details": {
    "formErrors": [
      "<string>"
    ],
    "fieldErrors": {}
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "error": "<string>",
  "message": "<string>",
  "howToFix": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresUpgrade": true,
  "retryable": true,
  "timeout": true,
  "quotaExceeded": true,
  "current": 123,
  "limit": 123,
  "bulkLimitExceeded": true,
  "requested": 123,
  "maxAllowed": 123,
  "details": {
    "formErrors": [
      "<string>"
    ],
    "fieldErrors": {}
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "error": "<string>",
  "message": "<string>",
  "howToFix": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresUpgrade": true,
  "retryable": true,
  "timeout": true,
  "quotaExceeded": true,
  "current": 123,
  "limit": 123,
  "bulkLimitExceeded": true,
  "requested": 123,
  "maxAllowed": 123,
  "details": {
    "formErrors": [
      "<string>"
    ],
    "fieldErrors": {}
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "error": "<string>",
  "message": "<string>",
  "howToFix": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresUpgrade": true,
  "retryable": true,
  "timeout": true,
  "quotaExceeded": true,
  "current": 123,
  "limit": 123,
  "bulkLimitExceeded": true,
  "requested": 123,
  "maxAllowed": 123,
  "details": {
    "formErrors": [
      "<string>"
    ],
    "fieldErrors": {}
  }
}

GET

api

mcp

projects

{projectId}

shopping

products

{productId}

Get shopping product detail

curl --request GET \
  --url https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.searchable.com/api/mcp/projects/{projectId}/shopping/products/{productId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "name": "<string>",
  "mentionCount": 123,
  "dateRange": {
    "from": "2023-11-07T05:31:56Z",
    "to": "2023-11-07T05:31:56Z"
  },
  "description": "<string>",
  "summary": "<string>",
  "image": "<string>",
  "images": [
    {}
  ],
  "tag": "<string>",
  "rating": 123,
  "reviews": 123,
  "link": "<string>",
  "trend": {},
  "vendors": [
    {}
  ],
  "platforms": [
    {}
  ],
  "responses": [
    {
      "responseId": "<string>",
      "promptId": "<string>",
      "promptText": "<string>",
      "platform": "<string>",
      "respondedAt": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "error": "<string>",
  "message": "<string>",
  "howToFix": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresUpgrade": true,
  "retryable": true,
  "timeout": true,
  "quotaExceeded": true,
  "current": 123,
  "limit": 123,
  "bulkLimitExceeded": true,
  "requested": 123,
  "maxAllowed": 123,
  "details": {
    "formErrors": [
      "<string>"
    ],
    "fieldErrors": {}
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "error": "<string>",
  "message": "<string>",
  "howToFix": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresUpgrade": true,
  "retryable": true,
  "timeout": true,
  "quotaExceeded": true,
  "current": 123,
  "limit": 123,
  "bulkLimitExceeded": true,
  "requested": 123,
  "maxAllowed": 123,
  "details": {
    "formErrors": [
      "<string>"
    ],
    "fieldErrors": {}
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "error": "<string>",
  "message": "<string>",
  "howToFix": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresUpgrade": true,
  "retryable": true,
  "timeout": true,
  "quotaExceeded": true,
  "current": 123,
  "limit": 123,
  "bulkLimitExceeded": true,
  "requested": 123,
  "maxAllowed": 123,
  "details": {
    "formErrors": [
      "<string>"
    ],
    "fieldErrors": {}
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "error": "<string>",
  "message": "<string>",
  "howToFix": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresUpgrade": true,
  "retryable": true,
  "timeout": true,
  "quotaExceeded": true,
  "current": 123,
  "limit": 123,
  "bulkLimitExceeded": true,
  "requested": 123,
  "maxAllowed": 123,
  "details": {
    "formErrors": [
      "<string>"
    ],
    "fieldErrors": {}
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "error": "<string>",
  "message": "<string>",
  "howToFix": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresUpgrade": true,
  "retryable": true,
  "timeout": true,
  "quotaExceeded": true,
  "current": 123,
  "limit": 123,
  "bulkLimitExceeded": true,
  "requested": 123,
  "maxAllowed": 123,
  "details": {
    "formErrors": [
      "<string>"
    ],
    "fieldErrors": {}
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "error": "<string>",
  "message": "<string>",
  "howToFix": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresUpgrade": true,
  "retryable": true,
  "timeout": true,
  "quotaExceeded": true,
  "current": 123,
  "limit": 123,
  "bulkLimitExceeded": true,
  "requested": 123,
  "maxAllowed": 123,
  "details": {
    "formErrors": [
      "<string>"
    ],
    "fieldErrors": {}
  }
}

Authorizations

Authorization

string

header

required

A Searchable API key, created under Settings → Workspace → Integrations. Send as Authorization: Bearer sea_xxxxx. Every key carries one or more scopes (read, write, admin) and may optionally be bound to a single project — see Getting started.

Path Parameters

projectId

string<uuid>

required

The project id.

productId

string

required

The product's raw title, as returned by id on GET /shopping — there is no synthetic product id. Percent-encode when it contains spaces/special characters.

Query Parameters

days

integer

Lookback window in days. Default and maximum vary by endpoint — see the operation description.

Required range: x >= 1

platform

string

Comma-separated AI platform filter (e.g. chatgpt,claude,gemini). Accepted values and whether the param is required vary by endpoint — see the operation description.

Response

Product detail.

string

required

The product's raw title — there is no synthetic product id.

name

string

required

mentionCount

integer

required

dateRange

object

required

The resolved lookback window for this response.

Show child attributes

description

string | null

summary

string | null

image

string | null

images

object[]

tag

string | null

rating

number | null

reviews

integer | null

link

string | null

trend

object

Mention-volume trend for this product.

vendors

object[]

platforms

object[]

responses

object[]

Up to 50 recent responses that surfaced this product, newest first.

Show child attributes

Get shopping visibility summary Get shopping activation timeseries

Get Started

Endpoints

Get shopping product detail

Authorizations

Path Parameters

Query Parameters

Response