/tweet/detailsTweet Details
Tweet
Cost / request
$0.01
Response format
JSON
Protocol
REST
About this endpoint
Access X data through agntdata: Tweet Details. This endpoint return general information about a tweet. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need tweets, user profiles, followers, search, and hashtag streams programmatically.
Use cases
AI agents that need X data in structured form
Analytics and monitoring pipelines for X content
Research and GTM workflows that combine X signals with other data
Parameters
bodyRequest Body
Content type: application/json
{
"type": "object",
"properties": {
"tweet_id": {
"type": "string"
}
}
}Responses
Response
{
"type": "object",
"properties": {
"tweet_id": {
"type": "string"
},
"creation_date": {
"type": "string"
},
"text": {
"type": "string"
},
"media_url": {
"type": "string"
},
"user": {
"type": "object",
"properties": {
"creation_date": {
"type": "string"
},
"user_id": {
"type": "string"
},
"username": {
"type": "string"
},
"name": {
"type": "string"
},
"follower_count": {
"type": "integer"
},
"following_count": {
"type": "integer"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"location": {
"type": "string"
},
"profile_pic_url": {
"type": "string"
},
"description": {
"type": "string"
},
"external_url": {
"type": "string"
},
"number_of_tweets": {
"type": "integer"
},
"bot": {
"type": "boolean"
},
"timestamp": {
"type": "null"
}
}
},
"retweet_count": {
"type": "integer"
},
"favorite_count": {
"type": "integer"
},
"reply_count": {
"type": "integer"
},
"quote_count": {
"type": "integer"
},
"retweet": {
"type": "boolean"
}
}
}Agent / Developer Schema
Machine-readable formats for integrating this endpoint into AI agents and toolchains.
{
"operationId": "Tweet_Details_post__tweet_details",
"method": "post",
"path": "/tweet/details",
"summary": "Tweet Details",
"description": "This endpoint return general information about a tweet",
"parameters": [],
"requestBody": {
"required": false,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"tweet_id": {
"type": "string"
}
}
},
"example": {
"tweet_id": "1924684020107116709"
}
}
}
},
"responses": [
{
"statusCode": "200",
"description": "Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"tweet_id": {
"type": "string"
},
"creation_date": {
"type": "string"
},
"text": {
"type": "string"
},
"media_url": {
"type": "string"
},
"user": {
"type": "object",
"properties": {
"creation_date": {
"type": "string"
},
"user_id": {
"type": "string"
},
"username": {
"type": "string"
},
"name": {
"type": "string"
},
"follower_count": {
"type": "integer"
},
"following_count": {
"type": "integer"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"location": {
"type": "string"
},
"profile_pic_url": {
"type": "string"
},
"description": {
"type": "string"
},
"external_url": {
"type": "string"
},
"number_of_tweets": {
"type": "integer"
},
"bot": {
"type": "boolean"
},
"timestamp": {
"type": "null"
}
}
},
"retweet_count": {
"type": "integer"
},
"favorite_count": {
"type": "integer"
},
"reply_count": {
"type": "integer"
},
"quote_count": {
"type": "integer"
},
"retweet": {
"type": "boolean"
}
}
},
"example": {
"tweet_id": "1924684020107116709",
"creation_date": "Tue May 20 04:30:03 +0000 2025",
"text": "🚨 BREAKING: xAI just received 168 Tesla Megapacks to power Colossus 2 their second AI data center.\n\nThat’s massive energy storage.\nEnough to run an entire neighborhood now fueling AGI.\n\nTesla + xAI = The future of power-hungry intelligence. https://t.co/SjPtA60NIq",
"media_url": [
"https://pbs.twimg.com/media/GrXZ6jybAAUjWPA.jpg"
],
"video_url": null,
"user": {
"creation_date": "Sun Jul 08 20:42:31 +0000 2018",
"user_id": "1016059981907386368",
"username": "teslaownersSV",
"name": "Tesla Owners Silicon Valley",
"follower_count": 1192960,
"following_count": 674,
"favourites_count": 166965,
"is_private": null,
"is_verified": false,
"is_blue_verified": false,
"location": "Silicon Valley",
"profile_pic_url": "https://pbs.twimg.com/profile_images/1813087894204260353/cOEDYRn-_normal.jpg",
"profile_banner_url": "https://pbs.twimg.com/profile_banners/1016059981907386368/1738008323",
"description": "The most notorious Tesla Club in the world. Creator of @thextakeover and taking the Takeover global. We amplify sustainability and philanthropy.",
"external_url": "https://linktr.ee/Teslaownerssv",
"number_of_tweets": 180512,
"bot": false,
"timestamp": 1531082551,
"has_nft_avatar": false,
"category": null,
"default_profile": false,
"default_profile_image": false,
"listed_count": 3226,
"verified_type": null
},
"language": "en",
"favorite_count": 2377,
"retweet_count": 343,
"reply_count": 460,
"quote_count": 127,
"retweet": false,
"views": 16028464,
"timestamp": 1747715403,
"video_view_count": null,
"in_reply_to_status_id": null,
"quoted_status_id": "1924585055365611799",
"binding_values": null,
"expanded_url": "https://x.com/teslaownersSV/status/1924684020107116709/photo/1",
"retweet_tweet_id": null,
"extended_entities": {
"media": [
{
"display_url": "pic.x.com/SjPtA60NIq",
"expanded_url": "https://x.com/teslaownersSV/status/1924684020107116709/photo/1",
"id_str": "1924684015833120773",
"indices": [
241,
264
],
"media_key": "3_1924684015833120773",
"media_url_https": "https://pbs.twimg.com/media/GrXZ6jybAAUjWPA.jpg",
"type": "photo",
"url": "https://t.co/SjPtA60NIq",
"ext_media_availability": {
"status": "Available"
},
"features": {
"large": {
"faces": []
},
"medium": {
"faces": []
},
"small": {
"faces": []
},
"orig": {
"faces": []
}
},
"sizes": {
"large": {
"h": 1797,
"w": 814,
"resize": "fit"
},
"medium": {
"h": 1200,
"w": 544,
"resize": "fit"
},
"small": {
"h": 680,
"w": 308,
"resize": "fit"
},
"thumb": {
"h": 150,
"w": 150,
"resize": "crop"
}
},
"original_info": {
"height": 1797,
"width": 814,
"focus_rects": [
{
"x": 0,
"y": 0,
"w": 814,
"h": 456
},
{
"x": 0,
"y": 0,
"w": 814,
"h": 814
},
{
"x": 0,
"y": 0,
"w": 814,
"h": 928
},
{
"x": 0,
"y": 0,
"w": 814,
"h": 1628
},
{
"x": 0,
"y": 0,
"w": 814,
"h": 1797
}
]
},
"allow_download_status": {
"allow_download": true
},
"media_results": {
"result": {
"media_key": "3_1924684015833120773"
}
}
}
]
},
"conversation_id": "1924684020107116709",
"retweet_status": null,
"quoted_status": {
"tweet_id": "1924585055365611799",
"creation_date": "Mon May 19 21:56:48 +0000 2025",
"text": "Let’s see how many @Tesla megapacks we can fit into a few square feet. \n\nGrid resilience and battery back-up are key to ensuring a successful future for @xai and the region. \n\nGROK Loves the megapacks! https://t.co/dgJXzAz0wD",
"media_url": null,
"video_url": null,
"user": {
"creation_date": "Sun Mar 20 20:02:36 +0000 2022",
"user_id": "1505635897810821120",
"username": "BrentM_SpaceX",
"name": "Brent Mayo",
"follower_count": 12784,
"following_count": 170,
"favourites_count": 7840,
"is_private": null,
"is_verified": false,
"is_blue_verified": true,
"location": "",
"profile_pic_url": "https://pbs.twimg.com/profile_images/1886989226807353344/1bbJImwi_normal.jpg",
"profile_banner_url": "https://pbs.twimg.com/profile_banners/1505635897810821120/1727996196",
"description": "xAI Engineer/SpaceX Engineer",
"external_url": null,
"number_of_tweets": 965,
"bot": false,
"timestamp": 1647806556,
"has_nft_avatar": false,
"category": null,
"default_profile": true,
"default_profile_image": false,
"listed_count": 139,
"verified_type": null
},
"language": "en",
"favorite_count": 1315,
"retweet_count": 100,
"reply_count": 85,
"quote_count": 50,
"retweet": false,
"views": 497120,
"timestamp": 1747691808,
"video_view_count": null,
"in_reply_to_status_id": null,
"quoted_status_id": null,
"binding_values": null,
"expanded_url": null,
"retweet_tweet_id": null,
"extended_entities": null,
"conversation_id": "1924585055365611799",
"retweet_status": null,
"quoted_status": null,
"bookmark_count": 62,
"source": "Twitter for iPhone",
"community_note": null
},
"bookmark_count": 181,
"source": "Twitter for iPhone",
"community_note": null
}
}
}
},
{
"statusCode": "422",
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"title": "HTTPValidationError",
"type": "object",
"properties": {
"detail": {
"title": "Detail",
"type": "array",
"items": {
"title": "ValidationError",
"required": [
"loc",
"msg",
"type"
],
"type": "object",
"properties": {
"loc": {
"title": "Location",
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
}
},
"msg": {
"title": "Message",
"type": "string"
},
"type": {
"title": "Error Type",
"type": "string"
}
}
}
}
}
},
"example": {
"detail": [
{
"loc": [],
"msg": "",
"type": ""
}
]
}
}
}
}
]
}Pricing
$0.01per successful request
Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.
Related endpoints
Start using this endpoint
Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.
X APIX data APItweet details APIAI agents data APIX APIX data APIX for AI agents