X Post Details

Look up one X post by ID. This is not an X keyword search, timeline export or streaming endpoint.

Browse every endpoint with request samples, parameters and its per-request price. One API key calls them all; account limits apply.

API reference Open in Playground

At a glance

Endpoint: POST https://api.serpbase.dev/x/post
Price: 1 credits / request
Authentication: X-API-Key
Result type: schemas.source_data

Endpoint and billing rules

POSThttps://api.serpbase.dev/x/post

Per-request cost

1 credits / request

Each customer request uses the fixed catalog price, not a per-page rate. Web Crawl and User Agent currently cost 1 credit per request each; User Agent is not free. Genuine not-found results confirmed by source and resource identity are charged. no_results, HTTP 404 or missing hydration/parsed data alone cannot prove absence. Executed failures may currently consume credits; refunds are not guaranteed for every failure. credits_charged reports the actual charge: 0 means reported zero; null or missing means unknown. charge_status UNKNOWN remains unknown even with a numeric charge. Check account records and contact support with request_id; never assume a refund or retry blindly.

Example request parameters

Samples are not the complete parameter list or required-field rules. Known fields are validated; additional parameters are allowed.

Example request parameters
Parameter	Example type	Example value
id	string	"1234567890123456789"

JSON

{
  "id": "1234567890123456789"
}

Samples are not the complete parameter list or required-field rules. Known fields are validated; additional parameters are allowed.
Alias	Parameter	Type
country	locale.country	string
cursor	pagination.cursor	string
device	options.device	string
gl	locale.country	string
hl	locale.language	string
html	include_html	boolean
language	locale.language	string
limit	pagination.limit	integer
markdown	include_markdown	boolean
mobile	options.device	boolean
num	pagination.limit	integer
page	pagination.page	integer
q	query	string
tweetId	id	string

Supported devices: desktop; default: desktop.

Request examples

cURL

curl -X POST 'https://api.serpbase.dev/x/post' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"1234567890123456789"}'

JavaScript

const response = await fetch("https://api.serpbase.dev/x/post", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
  },
  "body": "{\"id\":\"1234567890123456789\"}"
});
const result = await response.json();
// Check result.status and result.error for the API outcome.
console.log(result);

Response and API outcome

Responses are JSON. HTTP 200 is not proof of search success: inspect status and error. Fields depend on the product contract and upstream data.

View response documentation

Frequently asked questions

How much does the X Post Details API cost?

Each request costs 1 credit. Credits come from prepaid packs or the monthly plan, and new accounts start with free credits.

How do I call the X Post Details API?

Send a POST request to https://api.serpbase.dev/x/post with your API key in the X-API-Key header. The response is JSON; check status (0 means success).

Which devices does it support?

Supported devices: desktop. The default is desktop.

Is the X Post Details API available now?

Yes. Any active API key can call it.