Search APIs
Loading…
← API Store
Social

X (Twitter)

X (Twitter)

One tweet

GET /twitter/v1/tweet
Test this endpoint

Every 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

NameTypeDescription
urlrequiredstringPost 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
$.authorstring
$.author_avatarstring
$.author_avatar_largestring
$.author_blue_verifiedboolean
$.author_idstring
$.author_labelobject
$.author_label.badgestring
$.author_label.descriptionstring
$.author_label.typestring
$.author_label.urlstring
$.author_namestring
$.author_verifiedboolean
$.author_verified_typenull
$.cachedboolean
$.cardnull
$.conversation_countinteger
$.created_atstring
$.credits_usedinteger
$.display_text_rangearray
$.display_text_range[]integer
$.editobject
$.edit.edit_tweet_idsarray
$.edit.edit_tweet_ids[]string
$.edit.editable_untilstring
$.edit.edits_remaininginteger
$.edit.is_edit_eligibleboolean
$.hashtagsarray
$.idstring
$.is_editedboolean
$.is_stale_editboolean
$.langstring
$.likesinteger
$.linksarray
$.mediaarray
$.mentionsarray
$.news_action_typestring
$.parent_tweetnull
$.photosarray
$.possibly_sensitivenull
$.quoted_tweetnull
$.repliesinteger
$.reply_tonull
$.reply_to_usernull
$.reply_to_user_idnull
$.symbolsarray
$.textstring
$.typestring
$.urlstring
$.videonull
$.…string