Recent search
Search for public Tweets created in the last 7 days.
For full details, see the API reference for this endpoint.
Sign up for the Twitter API
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
query | string | Required. Query for matching Tweets. Up to 512 characters. | |
start_time | string | The oldest UTC timestamp (from most recent 7 days) from which the Tweets will be provided. YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339). | |
end_time | string | The newest, most recent UTC timestamp to which the Tweets will be provided. YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339). | |
since_id | null | Returns results with a Tweet ID greater than (that is, more recent than) the specified ID. The ID specified is exclusive and responses will not include it. | |
until_id | null | Returns results with a Tweet ID less than (that is, older than) the specified ID. The ID specified is exclusive and responses will not include it. | |
max_results | null | The maximum number of search results to be returned by a request. A number between 10 and the system limit (currently 100). By default, a request response will return 10 results. | |
next_token | null | This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified. | |
tweet.fields | string | Comma-separated list of fields for the Tweet object. |
Allowed values: attachments,author_id,context_annotations,conversation_id,created_at,entities,geo,id,in_reply_to_user_id,lang,non_public_metrics,organic_metrics,possibly_sensitive,promoted_metrics,public_metrics,referenced_tweets,reply_settings,source,text,withheld
Default values: id,text
OAuth1.0a User Context authorization required if any of the following fields are included in the request:
non_public_metrics,organic_metrics,promoted_metrics |
| expansions | string | | Comma-separated list of fields to expand. Expansions enable requests to expand an ID into a full object in the includes response object.
Allowed values: attachments.poll_ids,attachments.media_keys,author_id,geo.place_id,in_reply_to_user_id,referenced_tweets.id,entities.mentions.username,referenced_tweets.id.author_id
Default values: none |
| media.fields | null | | Comma-separated list of fields for the media object. Expansion required.
Allowed values: duration_ms,height,media_key,non_public_metrics,organic_metrics,preview_image_url,promoted_metrics,public_metrics,type,url,width
Default values: media_key,type
OAuth1.0a User Context authorization required if any of the following fields are included in the request:
non_public_metrics,organic_metrics,promoted_metrics |
| place.fields | null | | Comma-separated list of fields for the place object. Expansion required.
Allowed values: contained_within,country,country_code,full_name,geo,id,name,place_type
Default values:
id,full_name |
| poll.fields | null | | Comma-separated list of fields for the poll object. Expansion required.
Allowed values: duration_minutes,end_datetime,id,options,voting_status
Default values:
id, options |
| user.fields | null | | Comma-separated list of fields for the user object. Expansion required.
Allowed values: created_at,description,entities,id,location,name,pinned_tweet_id,profile_image_url,protected,public_metrics,url,username,verified,withheld
Default values: id,name,username |
RESPONSES
status: OK
{"data":[{"id":"1563237331485671424","text":"RT @KyrieIrving: My Dad told me at a young age, \nI had a 1 in 3,333 percent chance (.03%) of making it to the NBA and that I should have ba…"},{"id":"1563237318588497922","text":"@chrisbett Not as hot on him as most for reasons I’ve never been able to articulate. Watching him give the ball away about 5 times in 5 minutes yesterday reminded me. Usually to plaudits from the comms. Good players have the ability to see a pass AND know when it’s on. Becomes basketball."},{"id":"1563237315568611328","text":"@RawKnucklesPod Depends on the event. Hockey: montréal \nBasketball: Chicago \nWWE: New York \nBoxing: Boston"},{"id":"1563237302767583232","text":"🏀🎮🍀 Larry Bird card in #NBA2K22 #myteam #xboxone #videogames Instantly a starter on my 80's \u0026amp; 90's squad. #nba #basketball #hoops https://t.co/4pYEmgS6jJ"},{"id":"1563237299671838720","text":"RT @LockedOnSEC: Getting you ready for SEC Week 0:\n🔹@AAllegretta Previews @VandyFootball at @HawaiiFootball \n🔹Interview w/ Vandy LB @Anfern…"},{"id":"1563237294127345665","text":"RT @miwon17_: Mingyu ig update with Seungkwan playing basketball \n🏀🏀 https://t.co/2SxyeuQZD7"},{"id":"1563237291308359683","text":"RT @chibbs_1: I played in the park and the recreation gym with grown men That's how I got better in basketball!"},{"id":"1563237286489182209","text":"Jeeze!! This game of men's basketball is going into overtime! Looks like someone just #HitTheButton!"},{"id":"1563237283523805186","text":"RT @KyrieIrving: My Dad told me at a young age, \nI had a 1 in 3,333 percent chance (.03%) of making it to the NBA and that I should have ba…"},{"id":"1563237275785302016","text":"RT @KyrieIrving: My Dad told me at a young age, \nI had a 1 in 3,333 percent chance (.03%) of making it to the NBA and that I should have ba…"}],"meta":{"newest_id":"1563237331485671424","oldest_id":"1563237275785302016","result_count":10,"next_token":"b26v89c19zqg8o3fpz8l5jjy5y2ebvmnt4gbs9okh9rwd"}}