Timeline & DMs
X news story API with every version of a story
Get every version X wrote of a news story from Explore, with its time, headline and text, oldest first. 1 credit per request, and unknown stories are free.
- 200
- 400
- 401
- 402
- 404
- 424
- 429
- 502
- 503
GET
X news story API with every version of a story
1 credit per request · All plans from $0.00012/credit · Supports guest paid reads
How did an X news story change?
X writes a news story for each topic under Explore and News, and rewrites it as the topic moves. UseGET /x/news/{id}/versions to read every version of 1 story, oldest first.
headlineis the story’s headline in that version.textis the story’s text in that version.createdAtis when X wrote the version, in UTC.
Path parameters
string
required
Story ID, such as
2110209733533598095. The URL-encoded story link also works, such as
x.com/i/trending/2110209733533598095. Open a story on x.com to copy its link.Query parameters
string
Fields to keep in each row, comma-separated, such as
id,text,author.username. Use dots for nested fields. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name returns 400 unknown_field with the valid names, before any read. The price stays the same.string
Fields to drop from each row, comma-separated, such as
entities,media. It takes the same names as fields. With fields, it drops from the kept fields.Headers
string
Full account key. Sessions and OAuth also work.
string
Bearer xq_your_guest_key_here for paid_reads.Response
200 OK
string
The story ID the request named.
number
Versions returned.
object[]
The story’s versions, oldest first.
string
The version’s ID.
string
When X wrote the version, in UTC. Xquik reads it from the version’s ID.
string
The story’s headline in this version.
string
The story’s text in this version. X writes the time above it in each reader’s time zone, so Xquik
leaves that line out and serves
createdAt.400 Invalid story ID
404 Story not found
401 Unauthenticated
Anonymous requests getWWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.
402 Payment required
Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.502 X API unavailable
Related. Get X trends · Get trends history · Search tweets