X (Twitter) Scraper: Tweets, Profiles, Search & Trends avatar

X (Twitter) Scraper: Tweets, Profiles, Search & Trends

Pricing

from $0.30 / 1,000 results

Go to Apify Store
X (Twitter) Scraper: Tweets, Profiles, Search & Trends

X (Twitter) Scraper: Tweets, Profiles, Search & Trends

Scrape X (Twitter) tweets, profiles, followers, replies, quotes, advanced search, trends by country or city, communities, lists and Spaces. Real-time, no login, clean JSON, auto pagination. Pay only for results.

Pricing

from $0.30 / 1,000 results

Rating

0.0

(0)

Developer

Scrapy Social

Scrapy Social

Maintained by Community

Actor stats

0

Bookmarked

3

Total users

0

Monthly active users

5 days ago

Last modified

Features

Limited permissions

Share

One actor for the whole public side of X: every tweet, profile, search tab, trend list, community and list the website shows, returned as the same clean JSON whatever endpoint you pick.

43 endpoints · real-time data · no X (Twitter) account or cookies needed · automatic pagination · batch input · pay only for results ($0.50 / 1,000 results, down to $0.30 on higher Apify plans).

What can this scraper do?

  • User: User Account About, User Followers, User Following, User Info, User Photos, User Posts, User Replies, User Reposts, User Tweets And Replies, Verified Followers, User Videos
  • Post: Comment Replies, Tweet Comments, Tweet Detail, Tweet Quotes, Tweet Retweeters
  • Trending: Explore Timeline, Trending Posts, Popular Posts, Trending Topics by Country or City
  • Search: Search Posts, Search Users
  • Community: Community About, Explore Communities, Community Info, Community Media, Community Members, Community Moderators, Community Post Search, Community Post Search Latest, Search Communities, Community Tweet Search, Community Tweets
  • List: List Members, List Subscribers, List Tweets
  • Space: Audio Space Info
  • Utility: Search Typeahead, Search Languages, Explore Locations, Explore Page, Community Member Search, Trending Locations

Use cases

  • Brand and keyword monitoring with X Advanced Search fields (language, dates, min likes, media, verified only).
  • Track what is trending right now in any of 62 countries or 400+ cities, then pull the posts behind each trend.
  • Influencer research: profiles, followers, verified followers, following, and every tweet/reply/repost/media post.
  • Conversation analysis: tweet detail, threaded comments, comment replies, quotes and retweeters.
  • Community and List intelligence: members, moderators, timelines and in-community search.

Why this scraper

  • Clean, consistent JSON. The same fields (id, author, stats, createdAt …) across endpoints, so you write your parser once.
  • Real-time. Every run fetches live data; nothing is served from a stale database.
  • No login, no blocking headaches. Sessions, proxies, signatures and retries are handled for you.
  • Pagination built in. Set Max results per query; the actor follows cursors for you and de-duplicates.
  • Batch mode. Many usernames / posts / keywords in one run.
  • Fair billing. Not-found lookups and failed calls are never charged.

How to use it

  1. Pick What to scrape (for example Search Posts).
  2. Fill the fields that endpoint uses (each field lists the endpoints that use it). Leave the others empty.
  3. Set Max results per query, then click Start.
  4. Download the results as JSON, CSV, Excel or HTML, or read them through the Apify API.

Input examples

Advanced search: popular English #bitcoin posts with images

{
"endpoint": "search-posts",
"query": "bitcoin",
"lang": "en",
"minLikes": 100,
"media": "images",
"product": "Top",
"maxItems": 100
}

What is trending in Indonesia right now

{
"endpoint": "trending-topics",
"country": "ID",
"maxItems": 50
}

A user's latest tweets

{
"endpoint": "user-posts",
"username": "NASA",
"maxItems": 200
}

All comments on a tweet

{
"endpoint": "tweet-comments",
"tweetId": "1815616000068583807",
"maxItems": 300
}

Several profiles in one run (batch)

{
"endpoint": "user-info",
"batch": [
{
"username": "nasa"
},
{
"username": "spacex"
},
{
"username": "elonmusk"
}
],
"maxItems": 50
}

Output

