list-brand-mentionsfreeStored Metrics & ReportingGet Brand Mentions Tool
List brand mentions discovered for a tracked site. Defaults to actionable rows (kept + restored). Filter by source, triage_state, sentiment, or filter_state. Pair with triage-brand-mention / override-brand-mention-sentiment for triage workflows.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| site_id | integer | required | The tracked site to read mentions for. |
| source | string | optional | Filter by source. One of: 'x', 'reddit', 'hn', 'bluesky', 'threads'. |
| triage_state | string | optional | Filter by triage state. One of: 'pending', 'handled', 'ignored', 'snoozed'. |
| sentiment | string | optional | Filter by sentiment. One of: 'positive', 'neutral', 'negative'. |
| filter_state | string | optional | Filter by spam-filter state. One of: 'kept', 'auto_filtered', 'borderline', 'restored'. Default excludes auto_filtered + borderline. |
| limit | integer | optional | Max rows. Default 50, max 200. |
| offset | integer | optional | Pagination offset. Default 0. |
Plan access
Available on the free tier and above. Live tools draw from your team's monthly credit budget at parity with upstream API cost (1 credit ≈ $0.001).
See plans