Skip to content

Twitter hashtag API: search tweets by hashtag

Put a hashtag in the search query and you get matching tweets back as JSON, with text, author, time and engagement counts. You can filter by date, language and sort order, and page through the results with a cursor. There is no separate hashtag count endpoint, so you count the rows you collect yourself.

Search a hashtag now, no signupThen run the same query from code.
Twitter hashtag API: cards sharing one tag are lifted from a catalogue drawer.

The job

A hashtag is just a search term to X, so to get tweets by hashtag you call the tweet search endpoint with #yourtag in q. You get the same fields as any search: text, link, author, public counts and media.

Use sort=latest to follow a tag as it moves, or sort=top to see the most engaged posts that used it. You can combine the tag with X operators, for example #ai min_faves:50 lang:en, to cut noise before you pay for the page.

For a hashtag count, collect the pages for the period you care about and count the rows in your own code, grouped by day. The count only covers the pages you pulled. This works on X only. Reddit has no hashtags, so use the Reddit search endpoint for topics there.

How it works

  1. Write the query

    URL-encode the tag, so #buildinpublic becomes %23buildinpublic. Add operators such as lang:en or -filter:replies to narrow it.

  2. Call tweet search

    GET /v1/x/tweets/search with q, a sort of latest or top, and optional since and until dates (YYYY-MM-DD).

  3. Page through results

    Pass page.nextCursor back as cursor until page.hasMore is false or you have as many tweets as you want.

  4. Count or analyse in your code

    Group the rows by date, author or text to get counts, top authors or co-occurring tags. The API returns the tweets and you do the maths.

Endpoints that do it

EndpointWhat it's forCredits
Search tweetsGET /v1/x/tweets/searchTweets that match a hashtag query, with operators, dates and sort order.2 credits
Get a tweetGET /v1/x/tweets/{id}One tweet in full when a search row needs a closer look.2 credits
List repliesGET /v1/x/tweets/{id}/repliesThe replies under a tweet that used the tag.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.

A tweet search

The same call takes #hashtag as the query. The response below was recorded from a real search.