Each result is one dataset row. List endpoints produce one row per item; lookups produce one row. Every row has a _meta object (endpoint, query, page, scrapedAt). Trend lists and similar responses also carry the list's own fields under _context. Example row from Search Posts:

{
"id": "2120180683486486622",
"text": "JUST IN: Bitcoin falls under $73,000\n\n$200,000,000 worth of crypto longs liquidated in the past 15 minutes. https://t.co/ZA6NOe0RqQ",
"createdAt": "Tue Nov 10 15:44:00 +0000 2026",
"language": "en",
"possiblySensitive": false,
"author": {
"id": "1387497871751196672",
"username": "WatcherGuru",
"name": "Watcher.Guru",
"bio": "Watcher Guru gives you unparalleled, unbiased coverage of all-things crypto & finance in real-time | Posts Are Not Financial Advice | @BTCPrice",
"avatar": "https://pbs.twimg.com/profile_images/1641221212578754562/DfiC0KW2_normal.png",
"banner": "https://pbs.twimg.com/profile_banners/1387497871751196672/1672776767",
"location": "Texas, USA",
"createdAt": "Wed Apr 28 20:04:12 +0000 2021",
"verified": false,
"blueVerified": true,
"protected": false,
"stats": {
"followers": 4917386,
"following": 3,
"tweets": 20618,
"mediaTweets": 5078,
"likes": 40841
}
},
"stats": {
"replies": 383,
"reposts": 406,
"quotes": 101,
"likes": 3204,
"bookmarks": 64,
"views": "262294"
},
"media": [
{
"id": "2120180667858436096",
"type": "photo",
"url": "https://pbs.twimg.com/media/HWxlFY9aQAAOcTB.jpg",
"expandedUrl": "https://x.com/WatcherGuru/status/2120180683486486622/photo/1",
"thumbnail": "https://pbs.twimg.com/media/HWxlFY9aQAAOcTB.jpg",
"width": 1320,
"height": 1956
}
],
"_meta": {
"endpoint": "search-posts",
"query": {
"query": "bitcoin"
},
"page": 1,
"scrapedAt": "2026-11-11T08:00:00.000Z"
}
}

A run summary (results, pages, not found, failed, stop reason) is saved to the key-value store as OUTPUT.

Endpoints

GroupEndpoint (endpoint value)What you getPaginated
UserUser Account About (user-about)Get account provenance and transparency details.
UserUser Followers (user-followers)List a user’s followers.yes
UserUser Following (user-following)List a user’s followed accounts.yes
UserUser Info (user-info)Get a public X profile by username.
UserUser Photos (user-photos)List a user’s photo posts with cursor pagination.yes
UserUser Posts (user-posts)List a user’s published tweets with cursor pagination.yes
UserUser Replies (user-replies)List a user’s replies with cursor pagination.yes
UserUser Reposts (user-reposts)List a user’s reposts with cursor pagination.yes
UserUser Tweets And Replies (user-tweets-replies)List a user’s tweets and replies with cursor pagination.yes
UserVerified Followers (user-verified-followers)List a user's verified followers.yes
UserUser Videos (user-videos)List a user’s video posts with cursor pagination.yes
PostComment Replies (tweet-comment-replies)Get a comment, its parent chain and its replies.yes
PostTweet Comments (tweet-comments)List top-level comments on a tweet.yes
PostTweet Detail (tweet-detail)Get one tweet and the conversation chain above it.
PostTweet Quotes (tweet-quotes)List posts quoting a tweet.yes
PostTweet Retweeters (tweet-retweeters)List users who reposted a tweet.yes
TrendingExplore Timeline (explore-trending)Get ranked trends from an Explore tab (Trending or For You).yes
TrendingTrending Posts (trending-posts)Trending posts worldwide or by country, city, category and tag.yes
TrendingPopular Posts (popular-posts)Most popular posts by likes, replies, quotes, bookmarks, shares or video views.yes
TrendingTrending Topics by Country or City (trending-topics)What is trending now: top trend names worldwide, per country or per city.
SearchSearch Posts (search-posts)Search X posts with Advanced Search form fields (words, accounts, dates, engagement, media).yes
SearchSearch Users (search-users)Find X accounts by name or handle.
CommunityCommunity About (community-about)Get community moderators and featured people.
CommunityExplore Communities (community-explore)Explore public community posts.yes
CommunityCommunity Info (community-info)Get one X community by id.
CommunityCommunity Media (community-media)List community media posts.yes
CommunityCommunity Members (community-members)List a community's members.yes
CommunityCommunity Moderators (community-moderators)List a community's moderators.yes
CommunityCommunity Post Search (community-post-search)Search community posts by relevance.yes
CommunityCommunity Post Search Latest (community-post-search-latest)Search community posts by newest first.yes
CommunitySearch Communities (community-search)Find X communities by keyword.yes
CommunityCommunity Tweet Search (community-tweet-search)Search tweets inside one community.yes
CommunityCommunity Tweets (community-tweets)List community tweets.yes
ListList Members (list-members)List X list members.yes
ListList Subscribers (list-subscribers)List X list subscribers.yes
ListList Tweets (list-tweets)List the latest tweets from an X List.yes
SpaceAudio Space Info (space-info)Get an X Space by id.
UtilitySearch Typeahead (search-typeahead)Get mixed users, topics, lists and symbols.
UtilitySearch Languages (search-languages)List language codes supported by advanced search.
UtilityExplore Locations (explore-locations)Autocomplete X Explore locations.
UtilityExplore Page (explore-page)Get Explore tabs, timeline ids and current trends.yes
UtilityCommunity Member Search (community-member-search)Search members inside a community.
UtilityTrending Locations (trending-locations)List every country and city X publishes trends for, with its WOEID.

