Twitter API v2
  • General
  • Spaces
  • Tweets
    • Tweet lookup by Tweet IDsGET
    • Full archive search countsGET
    • Recent search countsGET
    • Sample streamGET
    • Full-archive searchGET
    • Recent searchGET
    • Filtered streamGET
    • Rules lookupGET
    • Add/Delete rulesPOST
    • Tweet lookup by Tweet IDGET
    • Hide repliesPUT
    • Returns Tweet objects liked by the provided User IDGET
    • Causes the user (in the path) to like the specified tweetPOST
    • Causes the user (in the path) to unlike the specified tweetDELETE
    • User mention timeline by User IDGET
    • Causes the user (in the path) to retweet the specified tweetPOST
    • Causes the user (in the path) to unretweet the specified tweetDELETE
    • User Tweets timeline by User IDGET
  • Users
logoPowered by Apidog
  1. Tweets

Recent search

GET/2/tweets/search/recent

Returns Tweets from the last 7 days that match a search query.

Request

Query Params
query
string 
required

One query/rule/filter for matching Tweets. Up to 512 characters.

start_time
string 
optional

YYYY-MM-DDTHH:mm:ssZ. 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).

end_time
string 
optional

YYYY-MM-DDTHH:mm:ssZ. 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).

since_id
string 
optional

Returns results with a Tweet ID greater than (that is, more recent than) the specified ID.

until_id
string 
optional

Returns results with a Tweet ID less than (that is, older than) the specified ID.

max_results
integer 
optional

The maximum number of search results to be returned by a request.

next_token
string 
optional

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.

expansions
array[string]
optional

A comma separated list of fields to expand.

tweet.fields
array[string]
optional

A comma separated list of Tweet fields to display.

user.fields
array[string]
optional

A comma separated list of User fields to display.

media.fields
array[string]
optional

A comma separated list of Media fields to display.

place.fields
array[string]
optional

A comma separated list of Place fields to display.

poll.fields
array[string]
optional

A comma separated list of Poll fields to display.

Request samples

Responses

Tweets recent search response(200)
500(500)
Tweets recent search response
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
data
array[object (Tweet) {20}] 
optional
>= 1 items
attachments
object 
optional

Specifies the type of attachments (if any) present in this Tweet.

author_id
string 
optional

Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Example:
2244994945
Match pattern:
^[0-9]{1,19}$
context_annotations
array[object (ContextAnnotation) {2}] 
optional
>= 1 items
conversation_id
string 
optional

Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Example:
1346889436626259968
Match pattern:
^[0-9]{1,19}$
created_at
string <date-time>
optional

Creation time of the Tweet.

Example:
2021-01-06T18:40:40.000Z
entities
object (FullTextEntities) 
optional
geo
object 
optional

The location tagged on the Tweet, if the user provided one.

id
string 
required

Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Example:
1346889436626259968
Match pattern:
^[0-9]{1,19}$
in_reply_to_user_id
string 
optional

Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Example:
2244994945
Match pattern:
^[0-9]{1,19}$
lang
string 
optional

Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.

Example:
en
non_public_metrics
object 
optional

Nonpublic engagement metrics for the Tweet at the time of the request.

organic_metrics
object 
optional

Organic nonpublic engagement metrics for the Tweet at the time of the request.

possibly_sensitive
boolean 
optional

Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.

Example:
false
promoted_metrics
object 
optional

Promoted nonpublic engagement metrics for the Tweet at the time of the request.

public_metrics
object 
optional

Engagement metrics for the Tweet at the time of the request.

referenced_tweets
array [object {2}] 
optional

A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.

>= 1 items
reply_settings
enum<string> 
optional

Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following.

Allowed values:
everyonementionedUsersfollowingother
Match pattern:
^[A-Za-z]{1,12}$
source
string 
optional

The name of the app the user Tweeted from.

text
string 
required

The content of the Tweet.

Example:
Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\u2026 https:\/\/t.co\/56a0vZUx7i
withheld
object (TweetWithheld) 
optional

Indicates withholding details for withheld content.

errors
array[null (Problem) {17}] 
optional
>= 1 items
object 
GenericProblem
optional

A generic problem with no additional information beyond that provided by the HTTP status code.

object 
InvalidRequestProblem
optional

A problem that indicates this request is invalid.

object 
ClientForbiddenProblem
optional

A problem that indicates your client is forbidden from making this request.

object 
ResourceNotFoundProblem
optional

A problem that indicates that a given Tweet, User, etc. does not exist.

object 
ResourceUnavailableProblem
optional

A problem that indicates a particular Tweet, User, etc. is not available to you.

object 
ResourceUnauthorizedProblem
optional

A problem that indicates you are not allowed to see a particular Tweet, User, etc.

object 
FieldUnauthorizedProblem
optional

A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.

object 
DisallowedResourceProblem
optional

A problem that indicates that the resource requested violates the precepts of this API.

object 
UnsupportedAuthenticationProblem
optional

A problem that indicates that the authentication used is not supported.

object 
UsageCapExceededProblem
optional

A problem that indicates that a usage cap has been exceeded.

object 
ConnectionExceptionProblem
optional

A problem that indicates something is wrong with the connection

object 
ClientDisconnectedProblem
optional

Your client has gone away.

object 
OperationalDisconnectProblem
optional

You have been disconnected for operational reasons.

object 
RulesCapProblem
optional

You have exceeded the maximum number of rules.

object 
InvalidRuleProblem
optional

The rule you have submitted is invalid.

object 
DuplicateRuleProblem
optional

The rule you have submitted is a duplicate.

object 
ConflictProblem
optional

You cannot create a new job if one is already in progress.

includes
object (Expansions) 
optional
media
array[null (Media) {3}] 
optional
>= 1 items
places
array[object (Place) {8}] 
optional
>= 1 items
polls
array[object (Poll) {5}] 
optional
>= 1 items
tweets
array[object (Tweet) {20}] 
optional
>= 1 items
users
array[object (User) {14}] 
optional
>= 1 items
meta
object 
optional
newest_id
string 
optional

Most recent Tweet Id returned by search query

Match pattern:
^[0-9]{1,19}$
next_token
string 
optional

This value is used to get the next 'page' of results by providing it to the next_token parameter.

oldest_id
string 
optional

Oldest Tweet Id returned by search query

Match pattern:
^[0-9]{1,19}$
result_count
integer <int32>
optional

Number of search query results

Example
Not configured
Last modified: 2 years ago