Creator monitoring
Pull the latest public posts from a watched account on a schedule.
X profile posts API
X (Twitter) Timeline API
Fetch a cursor-paginated page of recent public X posts or videos from one profile URL.
Input: Public X profile URL. Returns: a page of results with a cursor for the next, in X's own field names. Price: 1 credit per call; failed reads are free.
GET /v1/x/posts
See it in action
Try it with a sample URL.
The snippets use the production endpoint. Replace the sample URL with your own public target before running them.
1
Pick a sample input
Start from a valid shape, then replace the sample value with your public target.
Selected X https://x.com/X
Open
2
Preview the request
Use a server-side key and send parameters as query values.
GET
https://api.sourcevine.io/v1/x/posts curl -G 'https://api.sourcevine.io/v1/x/posts' \
-H 'Authorization: Bearer sv_live_...' \
--data-urlencode 'url=https://x.com/X' \
--data-urlencode 'limit=20'const params = new URLSearchParams({
"url": "https://x.com/X",
"limit": "20",
});
const res = await fetch('https://api.sourcevine.io/v1/x/posts?' + params, {
headers: { Authorization: 'Bearer sv_live_...' },
});
const body = await res.json();
console.log(body.data);import requests
r = requests.get(
"https://api.sourcevine.io/v1/x/posts",
params={"url": "https://x.com/X", "limit": "20"},
headers={"Authorization": "Bearer sv_live_..."},
)
body = r.json()
print(body["data"]) Replays the recorded response. Nothing leaves your browser.
3
Read the response
Every success includes availability, a fetch timestamp and billing context.
GET /v1/x/posts Not run
Hit Show sample response to see the response.
A real X (Twitter) Timeline API response, recorded against the public target above.
available 1 credit recorded
Shortened to fit. items 3 of 20. A live call returns all of it.
Shortened to fit. items 3 of 20. A live call returns all of it.
{
"data": {
"items": [
{
"url": "https://x.com/X/status/2093829017128374366",
"text": "RT @bot: Grok Bot now has improved support for X!\n\nWhen you connect your X profile, a developer account will be automatically created with…",
"likes": 0,
"views": 53859,
"cached": false,
"quotes": 0,
"replies": 0,
"tweetId": "2093829017128374366",
"retweets": 365,
"bookmarks": 0,
"fetchedAt": "2026-09-02T07:12:46Z",
"authorLink": "https://x.com/X",
"publishedAt": "Sat Aug 29 22:31:53 +0000 2026",
"authorHandle": "X",
"cacheAgeSeconds": null,
"sourceTimestamp": null
},
{
"url": "https://x.com/X/status/2092764677805609060",
"text": "just landed, just for you 🚀\n\naccess NFL Gametime on X by going to Home, add the NFL Timeline then open the NFL Gametime Hub for live scores, play-by-play and the game feed https://t.co/UCQhbtTnSP",
"likes": 2091,
"views": 1033502,
"cached": false,
"quotes": 51,
"replies": 366,
"tweetId": "2092764677805609060",
"retweets": 246,
"bookmarks": 270,
"fetchedAt": "2026-09-02T07:12:46Z",
"authorLink": "https://x.com/X",
"publishedAt": "Thu Aug 27 00:02:35 +0000 2026",
"authorHandle": "X",
"cacheAgeSeconds": null,
"sourceTimestamp": null
},
{
"url": "https://x.com/X/status/2091277720470646919",
"text": "RT @singhai: In early June, we added Mark Certificate to all emails sent from 𝕏.\n\nPlease do not engage with emails that are missing the blu…",
"likes": 0,
"views": 55611,
"cached": false,
"quotes": 0,
"replies": 0,
"tweetId": "2091277720470646919",
"retweets": 117,
"bookmarks": 0,
"fetchedAt": "2026-09-02T07:12:46Z",
"authorLink": "https://x.com/X",
"publishedAt": "Sat Aug 22 21:33:57 +0000 2026",
"authorHandle": "X",
"cacheAgeSeconds": null,
"sourceTimestamp": null
}
],
"cached": false,
"fetchedAt": null,
"nextCursor": null,
"cacheAgeSeconds": null
},
"success": true,
"available": true
}Ship it anywhere
Use this API from code, no-code tools, MCP clients and agents.
We build and maintain theseFirst-party surfaces, versioned with the API.
Works anywhere that can make an HTTP requestNo plugin to install, and none to wait for.
Response
Response fields.
Each response includes typed availability, a fetch timestamp, and only the public fields this API promises.
| Field | Type | Meaning |
|---|---|---|
| items | array | A page of public X posts or videos. |
| nextCursor | string | null | Pass as cursor to request the next page. |
| items[].views | integer | null | Present only where the platform reports it. |
| items[].likes | integer | null | Per-item public like count. |
| items[].cached | boolean | Matches the page provenance on cached reads. |
| fetchedAt | ISO datetime | When Sourcevine read the public page. |
| sourceTimestamp | ISO datetime | null | The platform timestamp when it is available. |
| cached | boolean | True when this answer repeats an identical request made moments earlier. |
| cacheAgeSeconds | integer | Seconds since the reading was taken. |
Request flow
How a request is handled.
- 01 Send a public URL
Send a public X profile URL. Sourcevine resolves ids, validates the resource type and returns a typed response.
- 02 Checked
A URL of the wrong kind or platform is refused with a 400 before any fetch, and not charged.
- 03 Read
The public data is read when you call. An identical request moments earlier is answered again, free.
- 04 Typed availability
Deleted, private and unsupported resources return explicit statuses, so clients can stop retrying facts about the world.
- 05 JSON back
X names stay intact, so your code reads fullName instead of reverse-engineering a generic schema.
fetchedAtcreditsChargedavailable
Every response carries fetchedAt and the platform timestamp, so you know how old a reading is before you act on it. X (Twitter) Timeline API fits recurring profile posts checks in dashboards, spreadsheets, workflows and agents.
Boundaries
What this API does not return.
- No contact or bio fields
Bios, email addresses, phone numbers, postal addresses and messenger handles are outside the response contract.
- No private data
Private accounts, restricted content and unavailable resources return typed availability instead of guessed data.
- No comments or downloads
List APIs return recent public post metadata and metrics. They do not return comment bodies, media files or hidden analytics.
Use cases
Where teams use X (Twitter) Timeline API.
Campaign capture
Build a dataset of recent brand mentions or campaign posts before reporting.
Lead enrichment
See whether a profile is active before spending human review time.
Content ops
Feed recent public videos into moderation, analytics or publishing workflows.
Pricing
1 credit per call, and nothing for a failed read.
The response and X-Credits-Charged header tell you what
happened, including when it is zero.
Charged1 credit
- AnsweredThe public data came back.
- Not found or privateThe lookup was made, and that is the answer. The response says which.
- Empty resultThe lookup was made and found nothing to return, such as an account with no posts.
Not charged0 credits
- Failure on our sideA timeout or a read we could not complete.
- Unsupported URLThe wrong kind of URL: refused before any fetch.
- Cache hitAn identical request moments earlier, answered again.
FAQ
Common questions.
What does X (Twitter) Timeline API return?
Fetch a cursor-paginated page of recent public X posts or videos from one profile URL.
How is it billed?
A call costs 1 credit, including an empty result. Retrieval failures are not charged.
What happens when the resource is private or deleted?
The request returns available=false with a typed availability status. Not-found and private results are charged like any lookup; unsupported URLs and retrieval failures are not.
Does Sourcevine return contact data?
No. Bios, emails, phone numbers, postal addresses and private or restricted content are outside the public response contract.
Do I need to log in to X?
No. Your integration authenticates with a Sourcevine API key. You do not need to supply X credentials or a session.