> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Overview
> The v2 Search Tweets endpoint will eventually replace the standard v1.1 search/posts endpoint and. Reference for the X API v2 standard tier covering migrate.
## Comparing X API's Search Posts endpoints
The v2 Search Tweets endpoint will eventually replace the [standard v1.1 search/posts](/x-api/posts/search/introduction) endpoint and [enterprise Search API](/x-api/enterprise-gnip-2.0/fundamentals/search-api). If you have code, apps, or tools that use an older version of a X search endpoint and are considering migrating to the newer X API v2 endpoints, then this guide is for you.
***
## Recent search comparison
The following table compares the various types of recent search endpoints:
| **Description** | **Standard v1.1** | **X API v2** |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Host domain | [https://api.x.com](https://api.x.com) | [https://api.x.com](https://api.x.com) |
| Endpoint path | /1.1/search/tweets.json | /2/tweets/search/recent |
| [Authentication](/resources/fundamentals/authentication) | OAuth 1.0a User Context
OAuth 2.0 App-Only | OAuth 1.0a User Context
OAuth 2.0 Authorization Code with PKCE
OAuth 2.0 App-Only |
| Timestamp format | YYYYMMDD | YYYY-MM-DDTHH:mm:ssZ
[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6) |
| Returns Posts that are no older than | 7 days | 7 days |
| HTTP methods supported | GET | GET |
| Default request rate limits | 180 requests per 15 min with OAuth 1.0a User Context
450 requests per 15 min with OAuth 2.0 App-Only | **Self-serve:**
60 requests per 15 min with OAuth 2.0 App-Only
60 requests per 15 min with OAuth 1.0a User Context
60 requests per 15 min with OAuth 2.0 Authorization Code with PKCE |
| Offers fully unwound URLs | | ✔ |
| Maximum Posts per response (default) | 100 (15) | 100 (10) |
| Post JSON format | Standard v1.1 format | [X API v2 format](/x-api/fundamentals/data-dictionary) (determined by fields and expansions request parameters, not backward-compatible with v1.1 formats)
To learn more about how to migrate from the Standard v1.1 format to the X API v2 format, please visit our [data formats migration guide](/x-api/migrate/data-format-migration). |
| Supports selecting which [fields](/x-api/fundamentals/fields) return in the payload | | ✔ |
| Supports requesting and receiving [annotations](/x-api/fundamentals/post-annotations) | | ✔ |
| Supports requesting specific [metrics](/x-api/fundamentals/metrics) within Post object | | ✔ |
| Supports the [conversation\_id](/x-api/fundamentals/conversation-id) operator and field | | ✔ |
| Provides Post edit history | ✔ | ✔ |
| JSON key name for Post data array | statuses | data |
| JSON key name for pagination | search\_metadata.next\_results | meta.next\_token |
| Supports navigating archive by time range | ✔ | ✔ |
| Time resolution of time-based requests | day | second |
| Timezone | UTC | UTC |
| Request parameters for navigating by time | until | start\_time
end\_time |
| Request parameters for navigating by Post ID | since\_id
max\_id | since\_id
until\_id |
| Request parameter for pagination | Provides URL-encoded query | next\_token |
| Requires the use of credentials from a [developer App](/resources/fundamentals/developer-apps) associated with a [Project](/resources/fundamentals/developer-apps) | | ✔ |
### Full-archive search comparison
The following table compares the various types of full-archive search endpoints:
| **Description** | **Enterprise** | **X API v2** |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------- |
| Host domain | [https://gnip-api.x.com](https://gnip-api.x.com) | [https://api.x.com](https://api.x.com) |
| Endpoint path | /search/fullarchive/accounts/:account\_name/:label | /2/tweets/search/all |
| [Authentication](/resources/fundamentals/authentication) | Basic auth | OAuth 2.0 App-Only |
| Timestamp format | YYYYMMDDHHMM | YYYY-MM-DDTHH:mm:ssZ
[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6) |
| Returns Posts that are no older than | The full archive since March 2006 | The full archive since March 2006 |
| HTTP methods supported | GET
POST | GET |
| Default request rate limits | The per minute rate limit will vary by partner as specified in your contract.
20 requests per sec with Basic auth | 300 requests per 15 min with OAuth 2.0 App-Only
1 requests per 1 sec with OAuth 2.0 App-Only |
| Offers fully unwound URLs | ✔ | ✔ |
| Posts per response | Maximum: 500
Default: 100 | Maximum: 500
Default: 10 |
| Post JSON format | [Native Enriched or Activity Streams](/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary) format | [X API v2](/x-api/fundamentals/data-dictionary) format (determined by fields and expansions request parameters) |
| Supports selecting which [fields](/x-api/fundamentals/fields) return in the payload | | ✔ |
| Supports requesting and receiving [annotations](/x-api/fundamentals/post-annotations) | | ✔ |
| Supports requesting specific [metrics](/x-api/fundamentals/metrics) within Post object | | ✔ |
| Supports the [conversation\_id](/x-api/fundamentals/conversation-id) operator and field | | ✔ |
| Provides Post edit history | ✔ | ✔ |
| JSON key name for Post data array | results | data |
| JSON key name for pagination | **next** | meta.next\_token |
| Time resolution of time-based requests | second | second |
| Timezone | UTC | UTC |
| Supports navigating archive by Post ID | | ✔ |
| Request parameters for navigation by time | fromDate
toDate | start\_time
end\_time |
| Request parameters for navigating by Post ID | | since\_id
until\_id |
| Request parameter for pagination | next\_token | next\_token |
| Requires the use of credentials from a [developer App](/resources/fundamentals/developer-apps) associated with a [Project](/resources/fundamentals/developer-apps) that has Academic Research access | | ✔ |
**Filtering operator comparison**
The four different versions (standard, enterprise, and v2) of search Posts differ in which operators are available, and also have varying levels of operator availability within each version, which are explained below.
Enterprise
* There are no sub-tiers of enterprise operators
X API v2
* **Self-serve:** Available when using any Project
* **Enterprise:** Available when using a Project
You can learn more about each of these sets of operators in their respective guides:
* [Enterprise operators](/x-api/enterprise-gnip-2.0/fundamentals/search-api#available-operators)
* [X API v2 operators](/x-api/posts/search/integrate/build-a-query#operators)
Now that we understand the different operator levels within X API v2, here is the table that maps out operator availability for search Posts (note that if the cell is left blank, the operator is not available):
| Search operator | Standard | Enterprise | v2 |
| :---------------------------------- | :----------------------------------------------- | :--------- | :--------------------------------------------- |
| keyword | Available
q:keyword | Available | Available |
| emoji | Available
q:😄 | Available | Available |
| "exact phrase" | Available | Available | Available |
| # | Available | Available | Available |
| \$ | Available | Available | Available |
| @ | Available | Available | Available |
| from: | Available | Available | Available |
| to: | Available | Available | Available |
| url: | Available | Available | Available |
| retweets\_of: | | Available | Available |
| context: | | | Available |
| entity: | | | Self-serve - Only available with recent search |
| conversation\_id: | | | Available |
| place: | | Available | Available |
| place\_country: | | Available | Available |
| point\_radius: | geocode parameter | Available | Available |
| bounding\_box: | | Available | Available |
| is:retweet | filter:retweets | Available | Available |
| is:reply | | Available | Available |
| is:quote | | Available | Available |
| is:verified | | Available | Available |
| -is:nullcast | | Available | Available |
| has:hashtags | | Available | Available |
| has:cashtags | | Available | Available |
| has:links | filter:links | Available | Available |
| has:mentions | | Available | Available |
| has:media | filter:media | Available | Available |
| has:images | filter:images, filter:twimg | Available | Available |
| has:videos | filter:videos
filter:native\_video | Available | Available |
| has:geo | | Available | Available |
| lang: | lang - can be used as an operator or a parameter | Available | Available |
| has:profile\_geo | | Available | |
| profile\_country | | Available | |
| profile\_locality | | Available | |
| profile\_region | | Available | |
| proximity | | Available | |
| :( | Available | | |
| :) | Available | | |
| ? | Available | | |
| filter:periscope | Available | | |
| list: | Available | | Available |
| filter:replies | Available | | |
| filter:pro\_video | Available | | |
| filter:social | Available | | |
| filter:trusted | Available | | |
| filter:follows | Available | | |
| filter:has\_engagement | Available | | |
| include:antisocial | Available | | |
| include:offensive\_user | Available | | |
| include:antisocial\_offensive\_user | Available | | |
| include:sensitive\_content | Available | | |
| source: | Available | | |
| min\_replies: | Available | | |
| min\_retweets: | Available | | |
| min\_faves: | Available | | |
| card\_name: | Available | | |
| card\_domain: | Available | | |
**Other migration resources**
[X API migration hub](/x-api/migrate/overview)
[Check out some sample code for these endpoints](https://github.com/xdevplatform/Twitter-API-v2-sample-code "Check out some sample code for these endpoints")
[Search Posts: Standard v1.1 to X API v2](/x-api/posts/search/migrate/standard-to-twitter-api-v2)
[Search Posts: Enterprise to X API v2](/x-api/posts/search/migrate/enterprise-to-twitter-api-v2)