geo

Aggregate LLM mention metrics by dimension

Aggregate LLM mentions of a domain or keyword across platform, location, language, source/search-result domains, and brand entities.

post/geo/mentions/aggregated-metrics

Request

  • Base URL: https://api.unifapi.com
  • URL: https://api.unifapi.com/geo/mentions/aggregated-metrics
  • Auth: HTTP bearer

Headers

X-Unifapi-Max-Creditsstring

Optional maximum credit budget for this request. The gateway validates the required reservation before collection and rejects a lower cap without charging. Unused reserved credits are released after settlement. Omit to use your available balance.

Unifapi-Version'2026-07-01'

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Idempotency-Keystring

Client-supplied unique key that makes a write request safe to retry. If a request with the same key was already processed, the original response is replayed (with Idempotency-Replayed: true) instead of executing — and billing — again. Send a fresh UUID per logical operation. Best-effort with a 24h window.

Request body

engine'chatgpt' | 'google'

AI platform to query. google covers Google AI Overviews; chatgpt covers ChatGPT (United States + English only). Defaults to google.

languagestring

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

internal_list_limitinteger

Max elements per internal grouped array (source/search-result domains). Default 10.

Response

OK

request_idstring required

UnifAPI request id for support and ledger correlation.

Changes

No recorded changes to this operation across all 1 revision of this API.