Endpoint reference

User

User Account About · user-about

Returns the public About this account fields for a username. Responds 404 when unavailable.

FieldRequiredDescription
usernameyesX/Twitter handle without leading @ (letters, numbers, underscore; 1–15 chars). Case-insensitive. Prefer this over userId when you only know the public handle.
User Followers · user-followers

Returns public profiles for a user’s followers. Send username or userId; omit cursor for page one.

FieldRequiredDescription
usernameX handle without @. Send this or userId; usernames are case-insensitive.
userIdNumeric X user rest id. Optional when username is sent — the runtime resolves it from User Info. Pattern: digits only.
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorPagination cursor from the previous response; omit for page one.
User Following · user-following

Returns public profiles for a user’s followed accounts. Send username or userId; omit cursor for page one.

FieldRequiredDescription
usernameX handle without @. Send this or userId; usernames are case-insensitive.
userIdNumeric X user rest id. Optional when username is sent — the runtime resolves it from User Info. Pattern: digits only.
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorPagination cursor from the previous response; omit for page one.
User Info · user-info

Returns profile identity, biography, verification and account counters. Responds 404 when the handle is unavailable.

FieldRequiredDescription
usernameyesX/Twitter handle without leading @ (letters, numbers, underscore; 1–15 chars). Case-insensitive. Prefer this over userId when you only know the public handle.
User Photos · user-photos

Returns clean tweet objects for a user’s photo posts. Send username or userId. Pass cursor from the response for the next page; omit it for page one.

FieldRequiredDescription
usernameX handle without @. Send this or userId; usernames are case-insensitive.
userIdNumeric X user rest id. Optional when username is sent — the runtime resolves it from User Info. Pattern: digits only.
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorPagination cursor from the previous response; omit for page one.
User Posts · user-posts

Returns clean tweet objects for a user’s published tweets. Send username or userId. Pass cursor from the response for the next page; omit it for page one.

FieldRequiredDescription
usernameX handle without @. Send this or userId; usernames are case-insensitive.
userIdNumeric X user rest id. Optional when username is sent — the runtime resolves it from User Info. Pattern: digits only.
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorPagination cursor from the previous response; omit for page one.
User Replies · user-replies

Returns clean tweet objects for a user’s replies. Send username or userId. Pass cursor from the response for the next page; omit it for page one.

FieldRequiredDescription
usernameX handle without @. Send this or userId; usernames are case-insensitive.
userIdNumeric X user rest id. Optional when username is sent — the runtime resolves it from User Info. Pattern: digits only.
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorPagination cursor from the previous response; omit for page one.
User Reposts · user-reposts

