JAjasper
GEO

Retrieve GEO analyses summary

Changed on

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.

get/v1/geo/analyses/summary

Request

  • Base URL
    https://api.jasper.ai
  • URL
    https://api.jasper.ai/v1/geo/analyses/summary
  • Auth
    • API key in header X-API-Key
    • or OAuth 2
      Authorization code: https://api.jasper.ai/oauth2/authorize
      Token URL: https://api.jasper.ai/oauth2/token scopes: user

Query parameters

labelstring
Example:Jasper

Case-insensitive substring match on the analysis label.

websitestring
Example:jasper.ai

Case-insensitive substring match on the website.

idsstring
Example:agc_ABC123,agc_DEF456

Comma-separated analysis ids.

regionsstring[]

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

timezonesstring
Example:UTC,America/New_York

Comma-separated IANA timezones.

statusesstring[]

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

schedulesstring[]

Comma-separated schedule cadences.

providersstring[]

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.

range'daily' | '7d' | '30d' | '60d' | '90d' | 'all'

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

datestring
Example:2026-04-30

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

Response

requestIdstring required
resourcestring required

Example response

{
  "requestId": "8393f82b3f6a4f6e8a405777b9305254",
  "resource": "knowledge",
  "data": {
    "analyses": [
      {
        "configId": "agc_ABC123",
        "label": "Jasper",
        "website": "https://www.jasper.ai",
        "timezone": "UTC",
        "region": "US",
        "schedule": "daily",
        "status": {
          "type": "active"
        },
        "currentRun": {
          "runId": "aga_ABC123",
          "runDate": "2026-09-08",
          "updatedAt": "2026-09-08T04:12:07.000Z",
          "settings": {
            "scopes": [
              {
                "kind": "internal",
                "url": "https://www.jasper.ai/pricing",
                "match": "page"
              }
            ]
          }
        },
        "promptCount": 24,
        "recommendationCount": 12
      }
    ]
  }
}

Changes