List answers

GET/v1/answers

Every AI answer collected for a brand, newest first, with the brands it mentions (in order) and the sources it cites.

Read-onlyAll plans

Query parameters

brand_idstringoptionalThe brand to read. Optional when your key covers one brand; required for agency keys and when trying the API signed in.

prompt_idstringoptionalOnly answers to this prompt.

engineenumoptionalOnly answers from this engine.chatgptperplexitygeminigoogle_ai_overviewsclaudedeepseekmeta_ai

start_datedateoptionalFirst day, YYYY-MM-DD. Default: 30 days ago.

end_datedateoptionalLast day, inclusive. Default: today. At most 365 days after start_date.

limitintegeroptionalHow many items to return, 1 to 100. Default 20.

cursorstringoptionalThe next_cursor from the previous page.

A list of answer objects.

objectstringAlways list.

dataarray of objectsThe items.

idstringAnswer id, ans_….

prompt_idstringThe prompt it answers.

enginestringEngine id.

createddatetimeWhen it was collected.

textstringThe answer, as Markdown.

mentionsarray of objectsBrands in the answer.

brandstringBrand name.

is_youbooleanWhether it’s your brand.

positioninteger1 = named first.

sentimentstringpositive, neutral or negative.

citationsarray of objectsSources cited.

urlstringCited page.

domainstringIts domain.

typestringowned, competitor, review, earned or ugc.

has_morebooleanWhether there is another page.

next_cursorstring or nullPass as cursor to get the next page.

400invalid_requestA filter is malformed.

401unauthorizedMissing or revoked API key.

404not_foundNo brand with that id that this key can read.

429rate_limitedToo many requests; see Retry-After.