Skip to main content
GET
Monitoring records of one prompt

Authorizations

Authorization
string
header
required

API key from Settings → Developer → API keys (prefix geom_). Each key is bound to one brand.

Path Parameters

prompt_id
string
required

Resource id for this API key brand.

Required string length: 1 - 64

Query Parameters

limit
integer
default:100
Required range: 1 <= x <= 200
cursor
string
Required string length: 1 - 512
time_range
enum<string>
default:30d
Available options:
7d,
30d,
90d
start_date
string

First business day; send with end_date (UTC+8 business day, YYYY-MM-DD).

Pattern: ^\d{4}-\d{2}-\d{2}$
end_date
string

Last business day inclusive; maximum 366 days (UTC+8 business day, YYYY-MM-DD).

Pattern: ^\d{4}-\d{2}-\d{2}$
platform
enum<string>
default:all
Available options:
all,
chatgpt,
perplexity,
gemini,
google_ai,
copilot,
google_ai_overview
sort_order
enum<string>
default:desc

Record-day order. Offset pagination is not a snapshot; inserts or deletes can shift pages even in ascending order. Deduplicate by id.

Available options:
asc,
desc

Response

Monitoring records of one prompt. data follows PromptRecordList when meta.schema_conformant is true.

data
object[] | null
required

Monitoring records of one prompt. null only when meta.schema_conformant is false and the output could not be mapped.

page
object
required

Cursor pagination. next_cursor === null is the only end-of-list signal.

meta
object
required