Search Twitter by hashtag
Search X posts by hashtag (not free-text keyword — use twitter.search.list for that).
Headers
Get your API keyAPI key (`sfk_...`)
Hashtag to search for.
min 1 chars · max 256 chars
Optional section filter for the hashtag feed. Omit to use the default `top` section.
one of: top, latest, people, photos, videos
Optional page size. Maximum supported value is 20.
Opaque pagination cursor returned by a previous response.
min 1 chars
Endpoint-specific response payload.
Posts returned for the requested hashtag.
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.
Whether the tweet is a reply to another post.
Whether the tweet quotes another post.
Source label such as `Twitter Web App` when available.
Profiles returned for the requested hashtag.
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/hashtags?hashtag=#trending" \
-H "x-api-key: YOUR_API_KEY"Responses
Posts returned for the requested hashtag.