Recent search

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

The recent search endpoint allows you to programmatically retrieve filtered public posts from the past week. It is accessible to all developers with a developer account who are using keys and tokens from an app within a project. You can authenticate requests using OAuth 1.0a User Context, OAuth 2.0 App-Only, or OAuth 2.0 Authorization Code with PKCE. However, to access private metrics or distinguish between organic and promoted metrics in post results, you must use OAuth 1.0a User Context or OAuth 2.0 Authorization Code with PKCE and provide user Access Tokens associated with the user who published the content. This endpoint can return up to 100 posts per request in reverse-chronological order. Pagination tokens are available to navigate through large datasets. For projects with regular access, you can use the basic set of operators and make queries up to 512 characters long. Projects with Enterprise Access can utilize additional operators and create queries up to 4096 characters long.

GET/2/tweets/search/recent

curl --request GET  
--url https://api.xcraper.com/2/tweets/search/recent 
--header 'Authorization: Bearer <token>'

Authorizations

Authorization required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

OAuth2UserToken the access token received from the authorization server in the OAuth 2.0 flow

Query Parameters

query required

One query/rule/filter for matching Posts. Refer to https://t.co/rulelength to identify the max query length.

Required string length: 1 - 4096

start_time

YYYY-MM-DDTHH:mm:ssZ. The oldest UTC timestamp from which the Posts 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

YYYY-MM-DDTHH:mm:ssZ. The newest, most recent UTC timestamp to which the Posts 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

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

Example: "1346889436626259968"

until_id

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

Example: "1346889436626259968"

max_result

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

Required range: 10 <= x <= 100

next_token

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.

Minimum length: 1

pagination_token

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.

Minimum length: 1

start_order

This order in which to return results.

Available option: recency, relevancy

tweet.fields

A comma separated list of Tweet fields to display.

Available option: article, attachments, author_id, card_uri, community_id, context_annotations, conversation_id, created_at, display_text_range, edit_controls, edit_history_tweet_ids, entities, geo, id, in_reply_to_user_id, lang, media_metadata, non_public_metrics, note_tweet, organic_metrics, possibly_sensitive, promoted_metrics, public_metrics, referenced_tweets, reply_settings, scopes, source, text, withheld

expansions

A comma separated list of fields to expand.

Available option: article.cover_media, article.media_entities, attachments.media_keys, attachments.media_source_tweet, attachments.poll_ids, author_id, edit_history_tweet_ids, entities.mentions.username, geo.place_id, in_reply_to_user_id, entities.note.mentions.username, referenced_tweets.id, referenced_tweets.id.attachments.media_keys, referenced_tweets.id.author_id

media.fields

A comma separated list of fields to expand.

Available option: alt_text, duration_ms, height, media_key, non_public_metrics, organic_metrics, preview_image_url, promoted_metrics, public_metrics, type, url, variants, width

poll.fields

A comma separated list of Poll fields to display.

Available option: duration_minutes, end_datetime, id, options, voting_status

user.fields

A comma separated list of User fields to display.

Available option: affiliation, connection_status, created_at, description, entities, id, is_identity_verified, location, most_recent_tweet_id, name, parody, pinned_tweet_id, profile_banner_url, profile_image_url, protected, public_metrics, receives_your_dm, subscription, subscription_type, url, username, verified, verified_followers_count, verified_type, withheld

place.fields

A comma separated list of Place fields to display.

Available option: contained_within, country, country_code, full_name, geo, id, name, place_type