Returns a user’s reposts with cursor pagination. Each item is the repost entry (id, createdAt = when it was reposted) and repostOf = the original tweet with its full text, author, stats (incl. views) and media. Send username or userId. Pass cursor from the response for the next page; omit it for page one.

FieldRequiredDescription
usernameX handle without @. Send this or userId; usernames are case-insensitive.
userIdNumeric X user rest id. Optional when username is sent — the runtime resolves it from User Info. Pattern: digits only.
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorPagination cursor from the previous response; omit for page one.
User Tweets And Replies · user-tweets-replies

Returns clean tweet objects for a user’s tweets and replies. Send username or userId. Pass cursor from the response for the next page; omit it for page one.

FieldRequiredDescription
usernameX handle without @. Send this or userId; usernames are case-insensitive.
userIdNumeric X user rest id. Optional when username is sent — the runtime resolves it from User Info. Pattern: digits only.
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorPagination cursor from the previous response; omit for page one.
Verified Followers · user-verified-followers

Returns verified followers with cursor pagination. Send username or userId; username resolves through User Info. Empty results are a valid 200 response.

FieldRequiredDescription
usernameX handle without @. Used to resolve userId when userId is omitted.
userIdNumeric X user id. Optional when username is supplied.
countPage size. Allowed integer range: 1–40; omit = 20.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged for the next page.
User Videos · user-videos

Returns clean tweet objects for a user’s video posts. Send username or userId. Pass cursor from the response for the next page; omit it for page one.

FieldRequiredDescription
usernameX handle without @. Send this or userId; usernames are case-insensitive.
userIdNumeric X user rest id. Optional when username is sent — the runtime resolves it from User Info. Pattern: digits only.
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorPagination cursor from the previous response; omit for page one.

Post

Comment Replies · tweet-comment-replies

Returns comment (the requested comment), thread (the parent chain from the original tweet down to the comment; last item = comment) and replies (tweets replying to the comment), with cursor, hasMore and hiddenCursor. X often folds replies behind "Show more replies": when replies is empty but hiddenCursor is set, call again with cursor=hiddenCursor (that page has replies only; comment/thread are empty). Use the numeric id from comments[].id of the matching endpoint Empty replies are a valid 200 response.

FieldRequiredDescription
commentIdyesNumeric comment tweet id. Get it from comments[].id returned by the matching endpoint
rankingReply ranking. Allowed: Relevance = recommended, Recency = newest first, Likes = most liked first. Values are case-sensitive; omit = Relevance.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged for the next page.
Tweet Comments · tweet-comments

Returns top-level comments as clean tweets (stats incl. views) plus cursor, hasMore and hiddenCursor. ranking is case-sensitive: Relevance, Recency, or Likes. hiddenCursor is set when X folds low-quality / possibly-spam replies behind "Show more replies" — pass it as cursor to load them. For the replies under one comment call the "Comment Replies" endpoint with comments[].id. Empty comments are a valid 200 response.

FieldRequiredDescription
tweetIdyesNumeric tweet/status id (snowflake). Get it from Search Posts, a user timeline, or the digits after /status/ in an X URL.
rankingReply ranking. Allowed: Relevance = recommended, Recency = newest first, Likes = most liked first. Values are case-sensitive; omit = Relevance.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged for the next page.
Tweet Detail · tweet-detail

Returns tweet (the requested tweet as a clean object: text, author, stats incl. views, media) and thread (conversation root down to this tweet; the last item is the tweet itself, a single item for a non-reply). Get tweetId from Search Posts or a user timeline. Responds 404 for removed or private tweets. For replies under it use the matching endpoint

FieldRequiredDescription
tweetIdyesNumeric tweet/status id (snowflake). Get it from Search Posts, a user timeline, or the digits after /status/ in an X URL.
Tweet Quotes · tweet-quotes

Returns quote posts with cursor pagination. product is case-sensitive: Top = relevance, Latest = newest first; omit = Top. Empty results are a valid 200 response.

FieldRequiredDescription
tweetIdyesNumeric tweet/status id (snowflake). Get it from Search Posts, a user timeline, or the digits after /status/ in an X URL.
productResult order. Allowed: Top = relevance; Latest = newest first. Values are case-sensitive; omit = Top.
countPage size. Allowed integer range: 1–40; omit = 20.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged for the next page.
Tweet Retweeters · tweet-retweeters

