Fetch a user's X/Twitter timeline — their tweets, replies, likes, media posts, o
Fetch a user's X/Twitter timeline — their tweets, replies, likes, media posts, or mentions — plus follower and following lists, and per-tweet engagement lists (who replied, quoted, retweeted, or favorited). Billed per item returned. The building block for monitoring what an account posts or ranking accounts by activity.
Answeringour last check, 2026-09-24
1 of 1checks answered this week
262 msmedian answer time
$0.12listed price per call
$0.12price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://twitr.sh/api/tools/x_timeline
| Category | Everything else |
|---|---|
| Provider host | twitr.sh |
| Networks | eip155:8453 |
| Payment schemes | upto |
| Self-reported calls, 30 days | 16 from 3 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-24 | valid payment request | 402 | $0.12 | 262 ms |
Example input (from the provider)
{
"body": {
"id": "elonmusk",
"kind": "user-tweets",
"resultsLimit": 100
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"properties": {
"id": {
"description": "User ID/username or tweet ID (depends on kind).",
"type": "string"
},
"includeParentTweet": {
"type": "boolean"
},
"includeReplies": {
"type": "boolean"
},
"kind": {
"description": "Which timeline to fetch.",
"enum": [
"user-tweets",
"user-replies",
"user-likes",
"user-media",
"user-mentions",
"followers",
"following",
"verified-followers",
"tweet-replies",
"tweet-quotes",
"tweet-thread",
"tweet-favoriters",
"tweet-retweeters"
],
"type": "string"
},
"language": {
"type": "string"
},
"mediaType": {
"enum": [
"images",
"videos",
"gifs",
"media"
],
"type": "string"
},
"minFaves": {
"type": "integer"
},
"resultsLimit": {
"description": "MANDATORY: max items returned, billed per item.",
"maximum": 10000,
"minimum": 1,
"type": "integer"
},
"verifiedOnly": {
"type": "boolean"
}
},
"required": [
"kind",
"id",
"resultsLimit"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"duration": {
"description": "Run duration in seconds.",
"type": "integer"
},
"items": {
"description": "Returned items. Shape varies per tool \u2014 see each tool's outputSample for a concrete example.",
"items": {
"type": "object"
},
"type": "array"
},
"payment": {
"description": "Settlement summary (protocol, amount, currency).",
"type": "object"
},
"runId": {
"description": "Run ID for debugging/audit.",
"type": "string"
}
},
"required": [
"items"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}