← API Store
Social
X (Twitter)
X (Twitter)
One tweet
GET /twitter/v1/tweetEvery response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
urlrequired | string | Post URL or numeric id. Example: 20 |
Every endpoint also takes: raw、fields、fresh、output、records
{
"author": "jack",
"author_avatar": "https://pbs.twimg.com/profile_images/1661201415899951105/azNjKOSH_normal.jpg",
"author_avatar_large": "https://pbs.twimg.com/profile_images/1661201415899951105/azNjKOSH_400x400.jpg",
"author_blue_verified": true,
"author_id": "12",
"author_label": {
"badge": "https://pbs.twimg.com/profile_images/1285655593592791040/HtwPZgej_bigger.jpg",
"description": "Square",
"type": "BusinessLabel",
"url": "https://twitter.com/Square"
},
"author_name": "jack",
"author_verified": false,
"author_verified_type": null,
"cached": false,
"card": null,
"conversation_count": 18108,
"created_at": "2006-03-21T20:50:14.000Z",
"credits_used": 1,
"display_text_range": [
0,
24
],
"edit": {
"edit_tweet_ids": [
"20"
],
"editable_until": "2006-03-21T21:20:14.000Z",
"edits_remaining": 5,
"is_edit_eligible": true
},
"hashtags": [],
"id": "20",
"is_edited": false,
"is_stale_edit": false,
"lang": "en",
"likes": 309922,
"links": [],
"media": [],
"mentions": [],
"news_action_type": "conversation",
"parent_tweet": null,
"photos": [],
"possibly_sensitive": null,
"quoted_tweet": null,
"replies": 18108,
"reply_to": null,
"reply_to_user": null,
"reply_to_user_id": null,
"symbols": [],
"text": "just setting up my twttr",
"type": "Tweet",
"url": "https://x.com/jack/status/20",
"video": null,
"…": "1 more fields"
} Response fields (51)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.author | string |
$.author_avatar | string |
$.author_avatar_large | string |
$.author_blue_verified | boolean |
$.author_id | string |
$.author_label | object |
$.author_label.badge | string |
$.author_label.description | string |
$.author_label.type | string |
$.author_label.url | string |
$.author_name | string |
$.author_verified | boolean |
$.author_verified_type | null |
$.cached | boolean |
$.card | null |
$.conversation_count | integer |
$.created_at | string |
$.credits_used | integer |
$.display_text_range | array |
$.display_text_range[] | integer |
$.edit | object |
$.edit.edit_tweet_ids | array |
$.edit.edit_tweet_ids[] | string |
$.edit.editable_until | string |
$.edit.edits_remaining | integer |
$.edit.is_edit_eligible | boolean |
$.hashtags | array |
$.id | string |
$.is_edited | boolean |
$.is_stale_edit | boolean |
$.lang | string |
$.likes | integer |
$.links | array |
$.media | array |
$.mentions | array |
$.news_action_type | string |
$.parent_tweet | null |
$.photos | array |
$.possibly_sensitive | null |
$.quoted_tweet | null |
$.replies | integer |
$.reply_to | null |
$.reply_to_user | null |
$.reply_to_user_id | null |
$.symbols | array |
$.text | string |
$.type | string |
$.url | string |
$.video | null |
$.… | string |