Returns public user profiles with cursor pagination. Omit cursor for page one; an empty list is a valid result.

FieldRequiredDescription
tweetIdyesNumeric tweet/status id (snowflake). From a status URL …/status/
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorOpaque pagination cursor from the previous response (cursor field). Omit entirely on page one — do not send an empty string.

Returns the trend list of an X Explore tab: name, rank, context such as "Politics · Trending", url and related grouped trend names, plus cursor. Trends follow the account’s Explore location; for trends of a specific country use the "Trending Posts" endpoint?country=…. Empty tabs are a valid 200 response. Trends here follow the session account's Explore location; for a specific country or city use the matching endpoint

FieldRequiredDescription
tabExplore tab. Allowed (case-sensitive): trending = ranked trend list (30 trends), for_you = Explore home mix (about 12 trends). Omit = trending. X serves its News / Sports / Entertainment tabs empty over this API — use the "Trending Posts" endpoint?category=ne…
countPosts per page. Allowed integer range: 1–40; omit = 20.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged (with the same filters) for the next page.

X Global Trending: posts trending right now (last 24 hours). Omit every filter for worldwide trends. Filter by country (ISO code) (68 supported countries) or any other country via placeId from the "Explore Locations" endpoint, narrow to a category (news, crypto, sports, …) and/or a single trending tag such as a person, team or topic name. Filters combine: e.g. country=US&category=sports or country=ID&tag=Prabowo Subianto. Returns clean posts with cursor pagination.

FieldRequiredDescription
countryCountry whose trends to return (ISO 3166-1 alpha-2, case-insensitive). Omit = worldwide. Ignored when placeId is set. Allowed: US = United States, DZ = Algeria, AR = Argentina, AU = Australia, AT = Austria, BD = Bangladesh, BE = Belgium, BR = Brazil, CA = Can…
placeIdX place id of a country, for countries not in the country list — take place_id of a location_type=Country result from the "Explore Locations" endpoint?prefix=… (e.g. 8529328623192576872 = Myanmar). Overrides country. City/region ids return an empty list: X Gl…
categoryTrending category. Omit = all categories. Allowed: news = News, crypto = Cryptocurrency, gaming = Gaming, business = Business & Finance, memes = Memes, technology = Technology, relationships = Relationships, movies_tv = Movies & TV, health_fitness = Health &…
tagOne trending tag (person, team, brand, topic name as shown by X, e.g. "Donald Trump", "Minnesota Vikings"). Omit = all tags. Case and spacing should match X’s tag.
countPosts per page. Allowed integer range: 1–40; omit = 20.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged (with the same filters) for the next page.

X Creator Inspiration “top posts”: the most engaging posts for a period, ranked by the chosen engagement type, for one country and/or post language. Returns clean posts (stats incl. views) with cursor pagination. Note: omitting country returns the logged-in account’s own country (X offers no worldwide option here); pass country explicitly for predictable results.

FieldRequiredDescription
engagementRanking metric. Allowed (case-sensitive): Likes = most liked, Replies = most replied, Quotes = most quoted, Bookmarks = most bookmarked, Shares = most shared, VideoQualityViews = most-watched videos (quality video views). Omit = Likes.
periodTime window. Allowed (case-sensitive): Daily = last 24 hours, Weekly = last 7 days, Monthly = last 30 days. Omit = Daily.
countryCountry of the audience. ISO 3166-1 alpha-2 from this list (case-insensitive): US = United States, DZ = Algeria, AR = Argentina, AU = Australia, AT = Austria, BD = Bangladesh, BE = Belgium, BR = Brazil, CA = Canada, CL = Chile, CO = Colombia, CZ = Czech Repub…
languagePost language, ISO 639-1 lowercase (en, id, ja, es, pt, ar, …; see the "Search Languages" endpoint). Omit = all languages.
countPosts per page. Allowed integer range: 1–40; omit = 20.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged (with the same filters) for the next page.

