id
and the text
fields, and for Posts created since September 29, 2022, the edit_history_tweet_ids
field. If you need the Post’s created date or public metrics, you will need to use the tweet.fields
parameters to request them. This provides a higher degree of customization by enabling you to only request the fields you require depending on your use case. For example, you would include this query string in your request:
?tweet.fields=created_at,public_metrics
Each object has its own parameter which is used to specifically request the fields that are associated with that object. Here are the different fields parameters that are currently available:
When using an endpoint that primarily returns a particular object, simply use the matching field parameter and specify the field(s) desired in a comma-separated list as the value to that parameter to retrieve those fields in the response.
id
and text
. If you are interested in receiving the public metrics of the Posts that are returned in the response, you will want to include the tweet.fields
parameter in your request, with public_metrics
set as the value.
This request would look like the following. If you would like to use this request, make sure to replace $BEARER_TOKEN
with your Bearer Token and send it using your command line tool.
expansions=author_id
and user.fields=description
with your request. Here is an example of what this might look like. If you would like to try this request, make sure to replace the $BEARER_TOKEN
with your Bearer Token before pasting it into your command line tool.
includes
. The user object can be mapped back to the corresponding Post(s) by matching the tweet.author_id
and users.id fields
.
public_metrics.retweet_count
). All subfields will be returned when the top-level field (public_metrics
) is specified. We have listed all possible fields that you can request in each endpoints’ API reference page’s parameters table.
A full list of fields are listed in the object model. To expand and request fields on an object that is not that endpoint’s primary resource, use the expansions parameter with fields.