Signup comes with $1 in credit. No subscription needed.Claim your $1

Tools / X (Twitter) / API

An API that searches X posts by keyword and returns them with their numbers

Send a keyword, phrase or hashtag and get back the newest public X posts that match, each with likes, replies, reposts, views, date and link. Use it to catch launches, complaints or questions about a topic the day they are posted.

Real run: 10 records $0.0007 per post social.search MCP · REST · CLI

Ask your agent

Search X for product hunt launch today and list the products launching, with a link to each post.

Connect RouterGrowth once, then ask in plain words. New workspaces start with $1 of credit. Get a key or read the setup guide.

A real run

What does it return?

One call to social.search (social post search), run through RouterGrowth on October 19, 2026. These are the first rows it returned; fields that name a person are masked.

10records returned
5.1 sto answer
$0.007charged for the run
textlikesviewsposted
🚀 BlogToBook is LIVE on Product Hunt! Turn your favorite writers' blog archives into EPUB books for Kindle and Kobo. 📚 First complete expor…1492026-10-19
Product hunt can be a good way to get early tractions. Posting on X could be a good way to promote organically Targeting niche subReddits c…0122026-10-19

Ten posts for product hunt launch from the same morning: makers announcing launches, advice on early traction and launch post mortems.

Step by step

How do you do it?

  1. Write the query

    A phrase such as product hunt launch, a hashtag, or a brand name.

  2. Call social.search

    Platform x, the query and a limit. The response is a list of posts.

  3. Filter

    Drop replies (text starting with @) or keep only posts above a view count.

  4. Act

    Read the replies on a post with social.comments, or save the list to a table for outreach review.

Price

What does it cost?

List prices on X, read from the catalog when this page was built. The exact figure is quoted before every run, and a monthly plan lowers it.

$0.0007per post
$0.002minimum for a call that returns results
$0when the call finds nothing

In practice

What do you ask it?

You describe the job; the agent picks the calls, shows the price and runs them.

Search X for product hunt launch today and list the products launching, with a link to each post.

Find X posts asking for an alternative to our competitor and read the replies on the top three.

Connect

How do you connect it?

One MCP server for Claude, ChatGPT, Claude Code, Codex and Cursor, or the same call over the CLI and REST with the input above.

MCP server
claude mcp add --transport http routergrowth https://api.routergrowth.com/mcp
CLI
npm install -g routergrowth && routergrowth setup
routergrowth run -c social.search -i '{"platform": "x", "query": "product hunt launch", "limit": 10}'
REST
curl -X POST https://api.routergrowth.com/v1/run \
  -H "Authorization: Bearer $ROUTERGROWTH_API_KEY" \
  -d '{"capability": "social.search", "input": {"platform": "x", "query": "product hunt launch", "limit": 10}}'

Worth knowing

What should you know first?

Newest first

The search favours recent posts. Run it daily rather than asking for a long history.

Replies are mixed in

Replies to other posts can match the keyword. They start with an @ handle in the text.

Not X's search API

RouterGrowth is independent of X. It searches public posts through its own providers.

FAQ

Questions about twitter search tweets api

Can I search by hashtag?

Yes. Put the hashtag in the query.

Can I filter by date?

Results lean to the newest. Sort on created_at or run the search on a schedule.

How many tweets can one call return?

Set the limit you need; the quote scales with it.

Does it include views?

Yes, when X shows them, along with likes, replies and reposts.

More on X (Twitter)

Related pages

Reading this as an agent? This page as markdown: /tools/x-twitter/search-tweets-api.md

One key. Every network.

Connect your agent once. The first calls run on the $1 that comes with signup.