Skip to main content
GET
Most-cited pages

Authorizations

Authorization
string
header
required

Your API key, e.g. Authorization: Bearer gp_live_....

Path Parameters

id
string<uuid>
required

Brand id.

Query Parameters

engine
enum<string>

Restrict to one engine. Omit for the all-engine rollup. Stable public engine identifier. Internal model names are never exposed.

Available options:
chatgpt,
claude,
perplexity,
gemini,
google_ai_overviews,
google_ai_mode,
copilot
topic
string<uuid>

Restrict to prompts in one topic.

from
string<date>

Inclusive start date. Defaults to 30 days before to.

to
string<date>

Exclusive end date. Defaults to tomorrow.

limit
integer
default:100

How many rows to return, ranked by citation count. Max 2000. There is no paging past this: check capped in the response.

Required range: x <= 2000

Response

Success

data
object[]
required
has_more
boolean

Always false: this grain does not page.

next_cursor
string | null

Always null: this grain does not page.

total_count
integer

How many rows matched in total, before the limit.

total_citations
integer

Total citations across ALL matching rows. The denominator behind citation_share.

capped
boolean

True when total_count exceeds the rows returned, so this is the top N and not the complete set.