The brand-mention object

A brand mention is a single appearance of a tracked brand inside a response, recorded with its position in the answer and its sentiment score.

Fields

Field	Type	Description
id	integer	The unique ID of the brand mention.
response_id	integer	The numeric ID of the response the brand was mentioned in. You may pass this ID to the `response_id` filter on the list endpoint.
brand_id	integer	The numeric ID of the brand that was mentioned. You may pass this ID to the `brand_id` filter on the list endpoint.
position	integer	The one-indexed order in which the brand appeared in the response. A position of `1` means the brand was mentioned first.
sentiment_score	integer	The sentiment score on a 0-100 scale, where 50 is neutral, 0 is strongly negative, and 100 is strongly positive.
response	Response	The response the brand was mentioned in. Returned when requested via `include=response` or a deeper chain.
brand	Brand	The brand that was mentioned. Returned when requested via `include=brand`.
created_at	datetime	When the brand mention was recorded.
updated_at	datetime	When the brand mention was last updated.

{ "id": 91234, "response_id": 7842, "brand_id": 555, "position": 1, "sentiment_score": 72, "response": { "id": 7842, "prompt_id": 901, "monitor_id": 271, "prompt_text": "What are the best AI visibility monitoring tools?", "platform": "chatgpt", "model": "gpt-4", "country": "US", "language": "en", "content": "string", "html": "string", "excerpt": "string", "search_queries": [ "string" ], "prompt": { "id": 901, "monitor_id": 271, "prompt": "What are the best AI visibility monitoring tools?", "is_active": true, "monitor": { "id": 271, "project_id": 42, "name": "Brand visibility (US)", "platforms": [ "chatgpt", "perplexity", "claude" ], "country": "US", "language": "en", "is_active": true, "project": { "id": 42, "organization_id": 7, "name": "Acme Marketing", "brand_id": 555, "organization": { "id": 7, "name": "Acme Inc.", "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "monitor": { "id": 271, "project_id": 42, "name": "Brand visibility (US)", "platforms": [ "chatgpt", "perplexity", "claude" ], "country": "US", "language": "en", "is_active": true, "project": { "id": 42, "organization_id": 7, "name": "Acme Marketing", "brand_id": 555, "organization": { "id": 7, "name": "Acme Inc.", "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "project": { "id": 42, "organization_id": 7, "name": "Acme Marketing", "brand_id": 555, "organization": { "id": 7, "name": "Acme Inc.", "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "brand": { "id": 555, "project_id": 42, "display_name": "Acme Inc.", "aliases": [ "Acme", "Acme Co" ], "domains": [ "acme.com", "acme.co" ], "kind": "competitor", "color": "#008FFB", "ignored_at": null, "project": { "id": 42, "organization_id": 7, "name": "Acme Marketing", "brand_id": 555, "organization": { "id": 7, "name": "Acme Inc.", "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }