X (Twitter) search API for AI assistants

The X search API takes a keyword or phrase and returns matching posts, each with its text, the author handle, the post time, and engagement counts. Your assistant uses it to monitor what people are saying about a topic without opening a browser.

What it does

You pass a search query, and the provider returns posts that match, newest or most relevant first depending on the provider. The reply has the full text of each post, the author handle and display name, when it was posted, and counts for likes, retweets, and replies.

Some providers let you filter by date range or by engagement level, and some add the author's profile picture or the media attached to the post. Each post comes with its X link, so your assistant can pass the link to you or follow it for replies.

How a Joshu assistant uses it

When you ask what people are saying about your company or product, Joshu searches X and returns the three or four most recent or most popular posts with a one line note on each.

Before you reply to someone who mentioned you, Joshu pulls their recent posts to check what they were talking about or whether they posted about you before.

Every Monday, Joshu can run the same searches for your industry keywords or your competitors and email you one digest with the highlights.

Choosing a provider

Providers differ in how they rank results and in which fields they include. Some return only recent posts from the last week, and some search the full index going back years.

curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "anyapi.x.search.posts",
    "params": {
      "limit": 20,
      "query": "openai"
    }
  }'