All tools
list-competitor-mentionsfreeStored Metrics & Reporting

List Competitor Mentions Tool

List competitor-intel mentions grouped by configured competitor. Includes matching LLM citation competitor rows when metadata.cited_brand matches a configured competitor.

Parameters

NameTypeRequiredDescription
site_idintegeroptionalOptional tracked site id. Omit to list across the team.
competitorstringoptionalOptional competitor name, alias, handle, or domain.
sentimentstringoptionalOptional sentiment bucket: 'negative', 'neutral', or 'positive'.
sourcestringoptionalOptional BrandMentionSource value such as x, reddit, news, or llm_citation.
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