x

X Tweet Search

Search tweets by keyword with full X search operators (from:, to:, "exact phrase", OR, -word, min_faves:, filter:links). Returns tweets with author profiles and engagement. Costs 3 credits per page of about 20. Tip: sort=latest for monitoring, sort=top for the most-engaged tweets. Costs 3 credits.

get/v1/x/tweets/search

Request

  • Base URL: https://chatterapi.com
  • URL: https://chatterapi.com/v1/x/tweets/search
  • Auth: HTTP bearer

Query parameters

qstring required

Keyword(s) and X operators.

sort'latest' | 'top'

latest for monitoring, top for the most engaged tweets.

sincestring

Earliest date, YYYY-MM-DD.

untilstring

Latest date, YYYY-MM-DD.

langstring

Tweet language, 2 letters.

boolean
OR
string

Include retweets.

limitinteger

Max rows to return (1-100). One X page holds about 20 rows, so values above 20 still return one page.

cursorstring

Opaque cursor from the previous response's page.nextCursor.

Response

Success

requestIdstring required
cachedboolean required

Example response

{
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V"
}

Changes

No recorded changes to this operation across all 1 revision of this API.