Search

X/Twitter Search

Search X/Twitter tweets with the full operator set — keyword, exact phrase, from-user, language, date range, media type, minimum likes/retweets, verified-only — or search user profiles by keyword. Billed per tweet returned against your resultsLimit cap. Built for tracking what people say about a topic, brand, or ticker in real time.

post/api/tools/x_search

Request

  • Base URL: https://twitr.sh
  • URL: https://twitr.sh/api/tools/x_search
  • Auth: none declared

Request body

type'search-tweets' | 'search-users'

Search tweets (default) or users.

qstring required

Search query (X operator syntax supported for tweets).

resultsLimitinteger

search-tweets: MANDATORY max tweets returned, billed per tweet.

cursorstring

search-users: pagination cursor from a previous call's report.next_cursor.

fromUserstring
languagestring
sinceDatestring

YYYY-MM-DD

untilDatestring

YYYY-MM-DD

mediaType'images' | 'videos' | 'gifs' | 'media'
minFavesinteger
minRetweetsinteger
minRepliesinteger
verifiedOnlyboolean
exactPhrasestring
excludeWordsstring
advancedQuerystring

Raw X search operator string appended to q.

Response

Result dataset.

itemsobject[] required

Array of returned items. Shape varies per tool — see each tool's documentation.

runIdstring

Run ID for debugging/audit.

durationinteger

Run duration in seconds.

Changes

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