curl "https://api.chatterapi.com/v1/x/tweets/search?q=%22crm+recommendation%22" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"
response, first 2 rows
{
  "data": [
    {
      "id": "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 …",
      "url": "https://x.com/HesomParhizkar/status/2099495333231288346",
      "createdAt": "2026-09-14T13:47:48.000Z",
      "lang": "en",
      "likes": 2,
      "retweets": 0,
      "replies": 2,
      "quotes": 0,
      "views": 138,
      "bookmarks": 0,
      "isReply": false,
      "inReplyToId": null,
      "conversationId": "2099495333231288346",
      "isRetweet": false,
      "quotedTweetId": null,
      "type": "tweet",
      "isQuote": false,
      "isPinned": false,
      "source": null,
      "hasVideo": false,
      "urls": [],
      "mentions": [],
      "author": {
        "id": "35363135",
        "handle": "HesomParhizkar",
        "name": "Hesom",
        "bio": "Startup Founder/Executive, investor, nba fan",
        "followers": 584,
        "following": 2010,
        "tweets": null,
        "verified": false,
        "blueVerified": true,
        "canDm": true,
        "protected": null,
        "location": "Marietta, GA",
        "url": null,
        "avatarUrl": "https://pbs.twimg.com/profile_images/1871033188081942528/comvGkRg_normal.jpg",
        "createdAt": "2009-04-26T01:18:19.000Z",
        "profileUrl": "https://x.com/HesomParhizkar",
        "bannerUrl": "https://pbs.twimg.com/profile_banners/35363135/1787179410",
        "likesGiven": null,
        "mediaCount": null,
        "pinnedTweetIds": null
      },
      "media": [],
      "quotedTweet": null,
      "retweetedTweet": null
    },
    {
      "id": "2040879100261458222",
      "text": "Here's a live audit on what happens when buyers ask AI for a CRM recommendation. You can't miss it...",
      "url": "https://x.com/apoorvshrm/status/2040879100261458222",
      "createdAt": "2026-04-05T19:47:49.000Z",
      "lang": "en",
      "likes": 4,
      "retweets": 0,
      "replies": 1,
      "quotes": 0,
      "views": 145,
      "bookmarks": 0,
      "isReply": false,
      "inReplyToId": null,
      "conversationId": "2040879100261458222",
      "isRetweet": false,
      "quotedTweetId": "2040878095415304308",
      "type": "quote",
      "isQuote": true,
      "isPinned": false,
      "source": null,
      "hasVideo": false,
      "urls": [],
      "mentions": [],
      "author": {
        "id": "1459048370371137542",
        "handle": "apoorvshrm",
        "name": "Apoorv Sharma | SEO and GEO for B2B SaaS",
        "bio": "SEO + GEO for B2B SaaS. I help SaaS brands rank on Google and get recommended by Claude, Gemini, and Google AI.\nCo-Founder, DerivateX",
        "followers": 2316,
        "following": 519,
        "tweets": null,
        "verified": false,
        "blueVerified": true,
        "canDm": true,
        "protected": null,
        "location": "Bengaluru",
        "url": null,
        "avatarUrl": "https://pbs.twimg.com/profile_images/2069124654112149504/AWTErF4d_normal.jpg",
        "createdAt": "2021-11-12T06:40:23.000Z",
        "profileUrl": "https://x.com/apoorvshrm",
        "bannerUrl": "https://pbs.twimg.com/profile_banners/1459048370371137542/1770951885",
        "likesGiven": null,
        "mediaCount": null,
        "pinnedTweetIds": null
      },
      "media": [],
      "quotedTweet": {
        "id": "2040878095415304308",
        "text": "I just ran a live AI visibility audit on HubSpot.\n\nTyped the same prompt into ChatGPT, Perplexity, and Gemini.\n\nThe results were... WILD.\n\nHere's what I found 🧵",
        "url": "https://x.com/apoorvshrm/status/2040878095415304308",
        "createdAt": null,
        "lang": null,
        "likes": null,
        "retweets": null,
        "replies": null,
        "quotes": null,
        "views": null,
        "bookmarks": null,
        "isReply": false,
        "inReplyToId": null,
        "conversationId": null,
        "isRetweet": false,
        "quotedTweetId": null,
        "type": "tweet",
        "isQuote": false,
        "isPinned": false,
        "source": null,
        "hasVideo": false,
        "urls": [],
        "mentions": [],
        "author": {
          "id": "",
          "handle": "apoorvshrm",
          "name": "Apoorv Sharma | SEO and GEO for B2B SaaS",
          "bio": null,
          "followers": null,
          "following": null,
          "tweets": null,
          "verified": null,
          "blueVerified": null,
          "canDm": null,
          "protected": null,
          "location": null,
          "url": null,
          "avatarUrl": null,
          "createdAt": null,
          "profileUrl": "https://x.com/apoorvshrm",
          "bannerUrl": null,
          "likesGiven": null,
          "mediaCount": null,
          "pinnedTweetIds": null
        },
        "media": []
      },
      "retweetedTweet": null
    }
  ],
  "page": {
    "nextCursor": "ATcD…",
    "hasMore": true
  }
}

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

What it won't do

  • X only. Reddit has no hashtags.
  • No hashtag count or trend endpoint. Counts come from the rows you collect, and they are only as complete as your paging.
  • Public tweets only. Deleted posts and protected accounts are not returned.
  • Each call returns one page of about 20 tweets, and results are what X search returns at call time.
  • It does not push new tweets as they appear, so poll on a schedule.

Questions

How do I get tweets by hashtag with an API?
Call the tweet search endpoint with the hashtag in q, for example q=%23buildinpublic, and read the data array in the response.
Is there a Twitter API hashtag count?
No. Collect the tweets for the period you want and count them in your own code. The number only covers the pages you fetched.
Can I scrape a Twitter hashtag without code?
Yes. The free X tweet search tool runs a hashtag search in the browser with no signup.
Can I filter hashtag results by date or language?
Yes. Use since and until for dates and add lang:en or similar operators to the query.
Can I search several hashtags at once?
Yes. Join them with OR, for example #seo OR #geo. Each page is billed once.

More ways to use the API

Build it with one API key

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