All tools
list-filtered-brand-mentionsfreeStored Metrics & Reporting

List Filtered Brand Mentions Tool

List brand mentions that the spam/bot filter pipeline rejected (auto_filtered + borderline) for a tracked site. Returns the rows plus a reason_summary aggregate so the agent can suggest bulk-restore patterns. Pair with restore-filtered-brand-mention to flip a row back to kept.

Parameters

NameTypeRequiredDescription
site_idintegerrequiredThe tracked site.
reasonstringoptionalOptional substring match against `filter_reason` (e.g. "crypto", "Layer 2").
limitintegeroptionalMax rows. Default 50, max 200.
offsetintegeroptionalPagination offset.

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