SEsearchable
Topics

Get prompt rankings within a topic

Changed on

The prompt-level drill-down into one topic: for every prompt assigned to it, the brand's average rank, its visibility, and the competitors ranking above it. Answers which specific questions a weak topic is losing on. topicId is required — rankings are scoped to a single topic.

get/api/mcp/projects/{projectId}/topics/prompt-rankings

Request

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

Path parameters

projectIdstring uuid required

The project id.

Query parameters

topicIdstring uuid required

The topic to rank prompts within. Required.

daysinteger

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

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.

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.

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.

Response

Per-prompt rankings within the topic.

topicIdstring required
totalPromptsnumber required

Changes