SEsearchable
Visibility

Get visibility by AI platform

Changed on

Visibility broken down by AI platform. The same rows appear inside GET /visibility as platforms[]; this endpoint returns that breakdown on its own and can narrow to specific platforms. platform is comma-separated and resolved through the canonical platform map, so it accepts display names (ChatGPT, AI Overviews), aliases (openai, microsoft, xai), and raw model ids alike — platform=chatgpt matches a stored chatgpt-4o without also matching a copilot-gpt-* id, which belongs to Copilot. Filter further with topicId / country / locationId (each must be a UUID; a malformed value returns 400 invalid_argument), and pass unbranded=true or branded=true to filter by prompt brand state. days defaults to 30, max 365.

get/api/mcp/projects/{projectId}/visibility/platforms

Request

  • Base URL
    https://app.searchable.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring uuid required

The project id.

Query parameters

daysinteger

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

unbranded'true'

Pass true to restrict every metric to non-branded prompts only.

branded'true'

Pass true to restrict every metric to branded prompts only.

platformstring

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.

topicIdstring uuid

Restrict to a single topic id.

countrystring

Comma-separated ISO 3166-1 country codes (e.g. US,GB) or country names.

locationIdstring

Comma-separated tracked-location ids.

fromstring
Example:2026-03-01

Start of an absolute window (inclusive, UTC). Accepts YYYY-MM-DD or a full ISO timestamp. Requires to, and is mutually exclusive with days — sending both returns 400 invalid_argument. A range longer than the endpoint's maximum is rejected rather than clamped.

tostring
Example:2026-03-31

End of an absolute window (inclusive, UTC). Accepts YYYY-MM-DD or a full ISO timestamp. Requires from.

Response

Visibility by AI platform.

Changes

  • a1cc70e46e73Revision changes
    • breaking

      the response property / became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • info

      added the optional property / to the response with the status

  • 28a5e2a65cd3Revision changes
    • info

      endpoint added