Enterprise user lookup v2 migration

Compare Standard v1.1 users/show and users/lookup endpoints with the X API v2 user lookup endpoints, including fields, expansions, and authentication.

Comparing X API’s users lookup endpoints

The v2 user lookup endpoints will replace the standard v1.1 GET users/lookup and GET users/show endpoints. If you have code, apps, or tools that use one of these versions of the user lookup endpoints, and are considering migrating to the newer X API v2 endpoint, then this set of guides is for you.   

The following tables compare the various types of users lookup endpoints:  

Description	Standard v1.1	X API v2
HTTP methods supported	GET	GET
Host domain	https://api.x.com	https://api.x.com
Endpoint path	/1.1/users/show.json /1.1/users/lookup.json	/2/users /2/users/:id /2/users/by /2/users/by/:username
Authentication	OAuth 1.0a User Context	OAuth 1.0a User Context App only OAuth 2.0 Authorization Code with PKCE
Default request rate limits	900 requests per 15 min (per user) /show - 900 requests per 15 min (per app) /lookup - 300 requests per 15 min (per app)	900 requests per 15 min (per user) 300 requests per 15 min (per app)
Maximum Users per response	/show -  1 /lookup - 100	100
JSON response object format	Standard v1.1 format	X API v2 format (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.
Supports selecting which fields return in the payload		✔
Supports the annotations fields (on pinned Post)		✔
Supports requesting new metrics fields (on pinned Post)		✔
Supports the conversation_id field (on pinned Post)		✔
Requires the use of credentials from a developer App associated with a project		✔

Other migration resources

User lookup: Standard v1.1 to X API v2

X API migration hub

Check out some sample code for these endpoints