Compare LLM mentions across labeled groups

Aggregate and compare LLM mention metrics across several labeled target groups for side-by-side share-of-voice analysis.

Pricing — $$$ · min $0.50

Minimum 500 credits ($0.50) per call. Records returned above the minimum bill 1 credit ($0.001) each.

Authorization

bearerAuth

AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

groups*array<>

Labeled target groups to compare against each other.

Items1 <= items <= 10

engine?string

Value in"chatgpt" | "google"

location?|

Search location as a country code/name, DataForSEO location code, full location name, or latitude,longitude,radius coordinate string. Defaults to us.

language?string

Search language as an ISO code or full language name. Defaults to en.

Length2 <= length <= 80

filters?||

Filter the raw mentions dataset before it is aggregated. Provide a single condition {"field","op","value"} or an {"and":[…]} / {"or":[…]} group of conditions (nest groups for mixed logic), up to 8 conditions. Operators: =, <>, <, <=, >, >=, in, not_in, like, not_like, ilike, not_ilike, match, not_match (use an array value with in / not_in). Filterable fields: ai_search_volume (monthly AI search volume); mentions (number of mentions); platform (LLM engine, e.g. chat_gpt, google); location (location name); language (language name); sources_domain (cited source domain); search_results_domain (domain in the engine's search results); brand_entities_title (brand entity title); brand_entities_category (brand entity category). Example: {"field":"ai_search_volume","op":">","value":1000}

internal_list_limit?integer

Max elements per internal grouped array. Default 5.

Range1 <= value <= 10

Response Body

`application/json`

curl -X POST "https://example.com/geo/mentions/cross-aggregated-metrics" \  -H "Content-Type: application/json" \  -d '{    "groups": [      {        "label": "string",        "target": [          {}        ]      }    ]  }'

{
  "request_id": "string",
  "data": {
    "engine": "chatgpt",
    "location": "string",
    "language": "string",
    "totals": {
      "by_platform": [
        {
          "value": "string",
          "type": "string",
          "mentions": 0,
          "ai_search_volume": 0
        }
      ],
      "by_location": [
        {
          "value": "string",
          "type": "string",
          "mentions": 0,
          "ai_search_volume": 0
        }
      ],
      "by_language": [
        {
          "value": "string",
          "type": "string",
          "mentions": 0,
          "ai_search_volume": 0
        }
      ],
      "by_source_domain": [
        {
          "value": "string",
          "type": "string",
          "mentions": 0,
          "ai_search_volume": 0
        }
      ],
      "by_search_results_domain": [
        {
          "value": "string",
          "type": "string",
          "mentions": 0,
          "ai_search_volume": 0
        }
      ],
      "by_brand_entity_title": [
        {
          "value": "string",
          "type": "string",
          "mentions": 0,
          "ai_search_volume": 0
        }
      ],
      "by_brand_entity_category": [
        {
          "value": "string",
          "type": "string",
          "mentions": 0,
          "ai_search_volume": 0
        }
      ]
    },
    "results": [
      {
        "key": "string",
        "mentions": 0,
        "breakdown": {
          "by_platform": [
            {
              "value": "string",
              "type": "string",
              "mentions": 0,
              "ai_search_volume": 0
            }
          ],
          "by_location": [
            {
              "value": "string",
              "type": "string",
              "mentions": 0,
              "ai_search_volume": 0
            }
          ],
          "by_language": [
            {
              "value": "string",
              "type": "string",
              "mentions": 0,
              "ai_search_volume": 0
            }
          ],
          "by_source_domain": [
            {
              "value": "string",
              "type": "string",
              "mentions": 0,
              "ai_search_volume": 0
            }
          ],
          "by_search_results_domain": [
            {
              "value": "string",
              "type": "string",
              "mentions": 0,
              "ai_search_volume": 0
            }
          ],
          "by_brand_entity_title": [
            {
              "value": "string",
              "type": "string",
              "mentions": 0,
              "ai_search_volume": 0
            }
          ],
          "by_brand_entity_category": [
            {
              "value": "string",
              "type": "string",
              "mentions": 0,
              "ai_search_volume": 0
            }
          ]
        }
      }
    ]
  },
  "billing": {
    "credits_charged": 0,
    "records_charged": 0,
    "balance_remaining": 0,
    "truncated_due_to_balance": true
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

Compare LLM mentions across labeled groups

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

402application/json

404application/json

429application/json

500application/json

502application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`