Socials

Search X posts

Search public X posts from the last 7 days. The query is passed to X unchanged, so its operators work (from:user, to:user, -is:retweet, conversation_id:123, "exact phrase", boolean OR). Standalone operators like is:/has:/lang: must be combined with a keyword or from: clause. Use this to find mentions to answer; reply by creating a post with platform_data.twitter.replyToTweetId set to the id you found. Rate limit: 300 requests per 15-minute window per connected account.

get/socials/twitter/search

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/socials/twitter/search
  • Auth: API key in header Authorization

Query parameters

querystring required

X search query, max 512 characters.

account_idstring

Connected X account to act as (sacct_ prefix id). Optional: a platform connects once per account, so the X account is resolved automatically.

limitinteger

Results per page, 10-100. X rejects anything below 10.

since_idstring

Only posts newer than this numeric post id — the cursor for a polling loop.

until_idstring

Only posts older than this numeric post id.

start_timestring

Oldest UTC timestamp, inclusive (ISO 8601). Within the last 7 days.

end_timestring

Newest UTC timestamp, exclusive (ISO 8601). Within the last 7 days.

cursorstring

Opaque pagination cursor from a previous response's next_cursor.

sort_order'recency' | 'relevancy'

recency (default) or relevancy.

Response

Matching X posts

object'list' required
has_moreboolean required
next_cursorstring
urlstring

Changes

No recorded changes to this operation across all 2 revisions of this API.