Pricing

Rating

Developer

Actor stats

Categories

Share

🐦 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

{
"query":"OpenAI",
"searchType":"Top",
"maxResults":15
}

Example Output

[
{
"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.