Recent Search (V2) - COVID-19
Searches Twitter based upon the parameters set for each request. All parameters are turned on by default, and you should uncheck the ones you do not need.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
query | string | One query/rule/filter for matching Tweets. Up to 512 characters. | |
tweet.fields | string | Comma-separated list of fields to return in the Tweet object. By default, the endpoint only returns id and text. | |
place.fields | string | Comma-separated list of location fields to return. The response will contain the selected fields only if location data is present in any of the response objects. | |
start_time | null | YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339). The oldest UTC timestamp (from most recent 7 days) from which the Tweets will be provided. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute). | |
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. | |
end_time | null | YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339). The newest, most recent UTC timestamp to which the Tweets will be provided. Timestamp is in second granularity and is exclusive (i.e. 12:00:01 excludes the first second of the minute). | |
expansions | null | Comma-separated list of fields to expand. Expansions enable requests to expand an ID into a full object in the includes response object. (attachments.poll_ids, attachments.media_keys, author_id, entities.mentions.username, geo.place_id, in_reply_to_user_id, referenced_tweets.id, referenced_tweets.id.author_id) | |
media.fields | null | Comma-separated list of media fields to return in the Tweet media object. The response will contain the selected fields only if a Tweet contains media attachments. (duration_ms, height, media_key, preview_image_url, type, url, width) | |
poll.fields | null | Comma-separated list of fields to return in the Tweet poll object. The response will contain the selected fields only if a Tweet contains a poll. (duration_minutes, end_datetime, id, options, voting_status) | |
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. | |
max_results | number | 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. | |
user.fields | null | Comma-separated list of additional fields to return in the User object. By default, the endpoint does not return any user field. (created_at, description, entities, id, location, name, pinned_tweet_id, profile_image_url, protected, public_metrics, url, username, verified, withheld) |