Skip to main content
GET
/
v1
/
geo
/
snapshots
/
{id}
/
results
cURL
curl --request GET \
  --url https://api.surnex.io/v1/geo/snapshots/{id}/results \
  --header 'Authorization: Bearer <token>'
{
  "snapshot_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "complete",
  "scope": {
    "platform": "google",
    "location_code": 2840,
    "language_code": "en"
  },
  "results": {
    "aggregated_metrics": {
      "metrics": [
        {
          "target": {
            "type": "domain",
            "value": "surnex.com"
          },
          "mentions": 42,
          "ai_search_volume": 1234,
          "impressions": 987
        }
      ]
    },
    "top_domains": [
      {
        "domain": "example.com",
        "mentions": 12
      }
    ],
    "top_pages": [
      {
        "url": "https://example.com/page",
        "mentions": 5
      }
    ],
    "evidence_rows": [
      {
        "source_url": "https://example.com/page",
        "source_domain": "example.com",
        "mentions": 1,
        "title": "Example title",
        "snippet": "Example snippet"
      }
    ]
  },
  "provenance": {
    "provider": "dataforseo",
    "calls": [
      {
        "operation": "llm_mentions_aggregated_metrics_live",
        "http_status": 200,
        "latency_ms": 180
      },
      {
        "operation": "llm_mentions_top_domains_live",
        "http_status": 200,
        "latency_ms": 150
      }
    ]
  },
  "expected_parts": [
    "aggregated_metrics",
    "top_domains"
  ],
  "available_parts": [
    "aggregated_metrics",
    "top_domains",
    "top_pages"
  ]
}

Authorizations

Authorization
string
header
required

Authorization: Bearer sk_...

Path Parameters

id
string<uuid>
required

Response

Snapshot result bundle

GeoSnapshotResultsResponse

snapshot_id
string<uuid>
required
status
enum<string>
required
Available options:
queued,
running,
complete,
partial,
failed
scope
object
required
provenance
object
required
results
object
expected_parts
enum<string>[]

GeoSnapshotPartType

Available options:
aggregated_metrics,
top_domains,
top_pages,
search
available_parts
enum<string>[]

GeoSnapshotPartType

Available options:
aggregated_metrics,
top_domains,
top_pages,
search