x_search 6 credits

Search X by keywords. type picks the mode: recent (default) is the deep chronological sweep and keeps paginating as far as you follow the cursor; popular returns the highest-engagement tweets for the query; people finds accounts and returns a single page (no cursor). Advanced query operators pass through verbatim, e.g. "from:nasa", "min_faves:100", exact phrases in quotes -- there is no separate date parameter, so use since:/until: operators for time windows. Costs 6 credits per page; a cursor page is a NEW call priced the same way, so a deep sweep costs linearly in pages. Returns tweet summaries (text, author with follower count, views, likes, retweets, replies, created_at, url, id) with a cursor. Fetch one tweet's full detail with x_get_tweet and an account's timeline with x_get_tweets. For comment-level sentiment inside topic communities, reddit_search type=comments is usually the sharper instrument.

Part of the X (formerly Twitter) toolset: /docs/x.

Parameters#

REST#

GET /v1/x/search · auth: required · metered: true

curl "https://api.veezee.io/v1/x/search?query=veezee+api" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

MCP#

{
  "method": "tools/call",
  "params": {
    "name": "x_search",
    "arguments": {
      "query": "veezee api"
    }
  }
}

Input examples#

Fresh mentions of a product

{
  "query": "veezee api"
}

Highest-engagement takes on a topic

{
  "query": "ai agents data access",
  "type": "popular"
}

Find accounts

{
  "query": "developer relations ai",
  "type": "people"
}

Output#

Returns a x_search envelope. Full field list: /docs/fields#x_search.

Errors#

REST returns application/problem+json; MCP returns the same content as an error result. message is written as the next-turn instruction.