Search Twitter posts
Searches public posts on X by keyword and optional engagement/date filters. Pagination uses an opaque `cursor` returned by a previous response.
Operation
/v1/twitter/searchHeaders
API key (`sfk_...`)
Parameters
Search query text to run against public posts on X.
min 1 chars · max 512 chars
Optional search section filter. Omit to use the default `top` section.
one of: top, latest, people, photos, videos
Optional minimum retweet count filter.
≥ 0
Optional minimum like count filter.
≥ 0
Optional minimum reply count filter.
≥ 0
Optional page size. Maximum supported value is 20.
≥ 1 · ≤ 20
Optional start date filter in YYYY-MM-DD format.
pattern: ^\d{4}-\d{2}-\d{2}$
Optional end date filter in YYYY-MM-DD format.
pattern: ^\d{4}-\d{2}-\d{2}$
Optional language filter.
one of: en, es, fr, de, it, pt, ru, zh, ja, ko, ar, bg, hr, cs, da, nl, et, fi, el, hu, id, ga, lv, lt, no, pl, ro, sk, sl, sv, tr, uk, vi, cy, zu
Opaque pagination cursor returned by a previous response.
min 1 chars
Response fields
Endpoint-specific response payload.
Tweets returned for the requested search query.
Tweet id.
min 1 chars
Canonical public URL for the tweet when available.
Full tweet text when available.
Creation time as Unix epoch seconds.
≥ 0
Human-readable creation timestamp string when available.
Language code for the tweet when available.
Author metadata for the tweet when available.
Author handle without the leading @.
min 1 chars
Display name shown for the author.
Profile image URL for the author when available.
Canonical public profile URL for the author when available.
Whether the author has legacy verification on X.
Whether the author has paid blue verification on X.
Numeric X user id for the author as a string.
Engagement metrics for a Twitter search result.
Like count.
≥ 0
Retweet count.
≥ 0
Reply count.
≥ 0
Quote count.
≥ 0
View count when available.
≥ 0
Media attachments returned for the tweet.
Direct media URL when available.
min 1 chars
Media type when Social Fetch can classify it confidently.
one of: photo
Expanded URL attached to the tweet when available.
Whether the tweet is marked as a retweet.
Source label such as `Twitter Web App` when available.
Pagination information for the current response.
Cursor to pass as `cursor` in the next request when another page exists.
Whether another page of search results can be requested.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Search results for the requested query.
Error codes
Profile tweets
Returns up to roughly 100 of the account's most popular public tweets as ranked by X. This is not a chronological timeline and is not paginated with a cursor. For handle resolution, inspect `data.lookupStatus` (`found` vs `not_found`). An empty `data.tweets` array can still accompany `lookupStatus: "found"` when the account resolves but has no eligible tweets in this set—call `GET /v1/twitter/profiles/{handle}` first if you need `private` vs `not_found` for the account itself.
Tweet
Returns public metadata and engagement for a single tweet on X, including author profile context and an expanded quoted tweet when present.