Twitter Tweet Search (V1) - Data API Endpoint

Tweet Search (V1) by query, bearer token, pagination max id, result type, language and location.


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

✏️ Inputs

Query query Required

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

  • 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.
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 Max ID max_id Optional

Used for pagination. Run the first request with this blank, then insert the statuses.id value of the last result into this value to get the next page of results.

Result Type result_type Optional

The order that Twitter will return the results back, defaulting to “mixed,” showing a combination of both popular and recent results. You can also enter:

  • recent - Get the most recent tweets first
  • popular - Get the most popular tweets first
Language language Optional

Restrict the tweets returned to those matching the ISO 639-1 language code.

E.g. en
Location location Optional

Return tweets within the given search radius of a latitude and longitude. The API will attempt to use the Tweer’s geocode when available and will fall back to the Twitter user’s profile’s location otherwise. You need to enter your search location in this format: latitude,longitude,radius where you can specify radius as either mi (miles) or km (kilometers).

E.g. 37.781157,-122.398720,1mi

📝 Notes

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

⚡️ Endpoint

GET https://api.twitter.com/1.1/search/tweets.json?q={{query}}&count=100&max_id={{ max_id }}&result_type={{ result_type }}&lang={{ language }}&geocode={{ location }}&include_entities=true

Body

None

Headers

Authorization
Bearer {{access_token}}