Social API
X (Twitter) posts by id, with their engagement
Up to 12 X posts by id: full text, author and reply, repost, like and view counts.
/api/external/social/social-posts-by-id/{ids}What it returns
Up to 12 X (Twitter) posts by id, each with its author id, full text and its reply, repost, quote, like, bookmark and view counts, in the order asked. An id that finds no post — deleted, private, or never seen — is listed in notFound instead. Not scoped to any chain. When none of the ids finds a post the answer is 404.
Chains
This endpoint is not tied to a chain: it takes no chain in its request.
Request
Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.
curl -H "x-dex-data-key: $DEXDATA_API_KEY" \ "https://api.dexdata.io/api/external/social/social-posts-by-id/<ids>"
| Parameter | Description |
|---|---|
idspath · string · required | One to twelve X (Twitter) post ids, comma-separated (e.g. "2107191997996097648,2106593231257706646") — the decimal id at the end of a post's link. Not a transaction hash. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
posts | object[] | In the order the ids were asked, each id once. |
posts[].id | string | The post's id, a decimal string — the number at the end of its link. |
posts[].conversationId | string | null | The id of the post that opened its thread. null when not stated. |
posts[].authorId | string | null | The author's numeric X id, a decimal string. null when not stated. |
posts[].postedAt | integer | null | When it was posted, unix seconds. null when not stated. |
posts[].text | string | null | Its full text. A repost carries the reposted text, prefixed "RT @user:". null when empty. |
posts[].isRepost | boolean | null | Whether it is a repost of another post. null when not stated. |
posts[].isQuote | boolean | null | Whether it quotes another post. null when not stated. |
posts[].replyTo | object | null | The post it replies to. null when it is not a reply. |
posts[].replyTo.postId | string | null | The id of the post replied to. null when not stated. |
posts[].replyTo.userId | string | null | The replied-to author's numeric X id. null when not stated. |
posts[].replyTo.username | string | null | The replied-to author's username. null when not stated. |
posts[].replies | integer | null | Replies, when read. null when not stated. |
posts[].reposts | integer | null | Reposts, when read. null when not stated. |
posts[].quotes | integer | null | Quotes, when read. null when not stated. |
posts[].likes | integer | null | Likes, when read. null when not stated. |
posts[].bookmarks | integer | null | Bookmarks, when read. null when not stated. |
posts[].views | integer | null | Views, when read. null when not stated — some posts carry none. |
notFound | string[] | The ids asked for that found no post — deleted, private, or never seen. |
Start building with DexData today
Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.
Get a free API key