AI visibility - tracked queries
AI visibility tracks whether a domain is cited in AI-generated answers across five engines: Google AI Overviews, Perplexity, Gemini, ChatGPT and Claude. This endpoint lists the prompts (queries) tracked for a project, each with the latest result per engine.
GET
/ai-visibility/queriesQuery parameters
| Parameter | Type | Description |
|---|---|---|
project_idrequired | string | The project whose tracked queries to return. |
page | integer | Page number. Defaults to `1`. |
per_page | integer | Items per page (max 100). Defaults to `50`. |
Example request
cURL
curl "https://api.oneclickseo.ai/v1/ai-visibility/queries?project_id=prj_91a2" \
-H "Authorization: Bearer YOUR_API_KEY"Response
200Tracked queries
Response
{
"data": [
{
"id": "aiq_2f7b",
"query": "best project management software",
"country": "us",
"engines": ["google_ai", "perplexity", "chatgpt"],
"pinned_url": "mysite.com",
"is_active": true,
"last_checked_at": "2026-06-15T05:00:00Z",
"latest": [
{ "engine": "perplexity", "mentioned": true, "mention_position": 2, "total_sources": 8 },
{ "engine": "chatgpt", "mentioned": false, "mention_position": null, "total_sources": 6 }
]
}
],
"meta": { "page": 1, "per_page": 50, "total": 18, "total_pages": 1 }
}Query fields
| Parameter | Type | Description |
|---|---|---|
query | string | The tracked prompt. |
engines | string[] | Engines checked: `google_ai`, `perplexity`, `gemini`, `chatgpt`, `claude`. |
pinned_url | string | The domain you are tracking visibility for. |
latest | object[] | Most recent result per engine - see Snapshots for the full shape. |
Related