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.

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
Write the query
URL-encode the tag, so
#buildinpublicbecomes%23buildinpublic. Add operators such aslang:enor-filter:repliesto narrow it.Call tweet search
GET
/v1/x/tweets/searchwithq, asortoflatestortop, and optionalsinceanduntildates (YYYY-MM-DD).Page through results
Pass
page.nextCursorback ascursoruntilpage.hasMoreis false or you have as many tweets as you want.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
| Endpoint | What it's for | Credits |
|---|---|---|
| Search tweetsGET /v1/x/tweets/search | Tweets 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}/replies | The 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"{
"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?
q, for example q=%23buildinpublic, and read the data array in the response.Is there a Twitter API hashtag count?
Can I scrape a Twitter hashtag without code?
Can I filter hashtag results by date or language?
since and until for dates and add lang:en or similar operators to the query.Can I search several hashtags at once?
OR, for example #seo OR #geo. Each page is billed once.Guides
More ways to use the API
- Access the Twitter API
- Claude Reddit bot
- Live Twitter monitor
- Reddit API application
- Reddit brand monitoring
- Reddit data export
- Reddit post API
- Reddit scraper API
- Social listening API
- Post with the Twitter API
- Twitter API statuses
- Twitter exporter
- Twitter scraper API
- Twitter webhook
- Reddit comments API
- Reddit user API
- Subreddit API
- Twitter followers API
- Twitter user API
- Twitter search API
- Social media scraping API
- Reddit listening tool
- Twitter feed API
- Social media analytics API
- Twitter image API