Returns X's current trend list (up to 50, in rank order) for one location, without touching the account's Explore settings. Pick the location with country (ISO-2) or woeid (any country or city from the "Trending Locations" endpoint); omit both for worldwide. Feed a trend name into the "Search Posts" endpoint?query=… or the "Trending Posts" endpoint?tag=… to read the posts behind it. tweetVolume is often null because X no longer publishes volumes for most trends.

FieldRequiredDescription
countryCountry whose trends to return (ISO 3166-1 alpha-2, uppercase). Omit (with no woeid) = worldwide. Ignored when woeid is set. Allowed: DZ = Algeria, AR = Argentina, AU = Australia, AT = Austria, BH = Bahrain, BY = Belarus, BE = Belgium, BR = Brazil, CA = Canad…
woeidYahoo WOEID of a country or city from the "Trending Locations" endpoint (e.g. 1047378 = Jakarta, 2459115 = New York, 1118370 = Tokyo, 1 = Worldwide). Takes priority over country. Unsupported ids return 404.
Search Posts · search-posts

Same as X Advanced Search: every field is optional and they are combined with AND, so fill only what you need (at least one). Accounts accept @ or not; word lists accept spaces or commas. Example: query=bitcoin, lang=en, minLikes=100, media=images, since=2026-01-01. Raw X operators can still be typed in query. Pick the result tab with product (Top, Latest, People, Media, Lists).

FieldRequiredDescription
queryAll of these words — free text, matched anywhere in the post. Raw X operators still work here (e.g. bitcoin OR btc, from:elonmusk, filter:safe). Optional when any other filter below is set; send at least one search field.
exactPhraseThis exact phrase — sent as "…" (e.g. happy hour).
anyWordsAny of these words — space/comma separated, combined with OR (e.g. cats dogs → (cats OR dogs)).
excludeWordsNone of these words — space/comma separated, each excluded with - (e.g. giveaway promo → -giveaway -promo).
hashtagsThese hashtags — space/comma separated, with or without # , combined with OR (e.g. ThrowbackThursday crypto).
fromFrom these accounts — Username(s) without or with @, separated by spaces or commas; combined with OR (e.g. elonmusk, x).
toReplying to these accounts — Username(s) without or with @, separated by spaces or commas; combined with OR.
mentionsMentioning these accounts — Username(s) without or with @, separated by spaces or commas; combined with OR.
langPost language, ISO 639-1 code (e.g. en, id, ja, es). Full list: the matching endpoint Omit = any language.
sincePosted on or after this date, YYYY-MM-DD (UTC).
untilPosted before this date, YYYY-MM-DD (UTC, exclusive).
minLikesMinimum likes (min_faves). Integer ≥ 0.
minRepliesMinimum replies (min_replies). Integer ≥ 0.
minRepostsMinimum reposts (min_retweets). Integer ≥ 0.
repliesReplies. Allowed: include = posts and replies (default), exclude = original posts only, only = replies only.
linksLinks. Allowed: include = any (default), exclude = posts without links, only = posts with links.
mediaMedia. Allowed: any (default), media = with any photo/video, images = with photos, videos = with videos, none = text-only posts.
verifiedOnlytrue = only posts from verified (X Premium / blue check) accounts. Omit or false = everyone.
productResult tab. Allowed: Top = relevance, Latest = newest, People = accounts, Media = media posts, Lists = lists. Case-sensitive; omit = Top.
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorOpaque pagination cursor from the previous response (cursor field). Omit entirely on page one — do not send an empty string.
Search Users · search-users

Returns account suggestions from X typeahead. Use username from a result with User Info and all user timelines.

FieldRequiredDescription
queryyesName or @handle prefix for people search (typeahead users). Short prefixes return ranked account suggestions.

Community

Community About · community-about

Returns public profiles shown by the community About timeline. An empty people list remains a successful response.

FieldRequiredDescription
communityIdyesNumeric X Communities id from /i/communities/
Explore Communities · community-explore

Returns public community tweets from X's community Explore timeline with cursor pagination. Empty results are a valid 200 response.

FieldRequiredDescription
countPage size. Allowed integer range: 1–40; omit = 20.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged for the next page.
Community Info · community-info

Returns community metadata, rules and member counts. Responds 404 when the community is unavailable.

