Skip to main content

​
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"

​
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",
    "followers_count": 121896
  },
  "retweet_count": 68,
  "reply_count": 63,
  "like_count": 326,
  "quote_count": 8,
  "bookmark_count": 27,
  "view_count": 40851
}

​
Search Tweets

curl "https://api.xshot.fun/twitter/tweet/advanced_search?query=bitcoin&type=Latest&api_key=YOUR_KEY"
Response: 
{
  "tweets": [
    {
      "id": "2037850410535550990",
      "text": "Bitcoin just hit a new all time high...",
      "created_at": "Fri Mar 28 12:00:00 +0000 2026",
      "author": {
        "id": "44196397",
        "name": "Elon Musk",
        "username": "elonmusk",
        "followers_count": 237614000
      },
      "retweet_count": 1200,
      "reply_count": 450,
      "like_count": 8500,
      "quote_count": 120,
      "view_count": 2500000
    }
  ],
  "next_cursor": "DAACCgABF3...",
  "has_next_page": true
}

​
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

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

​
Next Steps

REST API Reference

Browse all 31 endpoints with interactive playground

WebSocket Guide

Set up real-time event subscriptions