Twitter Tweet Search Full Archive (V1) - Data API Endpoint

Tweet Search Full Archive (V1) by environment label, query, bearer token, pagination cursor, from date, to date and limit.


Download Twitter Tweet Search Full Archive (V1) data from the Official Twitter API | 👥  Contributors: steve 🚩  Report

✏️ Inputs

Environment Label environment_label Required

Your environment label that you set up in your Twitter Developer Account Environments. Pick any name that you want, such as dev.

E.g. dev
Query query Required

Search query to run on Twitter, see their docs for examples on how to search. Some quick tips:

Check out the list of search operators for more advanced searching techniques. Here are a few you may be interested in:

  • Hashtag Search: Just enter the search term with a hashtag in front of it, e.g. #beer If multiple hashtags are entered, the API will return tweets containing both hashtags.
  • User Mention Search: Enter the username prepended with the @ sign to get all tweets mentioning the user, e.g. @taylorswift
  • Tweets From Account: Find tweets sent from a specific account by prefixing with from:, e.g. from:interior (note do not use the @ here)
  • Free Text: Find tweets containing free text words, e.g. watching now will return tweets containing both words. Use the OR operator if you’d like, e.g. love OR hate.
  • Geolocation: Use point_radius: lat lon radius to only return Tweets geo-tagged at the location of interest
E.g. #beer
Bearer Token access_token Required

Your Twitter app’s Bearer Token for collecting data with. If you don’t have one, see How to Get a Twitter API Key Without Approval or check out Twitter’s docs on Bearer Tokens for more information.

If you get the error client-not-enrolled, then make sure you’re not using a standalone app and try creating a new application with the Add App button under a project and NOT under the standalone section.

Pagination Cursor pagination_cursor Optional

Pagination cursor. Run the first query with this blank, then look for the “next” token returned in the response. Copy and paste that here to get the 2nd page, and repeat for the 3rd page etc…

From Date from_date Optional

Date to search Tweets from (back to 2006).

E.g. 201512220000
To Date to_date Optional

Up until when to search for Tweets from.

E.g. 201712220000
Limit limit Optional

Limit of how many results to return (100 for the free sandbox).

📝 Notes

Search for Tweets within the full archive.

IMPORTANT This is a premium Twitter API endpoint (per Twitter) and you need to pay close attention to your quota in your Twitter’s developer account. They provide you with a small amount of free requests you can make each month, but if you go over your quota you will need to pay Twitter (a separate charge from the Stevesie Data Platform) to make more requests.

Posted by steve on Sept. 29, 2022, 6:30 a.m. 🚩  Report

⚡️ Endpoint

GET https://api.twitter.com/1.1/tweets/search/fullarchive/{{environment_label}}.json?query={{ query }}&next={{ pagination_cursor }}&maxResults={{ limit }}&fromDate={{ from_date }}&toDate={{ to_date }}

Body

None

Headers

Authorization
Bearer {{access_token}}