Across the X API endpoints, there are a variety of objects available to request such as Posts and users. Each GET endpoint will have a top-level resource and object, such as Posts in recent search and filtered stream, and users in users lookup.
To see each object and it's included fields, please visit the following:
Expanded objects
Additional objects related to the top-level object, such as media, place, poll, author (user) of the Post, and user's pinned-Post are available as expansions, which you can request using the expansions query parameter.
Fields: defaults and requesting additional fields
If you make a request without any fields parameters, you will receive just a few default fields for your top-level object and any expansion objects. For example, Posts will return just the id and text of a Post by default. If you would like to request additional fields, such as the Post created_at or lang fields, you will have to use the fields parameters.
Key fields
Other useful fields that you should expect in the X API v2 data format:
- Metrics available in the Post, user, Spaces, lists objects
- Annotation topics available in the Post payload
- A new conversation_id field to help you track Posts included in a conversation
- A new reply_settings field to help you understand who has the ability to reply to specific Posts
Migrating to the X API v2 data format
Interested in learning more about how the X API v2 data format compares to standard, premium, or enterprises' formats? Check out our data format comparison guides:
- Standard v1.1 Native format to X API v2 format migration guide
- Native Enriched to X API v2 format migration guide
- Activity Streams to X API v2 format migration guide