v1 to v2

If you have been working with the v1.1 search/posts, the goal of this guide is to help you. Reference for the X API v2 standard tier covering migrate.

Standard v1.1 compared to X API v2

If you have been working with the v1.1 search/posts, the goal of this guide is to help you understand the similarities and differences between the standard and X API v2 search Posts endpoint.

• Similarities
  • OAuth 1.0a User Context and OAuth 2.0 App-Only
  • Support for Post edit history and metadata. 
• Differences

  • Endpoint URLs

  • App and Project requirements

  • Response data format

  • Request parameters

  • New query operators

  • AND / OR operator precedence 

Similarities

OAuth 1.0a User Context and OAuth 2.0 App-Only authentication

The v1.1 search/posts and the X API v2 recent search endpoint support both OAuth 1.0a User Context and OAuth 2.0 App-Only. 

Therefore, if you were previously using the standard v1.1 search endpoint you can continue using the same authentication method if you migrate to the X API v2 version. 

Depending on your authentication library/package of choice, App-Only authentication is probably the easiest way to get started and can be set with a simple request header. To learn how to generate an App Access Token see this OAuth 2.0 App-Only guide. 

If you would like to take advantage of the ability to pull private or advertising metrics with the X API v2 endpoint, you will need to use OAuth 1.0a User Context, and pass the user access tokens related to the user who posted the Post for which you would like to pull metrics. 

Support for Post edit history and metadata

Both versions provide metadata that describes any edit history. Check out the search API References and the Post edits fundamentals page for more details.