{"uid":"cap_PPWj6-HbCIVhlBe9gHPIz","slug":"tweet-scraper-v2-x-twitter-scraper-apidojo-10c49c52","name":"Tweet Scraper V2 - X / Twitter Scraper (apidojo)","description":"Start the \"🏯 Tweet Scraper V2 - X / Twitter Scraper\" Apify actor (apidojo/tweet-scraper). ⚡️ Lightning-fast search, URL, list, and profile scraping, with customizable filters. At $0.40 per 1000 tweets, and 30-80 tweets per second, it is ideal for re…","url":"https://stableapify.dev/api/actors/apidojo/tweet-scraper/call","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"end":{"type":"string","description":"Returns tweets sent before the given date."},"sort":{"enum":["Top","Latest","Latest + Top"],"type":"string","description":"Sorts search results. If you are getting low results, try Top instead of Latest. Latest + Top runs both simultaneously to maximize results but may return some duplicate tweets."},"start":{"type":"string","description":"Returns tweets sent after the given date."},"author":{"type":"string","description":"Returns tweets sent by the given user. It should be a Twitter (X) Handle."},"geocode":{"type":"string","description":"Returns tweets sent by users located within a given radius of the given latitude/longitude."},"maxItems":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Maximum number of items that you want as output."},"inReplyTo":{"type":"string","description":"Returns tweets that are replies to the given user. It should be a Twitter (X) Handle."},"onlyImage":{"type":"boolean","description":"If selected, only returns tweets that contain images."},"onlyQuote":{"type":"boolean","description":"If selected, only returns tweets that are quotes."},"onlyVideo":{"type":"boolean","description":"If selected, only returns tweets that contain videos."},"startUrls":{"type":"array","items":{"type":"string"},"description":"Twitter (X) URLs. Paste the URLs and get the results immediately. Tweet, Profile, Search or List URLs are supported."},"mentioning":{"type":"string","description":"Returns tweets mentioning the given user. It should be a Twitter (X) Handle."},"searchTerms":{"type":"array","items":{"type":"string"},"description":"Search terms you want to search from Twitter (X). You can refer to https://github.com/igorbrigadir/twitter-advanced-search."},"withinRadius":{"type":"string","description":"Returns tweets sent within the given radius of the given location."},"geotaggedNear":{"type":"string","description":"Returns tweets sent near the given location."},"placeObjectId":{"type":"string","description":"Returns tweets tagged with the given place."},"tweetLanguage":{"enum":["ab","aa","af","ak","sq","am","ar","an","hy","as","av","ae","ay","az","bm","ba","eu","be","bn","bi","bs","br","bg","my","ca","ch","ce","ny","zh","cu","cv","kw","co","cr","hr","cs","da","dv","nl","dz","en","eo","et","ee","fo","fj","fi","fr","fy","ff","gd","gl","lg","ka","de","el","kl","gn","gu","ht","ha","he","hz","hi","ho","hu","is","io","ig","id","ia","ie","iu","ik","ga","it","ja","jv","kn","kr","ks","kk","km","ki","rw","ky","kv","kg","ko","kj","ku","lo","la","lv","li","ln","lt","lu","lb","mk","mg","ms","ml","mt","gv","mi","mr","mh","mn","na","nv","nd","nr","ng","ne","no","nb","nn","ii","oc","oj","or","om","os","pi","ps","fa","pl","pt","pa","qu","ro","rm","rn","ru","se","sm","sg","sa","sc","sr","sn","sd","si","sk","sl","so","st","es","su","sw","ss","sv","tl","ty","tg","ta","tt","te","th","bo","ti","to","ts","tn","tr","tk","tw","ug","uk","ur","uz","ve","vi","vo","wa","cy","wo","xh","yi","yo","za","zu"],"type":"string","description":"Restricts tweets to the given language, given by an ISO 639-1 code."},"minimumReplies":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Returns tweets with at least the given number of replies."},"twitterHandles":{"type":"array","items":{"type":"string"},"description":"Twitter handles that you want to search on Twitter (X)"},"conversationIds":{"type":"array","items":{"type":"string"},"description":"Conversation IDs that you want to search on Twitter (X)"},"minimumRetweets":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Returns tweets with at least the given number of retweets."},"onlyTwitterBlue":{"type":"boolean","description":"If selected, only returns tweets by users who are Twitter Blue subscribers."},"minimumFavorites":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Returns tweets with at least the given number of favorites."},"customMapFunction":{"type":"string","description":"Function that takes each of the objects as argument and returns data that will be mapped by the function itself. This function is not intended for filtering, please don't use it for filtering purposes or you will get banned automatically."},"onlyVerifiedUsers":{"type":"boolean","description":"If selected, only returns tweets by users who are verified."},"includeSearchTerms":{"type":"boolean","description":"If selected, a field will be added to each tweets about the search term that was used to find it."}},"description":"Normalized actor input. See field descriptions for the simplified shape; native Apify input also accepted (passed through).","additionalProperties":{}},"options":{"type":"object","properties":{"build":{"type":"string","maxLength":100,"minLength":1},"memory":{"type":"integer","maximum":32768,"minimum":128},"maxItems":{"type":"integer","maximum":100000,"minimum":1}},"description":"Optional Apify run options.","additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"username":"sarptecimer"},"options":{"memory":1024,"maxItems":100}},"response":{"run":{"id":"fAGcK2VhH5wL8iQVn","status":"READY","actorId":"61RPP7dywgiy0JPD0","startedAt":"2026-06-21T05:30:24.455Z","usageTotalUsd":0,"defaultDatasetId":"p6OPTGJ4lylutlGzJ"},"token":"eyJhbGciOiJIUzI1NiJ9.eyJydW5JZCI6ImZBR2NLMlZoSDV3TDhpUVZuIiwiYWN0b3JJZCI6ImFwaWRvam8vdHdlZXQtc2NyYXBlciIsImRlZmF1bHREYXRhc2V0SWQiOiJwNk9QVEdKNGx5bHV0bEd6SiIsInciOiIweDljYzQyZjNkOTI0NWI4NjdhY2NjZDYzMGI0M2Y5MDZjMTY2NWIxNzYiLCJpYXQiOjE3ODIwMTk4MjQsImV4cCI6MTc4NDYxMTgyNH0.bGYRPRIJtIT8BMlOwZV29EvzfzqoW3mvJCGStwIRp5Q"}},"exampleRequest":{"input":{"username":"sarptecimer"},"options":{"memory":1024,"maxItems":100}},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RTn18446wXVv5Aukdij_k","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Starts an Apify actor run to scrape tweets by username, search query, URL, list, or profile with customizable filters at high speed","exampleAgentPrompt":"Scrape up to 200 tweets from the Twitter user @elonmusk using the Tweet Scraper V2 actor, with 1024 MB of memory allocated.","exampleUseCases":[{"title":"Brand mention monitoring on Twitter","prompt":"Pull up to 500 recent tweets that mention 'OpenAI' from Twitter — I want to track what people are saying about the brand this week."},{"title":"Competitor social media analysis","prompt":"Scrape the last 300 tweets from the Twitter profile @anthropicai so I can analyze their content strategy and posting frequency."},{"title":"Research dataset from Twitter list","prompt":"Extract up to 1000 tweets from Twitter username 'lexfridman' using 1024 MB memory so I can build a dataset of his public commentary."}],"resultDescription":"Returns an actor run object containing the run ID, status (READY), actor ID, start timestamp, total USD usage, default dataset ID for retrieving scraped tweets, and a JWT access token used to fetch results from the dataset endpoint.","failureModes":["Invalid username or query yields empty dataset","Insufficient memory setting causes actor to fail or time out","Rate limits or Twitter anti-bot measures may reduce tweet yield","Expired or invalid token prevents dataset retrieval","Actor may return READY status but fail asynchronously — status must be polled","maxItems set too high may exhaust budget or hit Apify limits"],"whenToPreferThis":"Choose this endpoint when you need fast, high-volume tweet extraction from Twitter/X by username, keyword search, URL, list, or profile. At $0.40 per 1000 tweets and 30–80 tweets/second, it is cost-effective for bulk data collection. Prefer over manual scraping or less specialized APIs when you need structured tweet data at scale with filtering options.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:51:49.198Z","isFirstParty":false}