> ## Documentation Index
> Fetch the complete documentation index at: https://docs.surnex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get v1geosnapshots results



## OpenAPI

````yaml https://api.surnex.io/.well-known/openapi.json get /v1/geo/snapshots/{id}/results
openapi: 3.1.0
info:
  title: Surnex API
  version: 0.2.0
servers:
  - url: https://api.surnex.io
security: []
paths:
  /v1/geo/snapshots/{id}/results:
    get:
      tags:
        - v1
      parameters:
        - schema:
            type: string
            format: uuid
          required: true
          name: id
          in: path
      responses:
        '200':
          description: Snapshot result bundle
          content:
            application/json:
              schema:
                type: object
                properties:
                  snapshot_id:
                    type: string
                    format: uuid
                  status:
                    type: string
                    enum:
                      - queued
                      - running
                      - complete
                      - partial
                      - failed
                  scope:
                    type: object
                    properties:
                      platform:
                        type:
                          - string
                          - 'null'
                        enum:
                          - google
                          - chat_gpt
                        description: GeoSnapshotScopePlatform
                      location_code:
                        type:
                          - integer
                          - 'null'
                        description: GeoSnapshotScopeLocationCode
                      language_code:
                        type:
                          - string
                          - 'null'
                        description: GeoSnapshotScopeLanguageCode
                    required:
                      - platform
                      - location_code
                      - language_code
                  results:
                    type: object
                    properties:
                      aggregated_metrics:
                        type: object
                        properties:
                          metrics:
                            type: array
                            items:
                              type: object
                              properties:
                                target:
                                  type: object
                                  properties:
                                    type:
                                      type: string
                                      enum:
                                        - domain
                                        - keyword
                                    value:
                                      type: string
                                  required:
                                    - type
                                    - value
                                mentions:
                                  type:
                                    - number
                                    - 'null'
                                ai_search_volume:
                                  type:
                                    - number
                                    - 'null'
                                impressions:
                                  type:
                                    - number
                                    - 'null'
                              required:
                                - target
                                - mentions
                                - ai_search_volume
                                - impressions
                        required:
                          - metrics
                      top_domains:
                        type: array
                        items:
                          type: object
                          properties:
                            domain:
                              type: string
                            mentions:
                              type:
                                - number
                                - 'null'
                          required:
                            - domain
                            - mentions
                      top_pages:
                        type: array
                        items:
                          type: object
                          properties:
                            url:
                              type: string
                            mentions:
                              type:
                                - number
                                - 'null'
                          required:
                            - url
                            - mentions
                      evidence_rows:
                        type: array
                        items:
                          type: object
                          properties:
                            source_url:
                              type:
                                - string
                                - 'null'
                            source_domain:
                              type:
                                - string
                                - 'null'
                            mentions:
                              type:
                                - number
                                - 'null'
                            title:
                              type:
                                - string
                                - 'null'
                            snippet:
                              type:
                                - string
                                - 'null'
                    default: {}
                  expected_parts:
                    type: array
                    items:
                      type: string
                      enum:
                        - aggregated_metrics
                        - top_domains
                        - top_pages
                        - search
                      description: GeoSnapshotPartType
                    default: []
                  available_parts:
                    type: array
                    items:
                      type: string
                      enum:
                        - aggregated_metrics
                        - top_domains
                        - top_pages
                        - search
                      description: GeoSnapshotPartType
                    default: []
                  provenance:
                    type: object
                    properties:
                      provider:
                        type: string
                      calls:
                        type: array
                        items:
                          type: object
                          properties:
                            operation:
                              type: string
                            http_status:
                              type:
                                - number
                                - 'null'
                            latency_ms:
                              type:
                                - number
                                - 'null'
                          required:
                            - operation
                            - http_status
                            - latency_ms
                    required:
                      - provider
                      - calls
                required:
                  - snapshot_id
                  - status
                  - scope
                  - provenance
                description: GeoSnapshotResultsResponse
              examples:
                complete:
                  value:
                    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
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
                      details:
                        type: object
                        properties: {}
                        default: {}
                        additionalProperties: {}
                    required:
                      - code
                      - message
                      - request_id
                required:
                  - error
                description: ErrorResponse
              examples:
                unauthorized:
                  value:
                    error:
                      code: UNAUTHORIZED
                      message: Unauthorized
                      request_id: req_123
                      details:
                        reason: missing_or_invalid_api_key
        '404':
          description: Snapshot not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
                      details:
                        type: object
                        properties: {}
                        default: {}
                        additionalProperties: {}
                    required:
                      - code
                      - message
                      - request_id
                required:
                  - error
                description: ErrorResponse
              examples:
                notFound:
                  value:
                    error:
                      code: NOT_FOUND
                      message: Snapshot not found
                      request_id: req_123
                      details: {}
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'Authorization: Bearer sk_...'
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````