Prompts
List a prompt's answers
List the AI answers a prompt got over a window, newest first, with the brands they named and the sources they cited.
/v1/brands/{brand_id}/prompts/{prompt_id}/answersThe answers a window counts for this prompt, newest first: those from its completed runs, or the latest run before it when it held none. Failed and filled-in answers are left out, as in the reports, so the answers of every prompt add up to the answer_count of /visibility over the same window and engines.
Authorization
AuthorizationstringheaderrequiredYour API key as Bearer ranqo_sk_…. The account owner creates keys in Settings, under API keys. See Authentication.
Path parameters
brand_idstringrequiredThe brand id, from GET /v1/brands.
prompt_idstringrequiredThe prompt id, from GET /v1/brands/{brand_id}/prompts.
Query parameters
Every parameter is optional. A parameter the endpoint does not take is refused with unknown_parameter.
periodstring7d, 30d and 90d run from midnight in tz that many days back to now; 365d runs from midnight 365 days back to the end of today. Default 30d. Not with start_date.
Options:7d30d90d365d
start_datestringFirst day of a custom window, in tz. Send with end_date.
end_datestringLast day of a custom window, in tz, included. The window may span at most 366 days, both dates counted.
tzstringIANA time zone for day boundaries, such as Asia/Kolkata. Default UTC.
platformsstringEngines to list: claude, chatgpt, perplexity, gemini, grok, google_aio.
limitintegerdefault: 20Items per page, 1 to 50.
Range: 1 ≤ x ≤ 50
cursorstringThe next_cursor of the previous page.
curl "https://api.ranqo.ai/v1/brands/BRAND_ID/prompts/PROMPT_ID/answers" \
-H "Authorization: Bearer $RANQO_API_KEY"Sample data from an invented brand. Try it shows your own.
Response
The response body, as JSON.
windowobjectThe answers a report counts: those from completed runs inside the window.
Show 6 fields insideHide the fields inside
startstringRFC 3339 timestamp in UTC.
endstringRFC 3339 timestamp in UTC.
previous_startstringThe comparison window runs from here to
start: the whole days beforestartfor7d,30dand90d, the same length as the window otherwise.time_zonestringperiodstring or nullThe preset, or null for a custom window. One of
7d,30d,90d,365d.carried_fromstring or nullRFC 3339 timestamp in UTC. Set when the window held no completed run: the figures are the latest run before it, which completed at this time, and nothing is compared.
dataarray of objectsShow 12 fields insideHide the fields inside
idstringprompt_idstringrun_idstringplatformstringcreated_atstringRFC 3339 timestamp in UTC.
textstringThe answer as the engine returned it.
text_markdownstring or nullThe answer reformatted as markdown, when it was.
brand_namedbooleanpositioninteger or nullWhere the brand was named, 1 = first; null when not named.
sentimentstring or nullHow the answer spoke of the brand; null when not named. One of
positive,neutral,negative,mixed.competitorsarray of objectsShow 4 fields insideHide the fields inside
namestringpositioninteger or nullsentimentstring or nullOne of
positive,neutral,negative,mixed.domainstring or nullNull when no domain could be confirmed; never guessed.
sourcesarray of objectsShow 3 fields insideHide the fields inside
urlstringdomainstringtitlestring or null
has_morebooleanWhether another page follows.
next_cursorstring or nullPass as
cursorfor the next page; null on the last page.
Response headers
X-Request-IdThe request id; quote it to support.
RateLimitRequests left in this window and seconds until it resets.
RateLimit-PolicyThe key's limit per window.
Errors
Errors are problem details (application/problem+json) with a stable code. See Errors for each one.