AI visibility - snapshots

Returns the AI-visibility history for a tracked query - one snapshot per engine per check. Each snapshot records whether your domain was mentioned, where it appeared in the cited sources, and the full AI answer text. Use it to chart AI-visibility trends.

GET/ai-visibility/queries/{query_id}/snapshots

Query parameters

Parameter	Type	Description
`engine`	string	Filter to one engine: `google_ai`, `perplexity`, `gemini`, `chatgpt` or `claude`.
`date_from`	string	Start date (YYYY-MM-DD), inclusive.
`date_to`	string	End date (YYYY-MM-DD), inclusive.
`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/aiq_2f7b/snapshots?engine=perplexity" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

200AI-visibility snapshots

Response

{
  "data": [
    {
      "engine": "perplexity",
      "checked_at": "2026-06-15T05:00:00Z",
      "mentioned": true,
      "mention_position": 2,
      "mention_text": "...according to mysite.com, the best option is...",
      "total_sources": 8,
      "all_sources": ["mysite.com", "competitor.com", "wikipedia.org"],
      "ai_answer_text": "The best project management software depends on..."
    }
  ],
  "meta": { "page": 1, "per_page": 50, "total": 30, "total_pages": 1 }
}

Snapshot fields

Parameter	Type	Description
`engine`	string	The AI engine checked.
`checked_at`	string	ISO-8601 timestamp of the check.
`mentioned`	boolean	Whether the tracked domain was cited in the answer.
`mention_position`	integer	Order of the domain in the cited sources, or `null` if not mentioned.
`mention_text`	string	The surrounding text where the domain was cited.
`total_sources`	integer	Number of sources cited in the AI answer.
`all_sources`	string[]	All domains cited in the answer.
`ai_answer_text`	string	The full AI-generated answer.

Tracked queries