Twitter search

from $0.0012 per resulttwitter.search

Search recent tweets on X (Twitter) by keyword, hashtag, or advanced query and get back tweet text, author, and engagement metrics.

What a call costs

Billed on actual usage, minimum $0.0020 per call, capped at $3.00 per call.

a price before every call. failed calls are never charged.

When to use it

Use when you need tweets about a topic, sentiment or chatter on X, mentions of a brand or person, or what people are saying right now.

Inputs

Twitter search takes 25 fields, 1 of them required. Anything you leave out falls back to the tool's own default.

Field	Type	Required	What it does
searchTerms	array of string	yes	Search queries. Supports X advanced search syntax.
end	string	optional	Only tweets before this date, YYYY-MM-DD
sort	string	optional	Rank by relevance (Top) or recency (Latest)
start	string	optional	Only tweets after this date, YYYY-MM-DD
author	string	optional	Only tweets sent by this handle. PERSONAL DATA: this points the search at one named person.
geocode	string	optional	Only tweets from users inside a radius of a coordinate, as latitude,longitude,radius, e.g. 37.781,-122.398,1mi.
maxItems	integer	optional	Maximum tweets to return across all search terms
inReplyTo	string	optional	Only tweets that are replies to this handle.
onlyImage	boolean	optional	Only tweets containing an image.
onlyQuote	boolean	optional	Only quote tweets.
onlyVideo	boolean	optional	Only tweets containing video.
startUrls	array of string	optional	X URLs to scrape directly instead of searching. Tweet, profile, search and list URLs all work.
mentioning	string	optional	Only tweets mentioning this handle.
withinRadius	string	optional	Radius around geotaggedNear, e.g. 15km.
geotaggedNear	string	optional	Only tweets sent near this place name.
placeObjectId	string	optional	Only tweets tagged with this X place object ID.
tweetLanguage	string	optional	Two-letter language code to restrict results
minimumReplies	integer	optional	Only tweets with at least this many replies.
twitterHandles	array of string	optional	Handles whose timelines to pull, without the @ sign.
conversationIds	array of string	optional	Conversation IDs, to pull a whole reply thread rather than a search.
minimumRetweets	integer	optional	Only tweets with at least this many retweets. Engagement floors are the cheapest way to cut noise, because you are billed per tweet returned.
onlyTwitterBlue	boolean	optional	Only tweets from X Premium (Blue) subscribers.
minimumFavorites	integer	optional	Only tweets with at least this many likes.
onlyVerifiedUsers	boolean	optional
includeSearchTerms	boolean	optional	Add the search term that found it to each tweet. Worth setting whenever you send several searchTerms in one call.

How to call it

Connect once and your agent can reach Twitter search the same way it reaches everything else in the catalog. Add Goro as an MCP connector, or paste the setup line into an agent that reads skills.

MCP

Add this server in Claude, Claude Code, or any MCP client.

https://mcp.usegoro.ai/mcp

Skill

One line in your agent's chat. It sets itself up.

set up https://usegoro.ai/SKILL.md

Or plain HTTP

POST /v1/run

{
  "endpoint": "twitter.search",
  "input": {
    "sort": "Latest",
    "maxItems": 20,
    "searchTerms": [
      "<searchTerms>"
    ]
  }
}

Related tools

More from social platforms, or browse the full tool catalog.

X followers and following

The follower list, and optionally the following list, of an X (Twitter) account, with each user's handle, display name, bio, location, follower and...

from $0.000450 per result

X profile

Public profile data for one or more X (Twitter) accounts: display name, bio, follower and following counts, tweet and media counts, verification...

from $0.0006 per result

Facebook Ads Library

Ads from the public Facebook Ads Library for a page or a keyword search, with creative body, headline, call to action, landing URL, run dates,...

from $0.002250 per result

Facebook events

Structured Facebook event records: name, description, start time and duration, going, interested and responded counts, venue with address,...

from $0.03 per event

Further reading: Social listening with AI agents: track mentions, trends and competitors

Run Twitter search from your agent.

One balance for every tool in the catalog. Start with Build, $25 of credit for $19 a month.

Get started