Headers
Get your API keyAPI key (`sfk_...`)
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
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.
Conversation identifier when supplied.
min 1 chars
Parent post identifier when this post is a reply.
min 1 chars
Quoted post identifier when this post quotes another.
min 1 chars
Original post identifier when this post is an engagement repost.
min 1 chars
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 tweet.
Like count.
≥ 0
Retweet count.
≥ 0
Reply count.
≥ 0
Quote count.
≥ 0
View count when available.
≥ 0
Bookmark 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, video
Poster or thumbnail URL for video media when distinguishable.
min 1 chars
MIME type reported for streamed media.
min 1 chars
Bitrate in bits per second when supplied for streamed media.
≥ 0
Width in pixels when available.
≥ 0
Height in pixels when available.
≥ 0
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.
Profiles returned for the requested search query.
Numeric X user id as a string.
min 1 chars
X screen name (handle) without the leading @.
Display name shown on the profile.
Profile biography text.
Best available square avatar image URL.
Profile banner image URL when available.
Whether X marks the profile with legacy verification (not necessarily paid blue).
Whether the account has X blue (paid) verification.
Whether the account is protected (private).
Canonical public profile URL on x.com.
min 1 chars
Primary outbound link from the profile when provided.
Location string from the profile when provided.
Account creation time as Unix epoch seconds when derivable.
≥ 0
Aggregate profile metrics from X.
Follower count from X.
≥ 0
Following (friends) count from X.
≥ 0
Total post (status) count from X.
≥ 0
Total favourites (likes) count from X.
≥ 0
Listed count when X provides it.
≥ 0
Media item count when X provides it.
≥ 0
Fast-followers count when X provides it.
≥ 0
Pagination information for the current response.
Cursor to pass as `cursor` in the next request when another page exists.
Whether another page 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
curl "https://api.socialfetch.dev/v1/twitter/search?query=what to watch this weekend" \
-H "x-api-key: YOUR_API_KEY"Responses
Search results for the requested query.