ai_visibility
Query ChatGPT's public signed-out search interface with the supplied question.
Query ChatGPT's public signed-out search interface with the supplied question. Returns answer markdown, sources, mentioned brands and search sub-queries. Does not store the answer.
| Field | Value |
|---|---|
| Pack | SEO & AI visibility (seo) |
| Estimated cost per call | ~$0.004 (upstream cost; see the description for per-action figures) |
| Monthly pack limit | $3 of upstream cost (not shown to users) |
| Project | optional (project or X-OpenNomos-Project); only attaches the project id to the result |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
project | no | string | Project slug or id. Omit to use the credential or workspace default. |
question | yes | string | The question to ask ChatGPT, e.g. 'best open source CRM for startups'. |
location_code | no | integer (≥ 1) | string | Where to search from: a country name (e.g. "United States", "China", "Hong Kong", "Japan"), a 2-letter country code ("US", "CN"), or a numeric DataForSEO location code (e.g. 2840). Default United States. |
language_code | no | string | Language code, e.g. 'en', 'de', 'ja'. Default 'en'. |
Example call
{
"question": "best open source CRM for startups",
"location_code": "US",
"language_code": "en"
}REST: POST https://service.opennomos.com/v1/tools/ai_visibility with that JSON as the body. MCP: tools/call with name: "ai_visibility" and that JSON as arguments.
Example result
Values are illustrative; the shape comes from the service code.
{
"answer": "Several open source CRMs are popular with startups: …",
"sources": [
{
"url": "https://example.com/best-crms",
"domain": "example.com",
"title": "Best open source CRMs"
}
],
"brands": [
"Twenty",
"SuiteCRM"
],
"fan_out_queries": [
"open source crm for startups",
"self hosted crm"
]
}Notes
- Queries ChatGPT's public signed-out search interface with the question you give, and returns one answer. It is a single sample, not a ranking: ask a few phrasings before you conclude your brand is absent.
- Nothing is stored. If the provider returns no answer the result is
{ "answer": null }.
Errors
Upstream trouble is reported inside a normal result as error, reason and action (and tool / retry_after_seconds when they apply). For search_signals this appears per source. See Errors.
This tool is in the SEO & AI visibility pack. If the pack is not enabled the call fails with pack_required (HTTP 403); if the pack's monthly upstream cost limit is used up it fails with soft_limit (HTTP 429). Both carry action: "give_up_and_tell_user" and the console URL.