aeo.mentions

Providers

Provider	Status
DataForSEO	live

Billing

Unit: per_search · unmatched results billed: yes
Priced per search: $0.175 plus $0.00175 a row, $0.1925 at the default 10 rows, $0.2625 at 50. Each row is a full AI answer with its sources. A search that finds no recorded answer is still a search: the index is queried and billed either way, so a no_match settles at the base $0.175 and is a finding (nothing cites the target yet), not a released miss. If the provider's actual cost overruns the estimate, the run bills the overrun at the same per-call rate, capped by the hold.

The exact quote is returned by /v1/inspect before every call and held with headroom on execution. The quote is the price floor: if the provider's actual cost overruns it, the run bills the overrun at the same rate, never above the hold. The unused part of every hold is released.

Run it

curl https://api.routergrowth.com/v1/run \
  -H "Authorization: Bearer $ROUTERGROWTH_API_KEY" \
  -d '{
    "capability": "aeo.mentions",
    "input": {  },
    "routing": {"provider": "auto"}
  }'

Input schema

{
  "properties": {
    "domain": {
      "description": "Find answers that cite or name this domain",
      "type": "string"
    },
    "keyword": {
      "description": "Find answers containing this phrase (word match). One target per search: ignored when domain is given",
      "type": "string"
    },
    "language": {
      "type": "string"
    },
    "limit": {
      "default": 10,
      "type": "integer"
    },
    "location": {
      "description": "City and country (\"Lisbon, Portugal\"), a country (\"France\") or a DataForSEO location code; default United States",
      "type": "string"
    },
    "platform": {
      "default": "google",
      "description": "chatgpt is held for United States / English only: leave location and language out",
      "enum": [
        "google",
        "chatgpt"
      ],
      "type": "string"
    }
  },
  "type": "object"
}

Normalized output fields

target · platform · total · mentions