Endpoint | HTTP method | Rate limit |
/2/lists/:id | GET | 75 requests per 15 minutes |
/2/users/:id/owned_lists | GET | 15 requests per 15 minutes |
fields
and expansions
. The expansions
parameter allows you to expand objects referenced in the payload. For example, looking up a List by ID allows you to pull the following expansions:
owner_id
fields
parameter allows you to select exactly which fields within the different data objects you would like to receive. These endpoints deliver List objects primarily. By default, the List object returns the id
, and name
fields. To receive additional fields such as list.created_at
or list.follower_count
, you will have to specifically request those using a list.fields parameter.
We’ve added a guide on using fields and expansions together to our X API v2 data dictionary.
The chart below shows the field and expansions available for this endpoint group:
Endpoint | Fields | Expansions |
/2/lists/:id | list.fields user.fields | owner_id |
/2/users/:id/owned_lists | list.fields user.fields | owner_id |