Find brand mentions

GET/v1/mentions

MCPeverywhere_mentionsup to 6 creditsLive

Updated Oct 14, 2026

Description

Find every recent mention of a brand or product name across Reddit posts, Reddit comments and X, merged newest first. Supports other spellings, exclusion words and your own accounts to skip. Costs 6 credits for a page from all three sources. Tip: add your own handles to excludeAuthors so you only see what others say.

Parameters

Name	In	Type	Required	Default	Description
`q`	query	string	yes		Brand or product name. 1-100 characters.
`aliases`	query	string or array	no		Up to 5 other spellings, e.g. chatterapi.io.
`exclude`	query	string or array	no		Up to 10 words that disqualify a mention.
`excludeAuthors`	query	string or array	no		Up to 20 of your own accounts to skip (Reddit usernames or X handles).
`time`	query	enum	no	`week`	How far back to look. One of: `day`, `week`, `month`.
`strict`	query	boolean,string	no		Keep only items whose text contains a term.
`cursor`	query	string	no		Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.

q query, string, required: Brand or product name. 1-100 characters.
aliases query, string or array: Up to 5 other spellings, e.g. chatterapi.io.
exclude query, string or array: Up to 10 words that disqualify a mention.
excludeAuthors query, string or array: Up to 20 of your own accounts to skip (Reddit usernames or X handles).
time query, enum: How far back to look. One of: day, week, month. Default week.
strict query, boolean,string: Keep only items whose text contains a term.
cursor query, string: Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.

Request examples

curl "https://chatterapi.com/v1/mentions?q=crm&time=month&strict=false" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"

Response

data is a list of Mention, with page.nextCursor and page.hasMore for the next page. Fields:

Field	Type	Nullable	Description
`platform`	enum	no	reddit or x.
`kind`	enum	no	post, comment or tweet.
`id`	string	no	Platform id.
`url`	string	no	Full URL on the platform.
`text`	string	no	Text.
`author`	string	yes	Author username, null when deleted.
`authorUrl`	string	yes	Author profile URL.
`community`	string	yes	Subreddit for Reddit items, null for X.
`score`	number	yes	Score (upvotes minus downvotes) as Reddit reports it.
`createdAt`	string	yes	ISO 8601 UTC timestamp.

response

{
  "data": [
    {
      "platform": "reddit",
      "kind": "post",
      "id": "t3_1whokz5",
      "url": "https://www.reddit.com/r/CRMSoftware/comments/1whokz5/best_logistics_crm_for_email_sms_and_customer/",
      "text": "Best logistics CRM for email, SMS, and customer management?\n\nI run a small delivery company in Florida with about 11 staff, and we’re currently managing around 2,400 customer and booking records.\n\nWe’re looking for a logistics CRM that can handle most of this in one place. Ideally, I’d like something that can:\n\nSend bulk emails and SMS to 2,000+ customers without the costs getting ridiculous.\n\nKeep customer, delivery and booking information organised so we can search, filter and pull up records easily.\n\nHandle email and SMS from the same system, or at least connect cleanly with another platform if we need two.\n\nGive us a simple way to track customer communication and delivery history without needing someone technical to manage it.\n\nAnd obviously, keep the monthly cost reasonable. Some of the platforms I’ve looked at seem affordable until you add SMS, extra contacts and automation.\n\nWe’ve been doing this with a mix of spreadsheets and separate messaging tools since late 2023, and it’s b…",
      "author": "L1994ala_1264",
      "authorUrl": "https://www.reddit.com/user/L1994ala_1264/",
      "community": "CRMSoftware",
      "score": 5,
      "createdAt": "2026-09-16T05:54:13.000Z"
    },
    {
      "platform": "x",
      "kind": "tweet",
      "id": "2099495333231288346",
      "url": "https://x.com/HesomParhizkar/status/2099495333231288346",
      "text": "meta ads: how important is the “connect to your crm” recommendation?\n\nthis essentially will tell meta if the lead was good or bad (ie converted), any experience how how is actually helps?\n\nthis particular client doesn’t have a crm, yeah, I can build a page for him to update, but is it worth the effort?",
      "author": "HesomParhizkar",
      "authorUrl": "https://x.com/HesomParhizkar",
      "community": null,
      "score": 2,
      "createdAt": "2026-09-14T13:47:48.000Z"
    }
  ],
  "page": {
    "nextCursor": null,
    "hasMore": false
  },
  "credits": {
    "charged": 6,
    "remaining": 24997
  },
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
  "cached": false
}

Recorded live response captured 2026-10-14, truncated to 3 items. Credits and request id are illustrative.

Credits

Up to 6 credits per call: 1 for Reddit posts, 2 for Reddit comments and 3 for X, for the sources called. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 10 minutes are served from cache.

Errors this endpoint can return

Try it

Try in the playground Free tool: Brand Mentions