Xshot API

Base URL

https://api.xshot.fun

Authentication

All requests require an API key. Three methods are supported:

curl "https://api.xshot.fun/twitter/user/info?username=elonmusk&api_key=YOUR_KEY"

curl -H "x-api-key: YOUR_KEY" "https://api.xshot.fun/twitter/user/info?username=elonmusk"

curl -H "Authorization: Bearer YOUR_KEY" "https://api.xshot.fun/twitter/user/info?username=elonmusk"

Your First Request

Get a user’s profile:

curl "https://api.xshot.fun/twitter/user/info?username=elonmusk&api_key=YOUR_KEY"

Response:

{
  "id": "44196397",
  "name": "Elon Musk",
  "username": "elonmusk",
  "description": "https://t.co/dDtDyVssfm",
  "location": "",
  "created_at": "Tue Jun 02 20:12:29 +0000 2009",
  "followers_count": 237614000,
  "following_count": 1305,
  "tweet_count": 100238,
  "like_count": 220003,
  "media_count": 4417,
  "verified": false,
  "is_blue_verified": true,
  "profile_image": "https://pbs.twimg.com/profile_images/.../normal.jpg",
  "profile_banner": "https://pbs.twimg.com/profile_banners/44196397/...",
  "pinned_tweet_ids": []
}

Get a Tweet

curl "https://api.xshot.fun/twitter/tweet/detail?tweet_id=2035548674483273831&api_key=YOUR_KEY"

Response:

{
  "id": "2035548674483273831",
  "text": "https://t.co/ryFUQ3d6lz",
  "created_at": "Sun Mar 22 02:46:37 +0000 2026",
  "author": {
    "id": "1762266425589149696",
    "name": "daumen",
    "username": "daumenxyz",
    "profile_image": "https://pbs.twimg.com/profile_images/.../normal.jpg",
    "verified": false,
    "followers_count": 121896
  },
  "retweet_count": 68,
  "reply_count": 63,
  "like_count": 326,
  "quote_count": 8,
  "bookmark_count": 27,
  "view_count": 40851,
  "media": [
    {
      "type": "photo",
      "url": "https://pbs.twimg.com/media/HMPheUTbsAAGZg_.png",
      "expanded_url": "https://x.com/i/status/2035548674483273831/photo/1"
    }
  ],
  "card": {
    "url": "https://t.co/JjShdXr8Ea",
    "title": "…Adelita Grijalva Vows to Investigate America 250…",
    "description": "…",
    "image": "https://pbs.twimg.com/card_img/…?name=800x419",
    "domain": "www.thegatewaypundit.com"
  },
  "article": null,
  "entities": {
    "mentions": [{ "username": "ansem", "name": "Ansem", "id": "..." }],
    "hashtags": [],
    "cashtags": ["SOL"],
    "urls": [{ "url": "https://example.com/full", "display_url": "example.com/full" }]
  },
  "quoted_tweet": null,
  "retweeted_tweet": null
}

All of the following are always-on — no query param needed:

text — the complete post text. Long “note tweets” return the full body (not truncated at ~140 chars); for retweets it is rebuilt as RT @user: <full original text>.
media — photos/videos/GIFs (type: photo | video | animated_gif). For video/GIF, url is the thumbnail and video_url holds the highest-bitrate mp4; [] when there’s no media.
card — link/summary preview (url, title, description, image, domain) or null. The title often carries the key info for link-only posts.
article — X long-form article { title, text } or null.
entities — parsed mentions[], hashtags[], cashtags[] (raw symbols), and expanded urls[].
quoted_tweet / retweeted_tweet — the embedded quoted / original tweet (same shape, one level deep) or null.

All text is returned as correct UTF-8.

Pagination

List endpoints return paginated results. Pass cursor from the previous response to get the next page:

curl "https://api.xshot.fun/twitter/user/followers?username=daumenxyz&cursor=DAACCgABF3...&api_key=YOUR_KEY"

Response structure:

{
  "followers": [...],
  "next_cursor": "DAACCgABF3...",
  "has_next_page": true
}

When has_next_page is false or next_cursor is null, there are no more pages.

Error Responses

Status	Meaning	Example
400	Missing required parameter	`{"error": "username required"}`
401	Invalid or missing API key	`{"error": "Invalid or missing API key"}`
404	Resource not found	`{"error": "User 'xyz' not found"}`
500	Internal server error	`{"error": "Twitter API error 500: ..."}`
503	All accounts temporarily unavailable	`{"error": "All accounts are locked or unavailable"}`

Quick Start

Base URL

Authentication

Your First Request

Get a Tweet

Error Responses

Next Steps

REST API Reference

WebSocket Guide

​Base URL

​Authentication

​Your First Request

​Get a Tweet

​Pagination

​Error Responses

​Next Steps

REST API Reference

WebSocket Guide

Base URL

Authentication

Your First Request

Get a Tweet

Pagination

Error Responses

Next Steps