FieldRequiredDescription
communityIdyesNumeric X Communities id from /i/communities/
Community Media · community-media

Returns clean media posts with cursor pagination. Omit cursor for page one.

FieldRequiredDescription
communityIdyesNumeric X Communities id from /i/communities/
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorOpaque pagination cursor from the previous response (cursor field). Omit entirely on page one — do not send an empty string.
Community Members · community-members

Returns community members (id, username, name, avatar, verification, protected, role = Admin / Moderator / Member) with cursor pagination. X’s member slice is slim — call the "User Info" endpoint with the username for bio, counts and banner. Get communityId from the matching endpoint Empty results are a valid 200 response.

FieldRequiredDescription
communityIdyesNumeric community id from the "Search Communities" endpoint or /x/community/info.
countPage size. Allowed integer range: 1–40; omit = 20.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged for the next page.
Community Moderators · community-moderators

Returns community admins and moderators (id, username, name, avatar, verification, protected, role) with cursor pagination. Call the "User Info" endpoint with the username for the full profile. Get communityId from the matching endpoint

FieldRequiredDescription
communityIdyesNumeric community id from the "Search Communities" endpoint or /x/community/info.
countPage size. Allowed integer range: 1–40; omit = 20.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged for the next page.
Community Post Search · community-post-search

Returns relevant community posts with cursor pagination. Empty results are a valid 200 response.

FieldRequiredDescription
queryyesSearch text sent to X community post search.
countPage size. Allowed integer range: 1–40; omit = 20.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged for the next page.
Community Post Search Latest · community-post-search-latest

Returns newest community posts with cursor pagination. Empty results are a valid 200 response.

FieldRequiredDescription
queryyesSearch text sent to X community post search.
countPage size. Allowed integer range: 1–40; omit = 20.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged for the next page.

Returns community ids, names, topics and member counts. Pass cursor for the next page; omit for page one.

FieldRequiredDescription
queryyesKeyword to find public Communities by name/topic.
cursorOpaque pagination cursor from the previous response (cursor field). Omit entirely on page one — do not send an empty string.

Searches one community and returns clean tweets with cursor pagination. ranking is case-sensitive: Likes = most liked, Recency = newest; these are the only values captured in the HAR. Empty results are a valid 200 response.

FieldRequiredDescription
communityIdyesNumeric community id from the "Search Communities" endpoint or /x/community/info.
queryyesSearch text within the selected community.
rankingTimeline order. Allowed captured values: Likes = most liked; Recency = newest. Values are case-sensitive; omit = Likes.
countPage size. Allowed integer range: 1–40; omit = 20.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged for the next page.
Community Tweets · community-tweets

Returns clean tweets with cursor pagination. Omit cursor for page one.

FieldRequiredDescription
communityIdyesNumeric X Communities id from /i/communities/
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorOpaque pagination cursor from the previous response (cursor field). Omit entirely on page one — do not send an empty string.

List

List Members · list-members

Returns public profiles of list members. Omit cursor for page one.

FieldRequiredDescription
listIdyesNumeric X List id from /i/lists/
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorOpaque pagination cursor from the previous response (cursor field). Omit entirely on page one — do not send an empty string.
List Subscribers · list-subscribers

Returns public profiles of list subscribers. Omit cursor for page one.

FieldRequiredDescription
listIdyesNumeric X List id from /i/lists/
countPage size for this list. Integer. Use the endpoint minimum/maximum; omit to use the default shown in the form.
cursorOpaque pagination cursor from the previous response (cursor field). Omit entirely on page one — do not send an empty string.
List Tweets · list-tweets

Returns tweets from a numeric X List id with cursor pagination. Empty lists are a valid 200 response.

FieldRequiredDescription
listIdyesNumeric X List id from a list URL or the matching endpoint
countPage size. Allowed integer range: 1–40; omit = 20.
cursorOpaque cursor returned by this endpoint. Omit on page one; pass it unchanged for the next page.

Space

Audio Space Info · space-info

Returns metadata, creator and participants for a live, ended or replayable Space. Responds 404 when unavailable.

FieldRequiredDescription
spaceIdyesX Spaces id from /i/spaces/

Utility

Search Typeahead · search-typeahead

