Skip to content

Social listening API for Reddit and X

A social listening API lets your own code do the job of a listening dashboard: search Reddit and X for mentions of a brand, a competitor or a topic, and get the posts back as JSON. One key reads both platforms, so you can build whatever report, alert or dashboard you want.

Search mentions now, no signupThen schedule it with the API.
Social listening api: a harbour lookout with a spyglass listening at a row of small boats.

The job

Dashboards bundle listening, charts and a fixed workflow. An API gives you the data and leaves the rest to you, so you write your own alert rules and scoring and decide where results go. That matters when a listening tool doesn't fit how your team works.

The combined search and mentions endpoints read Reddit and X in one call. A scheduled job can run them, compare against the last seen id and send only new matches to Slack, a sheet or your CRM. See social listening APIs for how the options differ, or the Reddit listening tool page if Reddit is all you need.

For SaaS teams, the queries worth running are your product name, competitor names and the phrases customers use to describe the problem. Agencies repeat the same job for each client: one search definition per client, run on a schedule, with results tagged by client.

How it works

  1. Define the terms

    List the brand, product and competitor names and the phrases people use for the problem. Add the words to exclude.

  2. Search both platforms

    Call everywhere.mentions for brand mentions or everywhere.search for topics. Each result says which platform it came from.

  3. Alert on what is new

    Store the newest id per query. On each run, send only newer items to whichever channel you use.

Endpoints that do it

EndpointWhat it's forCredits
Find brand mentionsGET /v1/mentionsMentions of a brand across Reddit and X.up to 6 credits
Search Reddit and XGET /v1/searchPosts on a topic across both platforms.up to 4 credits
Search commentsGET /v1/reddit/comments/searchComments on Reddit that mention a term.2 credits
List mentionsGET /v1/x/users/{handle}/mentionsPosts that mention an X account.2 credits

Free tools for the same job

Try the job in a browser first. These tools call the same endpoints, and you don't need a key or any code.

Mentions across Reddit and X

A mentions call. Each row names its platform, author, time and engagement.

curl "https://api.chatterapi.com/v1/mentions?q=crm&time=month&strict=false" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"
response, first 2 rows
{
  "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 log…",
      "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 …",
      "author": "HesomParhizkar",
      "authorUrl": "https://x.com/HesomParhizkar",
      "community": null,
      "score": 2,
      "createdAt": "2026-09-14T13:47:48.000Z"
    }
  ],
  "page": {
    "nextCursor": null,
    "hasMore": false
  }
}

Recorded from a live call on . Long text is shortened and the cursor is cut. A live key is charged up to 6 credits for this call. A test key returns this same sample for 0 credits.

What it won't do

  • It covers Reddit and X only, not other social platforms.
  • Sentiment scoring isn't built in. You get the posts and can score them yourself.
  • This works by polling. There's no push webhook yet, so run it on a schedule.
  • Removed posts and protected X accounts are not returned.

Questions

What is a social listening API?
It returns public posts that mention your terms as JSON, so your code can monitor a brand, competitor or topic without a dashboard.
Does it work for agencies with several clients?
Yes. Run one saved query per client on a schedule and tag the results by client.
Is it a good fit for a SaaS startup?
It suits teams that want mentions and buyer questions sent to their own tools. See Reddit lead generation.
Which platforms does it cover?
Reddit and X. The alternatives pages compare tools that cover more.

More ways to use the API

Build it with one API key

Try it free for 7 days with 1,000 credits.