Twitter Tweet Details
twitter_tweet_detailsFetch a single tweet with body, author, engagement metrics, media, link card, quoted tweet, edit history, and Community Notes
Category: twitter•Timeout: 300s• Retryable
Input schema
POST this shape to /api/v1/tasks as the input field when creating a task in a group of type twitter_tweet_details.
{
"type": "object",
"properties": {
"tweetUrl": {
"type": "string",
"pattern": "^https?://(www\\.)?(x|twitter)\\.com/[^/]+/status/\\d+",
"description": "Full tweet URL on x.com or twitter.com",
"examples": [
"https://x.com/elonmusk/status/2058039896279745004"
]
}
},
"required": [
"tweetUrl"
]
}Output schema
Executors submit their output matching this shape to /api/v1/tasks/[taskId]/submit. Readers pull it back from task detail endpoints.
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"conversationId": {
"type": "string"
},
"authorScreenName": {
"type": "string"
},
"authorName": {
"type": "string"
},
"authorRestId": {
"type": "string"
},
"authorIsVerified": {
"type": "boolean"
},
"authorIsBlueVerified": {
"type": "boolean"
},
"text": {
"type": "string",
"description": "Full text (long-form note-tweets expanded)"
},
"createdAt": {
"type": "string"
},
"lang": {
"type": "string"
},
"source": {
"type": "string",
"description": "Client app, e.g. \"Twitter Web App\""
},
"replyCount": {
"type": "integer"
},
"repostCount": {
"type": "integer"
},
"quoteCount": {
"type": "integer"
},
"likeCount": {
"type": "integer"
},
"bookmarkCount": {
"type": "integer"
},
"viewCount": {
"type": "integer"
},
"isReply": {
"type": "boolean"
},
"replyToTweetId": {
"type": [
"string",
"null"
]
},
"replyToScreenName": {
"type": [
"string",
"null"
]
},
"replyToUserRestId": {
"type": [
"string",
"null"
]
},
"isRepost": {
"type": "boolean"
},
"repostOfTweetId": {
"type": [
"string",
"null"
]
},
"isQuote": {
"type": "boolean"
},
"quotedTweet": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"authorScreenName": {
"type": "string"
},
"authorName": {
"type": "string"
},
"text": {
"type": "string"
},
"createdAt": {
"type": "string"
}
}
},
"isLongTweet": {
"type": "boolean"
},
"possiblySensitive": {
"type": "boolean"
},
"media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "photo | video | animated_gif"
},
"url": {
"type": "string"
},
"thumbnailUrl": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"durationMs": {
"type": "integer"
},
"altText": {
"type": [
"string",
"null"
]
}
}
}
},
"card": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": "string"
},
"vanityUrl": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"imageUrl": {
"type": "string"
}
}
},
"urls": {
"type": "array",
"items": {
"type": "object"
}
},
"hashtags": {
"type": "array",
"items": {
"type": "object"
}
},
"cashtags": {
"type": "array",
"items": {
"type": "object"
}
},
"userMentions": {
"type": "array",
"items": {
"type": "object"
}
},
"place": {
"type": [
"object",
"null"
]
},
"community": {
"type": [
"object",
"null"
]
},
"communityNotes": {
"type": "array",
"items": {
"type": "object"
}
},
"editControl": {
"type": [
"object",
"null"
],
"properties": {
"editable": {
"type": "boolean"
},
"editsRemaining": {
"type": "integer"
},
"editTweetIds": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
},
"required": [
"url",
"data"
]
}Ready to run Twitter Tweet Details?
Create a project, approve an executor, and push your first twitter_tweet_details task.