Returns X search-box suggestions. resultTypes is the exact, case-sensitive platform bundle documented below.

FieldRequiredDescription
queryyesLive search-box prefix (as typed). Returns mixed suggestions controlled by resultTypes.
resultTypesSuggestion bundle. Allowed: cashtags,events,users,topics,lists = all captured suggestion categories; users = accounts only. Values are case-sensitive. Omit = the full bundle.
Search Languages · search-languages

Returns dynamic language codes and labels for X advanced-search lang: filters.

No parameters.

Explore Locations · explore-locations

Returns dynamic place ids and labels used by Explore settings. Use placeId from this utility wherever an Explore location id is needed. place_id values feed the "Trending Posts" endpoint?placeId=… (countries and cities).

FieldRequiredDescription
prefixyesLocation name prefix for Explore trend geography. Returns place_id + name — pass place_id into Explore settings/page flows. Empty string is rejected; send at least one character when filtering.
Explore Page · explore-page

Returns the X Explore tab labels with opaque timeline ids (pass tabs[].timelineId to the "Explore Timeline" endpoint) and the trends shown on the first tab (rank is empty on the For You tab). X normally returns everything on the first load; cursor is kept for parity but the next page is usually empty.

FieldRequiredDescription
cursorExplore timeline cursor from the previous Explore Page response. Omit on first load.

Typeahead utility for community member selectors. prefix accepts a name or @handle prefix.

FieldRequiredDescription
communityIdyesNumeric X Communities id from /i/communities/
prefixyesMember name or @handle prefix inside the community. Used to resolve members for moderation/search UIs.

Returns the ~470 locations (Worldwide, countries, cities) that have trend lists. Use woeid in the "Trending Topics by Country or City" endpoint?woeid=… Filter client-side by countryCode or type (Supername = worldwide, Country, Town).

No parameters.

Pagination, limits and batch

  • Max results per query (maxItems) and Max pages per query (maxPages) bound each query; the actor stops at whichever comes first or when the source has no more pages.
  • Batch (batch) runs the selected endpoint once per object, e.g. [{"username":"a"},{"username":"b"}]. Form fields act as defaults for every batch entry.
  • Parallel queries (concurrency) controls how many batch entries run at once.
  • To continue a previous run manually, pass the last cursor from the response (with One row per result off) as the cursor field.

Pricing

This actor uses pay per event pricing: you pay for the results you get, not for compute time.

Higher Apify plans get an automatic Store discount:

Apify planPer 1,000 resultsActor start
Free$0.50$0.005
Bronze$0.40$0.004
Silver$0.35$0.003
Gold$0.30$0.0025
Platinum$0.30$0.0025
Diamond$0.30$0.0025

Example on the Free plan: 1,000 results in one run cost $0.505. Platform usage (compute, proxy, storage) is included; you pay only the events above. The start event is charged once per run at the default 512 MB memory.

Not-found lookups and failed calls are free. With One row per result off, a row holding a page of N items counts as N results.

Set Maximum cost per run in the run options to cap spending; the actor stops cleanly at that limit and keeps everything it already saved.

Integrations and API

Run it from code with the Apify API or clients and get results as JSON:

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('<username>/x-twitter-scraper').call({"endpoint":"search-posts","query":"bitcoin","lang":"en","minLikes":100,"media":"images","product":"Top","maxItems":100});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

It also works with schedules, webhooks, Make, Zapier, n8n, Google Sheets and every other Apify integration.

FAQ

Do I need a X (Twitter) account, cookies or an API key? No. Just pick an endpoint and run.

Is scraping X (Twitter) legal? This actor only returns publicly available data. You are responsible for how you use it: respect privacy laws (GDPR, CCPA), the platform's terms, and do not collect personal data without a legitimate reason.

Why did a query return nothing? The account, post or keyword may not exist, may be private, or may have no public results. Those queries are reported in the OUTPUT summary as not found and are not charged.

Can I get more than the maximum? Raise Max results per query and Max pages per query. Very large pulls are best split with Batch.

How fresh is the data? Real time: each run reads the platform at that moment.

Changelog and support

See the Changelog tab. Found a bug or need a field or endpoint? Open an issue in the Issues tab; we usually reply within a day.