Comparing Twitter search endpoints

The following tables compare the various types of Twitter search endpoints.

Description

Labs

Standard

Premium                      

Enterprise                        

Host domain https://api.twitter.com https://api.twitter.com https://api.twitter.com https://gnip-api.twitter.com
Endpoint path

/labs/1/tweets/search

/1.1/search/tweets.json

  • /1.1/tweets/search/30day  
  • /1.1/tweets/search/fullarchive
  • /search/30day
  • /search/fullarchive/

Returns Tweets that are no older than

7 days

7 days

  • 30 days
  • March 2006
  • 30 days
  • March 2006

Maximum query characters

512

500

1,024
(256 at sandbox level)

2,048

Provides /counts endpoint

   


(premium paid levels)

Common query syntax

 

Offers fully unwound URLs  

Maximum Tweets per response (default) 

100 (10)

100 (15)

500 (100)

500 (100)

Tweet JSON format

Labs (completely new version, not backward-compatible with pre-Labs formats)

Native

Native Enriched

Native Enriched

Activity Streams

JSON key name for Tweet data array data statuses results results

JSON key name for pagination

meta.next_token

search_metadata.next_results

next

next

Supports navigating archive by time range

Time resolution of time-based requests

second

day

minute

minute

Timezone

UTC

UTC

UTC

UTC

Timestamp format

YYYY-MM-DDTHH:mm:ssZ

ISO 8601 / RFC 3339

YYYYMMDD

YYYYMMDDHHmm

YYYYMMDDHHmm

Supports navigating archive by Tweet ID

   

Request parameters for navigating by Tweet ID

  • since_id (polling)
  • until_id

 

  • since_id (polling)
  • max_id
   

Request parameter for pagination

next_token

Provides URL-encoded query

next

next



Request methods, authentication, and rate limits

Description

Labs

Standard

Premium

Enterprise

HTTP methods supported

GET

GET

  • GET
  • POST
    • GET
    • POST

    Authentication

    OAuth 2.0 Bearer Token

     

    OAuth 2.0 Bearer Token

    OAuth 1.0a

    OAuth 2.0 Bearer Token

    Basic Authentication

    Default request rate limits

    • 225 requests per 15-min (app auth)

    • 180 requests per 15-min (user auth)
    • 450 requests per 15-min (app auth)
    • 30 requests per minute 
    • 60 requests per minute (premium paid)
    • Configurable RPM. Maximum of 20 requests per second.