🐦 Twitter Search Scraper This actor allows you to search for tweets on Twitter using a keyword or phrase. It supports different search types (Top, Latest, Media, People, Lists) and automatic pagination to collect up to the number of tweets you specify. ## Features - Search for tweets by keyword or phrase. - Supports search types: Top, Latest, Media, People. - Automatic pagination to retrieve large result sets. - Specify the maximum number of results (maxResults). - Returns detailed information for each tweet. ## Input - query (string, required): The search keyword or phrase. - searchType (string, optional): Type of search result to fetch. One of Top, Latest, Media, People, Lists. Default is Top. - maxResults (integer, optional): Maximum number of tweets to fetch. Default is 15. ## Output The output is an array of tweet objects, each containing: - tweet_id - screen_name - favorites - created_at - text - lang - source - quotes - replies - retweets - views - entities - user_info - media ## Example Input json { "query": "OpenAI", "searchType": "Top", "maxResults": 15 } ## Example Output json [ { "type": "tweet", "tweet_id": "1928111107706868204", "screen_name": "ronakkadhi", "bookmarks": 166, "favorites": 101, "created_at": "Thu May 29 15:28:05 +0000 2025", "text": "OpenAI quietly dropped a full guide on how to build AI agents from scratch.\n\nMost people won’t read it. I did. Twice.\n\nThis thread breaks it down into a tactical playbook for founders, builders, and operators.\n\nA fast-track guide to building real AI agents🧵 https://t.co/Rr2vhG2bP0", "lang": "en", "source": "<a href=\"https://typefully.com/\" rel=\"nofollow\">Typefully</a>", "quotes": 1, "replies": 2, "conversation_id": "1928111107706868204", "retweets": 38, "views": "16364", "entities": { "hashtags": [], "media": [ { "display_url": "pic.x.com/Rr2vhG2bP0", "expanded_url": "https://x.com/ronakkadhi/status/1928111107706868204/photo/1", "id_str": "1928111101520269315", "indices": [ 258, 281 ], "media_key": "3_1928111101520269315", "media_url_https": "https://pbs.twimg.com/media/GsIG1M2aUAMLBLg.jpg", "type": "photo", "url": "https://t.co/Rr2vhG2bP0", "ext_media_availability": { "status": "Available" }, "features": { "large": { "faces": [ { "x": 423, "y": 140, "h": 237, "w": 237 } ] }, "medium": { "faces": [ { "x": 423, "y": 140, "h": 237, "w": 237 } ] }, "small": { "faces": [ { "x": 239, "y": 79, "h": 134, "w": 134 } ] }, "orig": { "faces": [ { "x": 423, "y": 140, "h": 237, "w": 237 } ] } }, "sizes": { "large": { "h": 800, "w": 1200, "resize": "fit" }, "medium": { "h": 800, "w": 1200, "resize": "fit" }, "small": { "h": 453, "w": 680, "resize": "fit" }, "thumb": { "h": 150, "w": 150, "resize": "crop" } }, "original_info": { "height": 800, "width": 1200, "focus_rects": [ { "x": 0, "y": 0, "w": 1200, "h": 672 }, { "x": 170, "y": 0, "w": 800, "h": 800 }, { "x": 219, "y": 0, "w": 702, "h": 800 }, { "x": 370, "y": 0, "w": 400, "h": 800 }, { "x": 0, "y": 0, "w": 1200, "h": 800 } ] }, "media_results": { "result": { "media_key": "3_1928111101520269315" } } }, { "display_url": "pic.x.com/Rr2vhG2bP0", "expanded_url": "https://x.com/ronakkadhi/status/1928111107706868204/photo/1", "id_str": "1928111105479692291", "indices": [ 258, 281 ], "media_key": "3_1928111105479692291", "media_url_https": "https://pbs.twimg.com/media/GsIG1bmaUAMEYRX.png", "type": "photo", "url": "https://t.co/Rr2vhG2bP0", "ext_media_availability": { "status": "Available" }, "features": { "large": { "faces": [] }, "medium": { "faces": [] }, "small": { "faces": [] }, "orig": { "faces": [] } }, "sizes": { "large": { "h": 805, "w": 1020, "resize": "fit" }, "medium": { "h": 805, "w": 1020, "resize": "fit" }, "small": { "h": 537, "w": 680, "resize": "fit" }, "thumb": { "h": 150, "w": 150, "resize": "crop" } }, "original_info": { "height": 805, "width": 1020, "focus_rects": [ { "x": 0, "y": 0, "w": 1020, "h": 571 }, { "x": 183, "y": 0, "w": 805, "h": 805 }, { "x": 232, "y": 0, "w": 706, "h": 805 }, { "x": 384, "y": 0, "w": 403, "h": 805 }, { "x": 0, "y": 0, "w": 1020, "h": 805 } ] }, "media_results": { "result": { "media_key": "3_1928111105479692291" } } } ], "symbols": [], "timestamps": [], "urls": [], "user_mentions": [] }, "user_info": { "screen_name": "ronakkadhi", "name": "Ronak Kadhi", "created_at": "Sun May 13 13:06:18 +0000 2018", "description": "Building an AI designer at https://t.co/qvfuOVGxKx Tweeting about AI, Design and Marketing as I see it", "rest_id": "995651450620522496", "followers_count": 4254, "favourites_count": 1279, "avatar": "https://pbs.twimg.com/profile_images/995655731800981505/iG8sWGBw_normal.jpg", "verified": true, "friends_count": 1016, "location": null }, "media": { "photo": [ { "media_url_https": "https://pbs.twimg.com/media/GsIG1M2aUAMLBLg.jpg", "id": "1928111101520269315", "sizes": { "h": 800, "w": 1200 } }, { "media_url_https": "https://pbs.twimg.com/media/GsIG1bmaUAMEYRX.png", "id": "1928111105479692291", "sizes": { "h": 805, "w": 1020 } } ] }, "scrapedAt": "2025-05-30T02:20:28.921Z" }, ... ] ## Notes - The actor will stop fetching once it reaches the specified maxResults or there are no more tweets to fetch. - Make sure your search query complies with Twitter's search policies.