list_ai_visibility_answers
The raw AI answers behind the visibility rates: the text each engine gave for a prompt, its citations, and how Adlyse scored it (mentioned, recommended, position, sentiment, competitors named). Newest first.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
prompt_id | integer | no | Only answers to this prompt (from get_ai_visibility) | |
engine | string | no | perplexity, openai, gemini, claude, google_aio | |
limit | integer | no | 20 | Max answers (max 200) |
cited_url | string | no | Only answers that cite this exact URL | |
site_source_id | string | no | Site source id; omitted selects the primary site |
Returns#
json
{
"answers": [
{
"id": 501,
"prompt_id": 12,
"prompt": "best trail running shoes for ultra runners",
"category": "discovery",
"engine": "perplexity",
"model": "sonar",
"run_date": "2026-09-21",
"status": "ok",
"answer_text": "For ultra distances the usual picks are …",
"cited_urls": ["https://hoka.com/…", "https://example.com/blog/best-trail-shoes"],
"brand_mentioned": true,
"brand_recommended": false,
"mention_position": 3,
"sentiment": "neutral",
"own_domain_cited": true,
"our_cited_urls": ["https://example.com/blog/best-trail-shoes"],
"competitor_mentions": { "hoka.com": 1 },
"brands_mentioned": ["Hoka", "Example"],
"error": ""
}
],
"count": 1,
"source": "adlyse.ai_visibility@v2"
}Errors#
error_type | When |
|---|---|
auth_error | Missing / invalid API key |
site_source_id scopes this operation to a site in the current organization; omitted selects the primary site. Results are sampled API answers. Comparative rates use matched prompt/engine/model/locale cohorts, excluding failed scoring; configuration changes require a new baseline. Only implemented and configured engine adapters can run.