The Post is one of the primary resources on X. In its simplest form, a Post can contain up to 280 characters and can be posted either publicly or privately, depending on an account’s settings. However, a variety of different objects can also be attached to Post, including media, a place, polls, and URLs. In addition, most Posts can be edited for up to 30 minutes after being created. 

While there are a variety of different HTTP, selection, and delivery methods that can deliver, publish, and act upon Posts, this group of REST endpoints simply returns a Post or group of Posts, specified by a Post ID. While simple, these endpoints can be used to receive up-to-date details on a Post, verify that a Post is available, and examine its edit history. These endpoints are also important tools for managing compliance events.

The Post lookup endpoint provides edited Post metadata. All objects for Posts created since September 29, 2022, include Post edit metadata, even if the Post was never edited. Each time a Post is edited, a new Post ID is created. A Post's edit history is documented by an array of Post IDs, starting with the original ID.

This endpoint will always return the most recent edit, along with any edit history. Any Post collected after its 30-minute edit window has expired will represent its final version. To learn more about Edit Post metadata, check out the Edit Posts fundamentals page.

These endpoints utilize the GET HTTP method and return one or many Posts objects, which include fields such as the Post text, a timestamp from when it was created, and lists and metadata of hashtags, mentions, and photos, and more. 

Account setup

To access these endpoints, you will need:

Learn more about getting access to the X API v2 endpoints in our getting started guide.