Retrieve GEO analyses summary

Each analysis carries its current run, scores (including brand share of voice), signed change versus the previous run, prompt count and recommendation count.

range defaults to daily: the newest completed run on or before yesterday in the analysis timezone, against the day before. Analyses without a completed run for the range are omitted.

Every filter is optional and narrows the result. The list is not paginated; pass ids to bound it.

providers recomputes scores, share of voice, and their changes from those AI providers only. Brand mention rate is the average of the selected providers; citation rate, sentiment, and share of voice pool their responses. Rows stay. A side that cannot be scored for the selection has no score and no share of voice. Brand Accuracy stays the pooled value.

Query Params
string

Case-insensitive substring match on the analysis label.

string

Case-insensitive substring match on the website.

string

Comma-separated analysis ids.

regions
array of strings

Comma-separated country markets. unset matches analyses that use provider defaults.

regions
string

Comma-separated IANA timezones.

statuses
array of strings

Comma-separated schedule status types. active also matches analyses that have never been scheduled.

statuses
Allowed:
schedules
array of strings

Comma-separated schedule cadences.

schedules
Allowed:
providers
array of strings

Comma-separated AI providers. Scores, share of voice, and their changes are recomputed from these providers only. Brand mention rate is the average of the selected providers; citation rate, sentiment, and share of voice pool their responses. Rows are never removed.

providers
Allowed:
string
enum
Defaults to daily

Window the signed change is computed over, with the same boundaries as trends.

Allowed:
string

Anchor day (YYYY-MM-DD) used only when range=daily. Defaults to yesterday in each analysis timezone.

Response

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json