{
  "version": "2026-10-11",
  "currency": "USD",
  "credits_per_usd": 100000,
  "signup_credits": 10000,
  "signup_usd": 0.1,
  "bonus_expiry_days": 31,
  "billing_model": "Pay per result. Most read endpoints charge per item returned (tweet, user, id). Every call has a minimum of 15 credits ($0.00015), including calls that return no data.",
  "headline": {
    "empty_search_usd": 0.00015,
    "tweet_usd": 0.00015,
    "tweet_detail_usd_per_tweet": 0.00015,
    "user_profile_usd": 0.00018,
    "lowest_effective_usd_per_call": 0.0000789,
    "lowest_effective_explanation": "15 credits minimum per request, on the Business subscription (50% extra credits in the first month + 40% returned monthly over the next 12 months while subscribed): $1 buys 1.9 × 100,000 credits, so 15 credits cost $0.00015 ÷ 1.9 = $0.000079 (about $0.00008)"
  },
  "endpoints": [
    {
      "endpoint": "/twitter/tweet/advanced_search",
      "name": "Advanced tweet search",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/tweet/bulk_advanced_search",
      "name": "Bulk advanced search",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789,
      "note": "each sub-query is billed separately; a sub-query with no results costs 15 credits; a sub-query rejected by syntax pre-check is free"
    },
    {
      "endpoint": "/twitter/tweets",
      "name": "Tweet details by ID",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789,
      "note": "billed per tweet ID requested"
    },
    {
      "endpoint": "/twitter/user/last_tweets",
      "name": "User latest tweets",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/user/last_tweets/v2",
      "name": "User latest tweets v2",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/user/tweet_timeline",
      "name": "User tweet timeline",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/user/mentions",
      "name": "User mentions",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/user/articles",
      "name": "User articles list",
      "billing_unit": "article",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/tweet/replies",
      "name": "Tweet replies",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/tweet/replies/v1",
      "name": "Tweet replies v1",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/tweet/replies/v2",
      "name": "Tweet replies v2",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/tweet/quotes",
      "name": "Tweet quotes",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/tweet/thread_context",
      "name": "Tweet thread context",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/list/tweets",
      "name": "List tweets",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/list/tweets_timeline",
      "name": "List tweets timeline",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/community/tweets",
      "name": "Community tweets",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/community/get_tweets_from_all_community",
      "name": "Tweets from all communities",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/bookmarks_v2",
      "name": "Bookmarks",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/trends",
      "name": "Trends",
      "billing_unit": "trend",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "webhook:tweet_filter",
      "name": "Real-time filter rule push (webhook / WebSocket)",
      "billing_unit": "tweet",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789,
      "note": "each check that finds no new tweets costs 15 credits"
    },
    {
      "endpoint": "/twitter/user/info",
      "name": "User profile",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 18,
      "usd_list_per_unit": 0.00018,
      "usd_lowest_per_call_list": 0.00018,
      "usd_lowest_per_call_best_plan": 0.0000947,
      "note": "one user per call"
    },
    {
      "endpoint": "/twitter/user/batch_info_by_ids",
      "name": "Batch user profiles by IDs",
      "billing_unit": "user",
      "min_credits_per_call": 15,
      "credits_per_unit_tiers": [
        {
          "from": 1,
          "to": 99,
          "credits": 18
        },
        {
          "from": 100,
          "to": null,
          "credits": 1
        }
      ],
      "usd_list_per_unit": 0.00001,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789,
      "note": "1-99 users: 18 credits each; 100 or more users in one call: 1 credit each"
    },
    {
      "endpoint": "/twitter/user/search",
      "name": "User search",
      "billing_unit": "user",
      "min_credits_per_call": 15,
      "credits_per_unit": 18,
      "usd_list_per_unit": 0.00018,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/user/followers",
      "name": "User followers",
      "billing_unit": "user",
      "min_credits_per_call": 15,
      "credits_per_unit_tiers": [
        {
          "from": 1,
          "to": 99,
          "credits": 3
        },
        {
          "from": 100,
          "to": 199,
          "credits": 2
        },
        {
          "from": 200,
          "to": null,
          "credits": 1
        }
      ],
      "usd_list_per_unit": 0.00001,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789,
      "note": "price per user depends on page size"
    },
    {
      "endpoint": "/twitter/user/followings",
      "name": "User followings",
      "billing_unit": "user",
      "min_credits_per_call": 15,
      "credits_per_unit_tiers": [
        {
          "from": 1,
          "to": 99,
          "credits": 3
        },
        {
          "from": 100,
          "to": 199,
          "credits": 2
        },
        {
          "from": 200,
          "to": null,
          "credits": 1
        }
      ],
      "usd_list_per_unit": 0.00001,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789,
      "note": "price per user depends on page size"
    },
    {
      "endpoint": "/twitter/user/followers_ids",
      "name": "User follower IDs",
      "billing_unit": "id",
      "min_credits_per_call": 15,
      "credits_per_unit_tiers": [
        {
          "from": 1,
          "to": 199,
          "credits": 2
        },
        {
          "from": 200,
          "to": 3999,
          "credits": 1
        },
        {
          "from": 4000,
          "to": null,
          "credits": 0.45
        }
      ],
      "usd_list_per_unit": 0.0000045,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789,
      "note": "price per ID depends on page size"
    },
    {
      "endpoint": "/twitter/user/verifiedFollowers",
      "name": "Verified followers",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789,
      "note": "currently 15 credits per call; a per-user price of 3 credits is configured but not active"
    },
    {
      "endpoint": "/twitter/tweet/retweeters",
      "name": "Tweet retweeters",
      "billing_unit": "user",
      "min_credits_per_call": 15,
      "credits_per_unit": 15,
      "usd_list_per_unit": 0.00015,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/list/members",
      "name": "List members",
      "billing_unit": "user",
      "min_credits_per_call": 15,
      "credits_per_unit": 18,
      "usd_list_per_unit": 0.00018,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/list/followers",
      "name": "List followers",
      "billing_unit": "user",
      "min_credits_per_call": 15,
      "credits_per_unit": 18,
      "usd_list_per_unit": 0.00018,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/community/members",
      "name": "Community members",
      "billing_unit": "user",
      "min_credits_per_call": 15,
      "credits_per_unit": 18,
      "usd_list_per_unit": 0.00018,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/community/moderators",
      "name": "Community moderators",
      "billing_unit": "user",
      "min_credits_per_call": 15,
      "credits_per_unit": 18,
      "usd_list_per_unit": 0.00018,
      "usd_lowest_per_call_list": 0.00015,
      "usd_lowest_per_call_best_plan": 0.0000789
    },
    {
      "endpoint": "/twitter/user_about",
      "name": "User about",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 30,
      "usd_list_per_unit": 0.0003,
      "usd_lowest_per_call_list": 0.0003,
      "usd_lowest_per_call_best_plan": 0.0001579
    },
    {
      "endpoint": "/twitter/user/check_follow_relationship",
      "name": "Check follow relationship",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 100,
      "usd_list_per_unit": 0.001,
      "usd_lowest_per_call_list": 0.001,
      "usd_lowest_per_call_best_plan": 0.0005263
    },
    {
      "endpoint": "/twitter/community/info",
      "name": "Community info",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 20,
      "usd_list_per_unit": 0.0002,
      "usd_lowest_per_call_list": 0.0002,
      "usd_lowest_per_call_best_plan": 0.0001053
    },
    {
      "endpoint": "/twitter/spaces/detail",
      "name": "Space details",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 30,
      "usd_list_per_unit": 0.0003,
      "usd_lowest_per_call_list": 0.0003,
      "usd_lowest_per_call_best_plan": 0.0001579
    },
    {
      "endpoint": "/twitter/article",
      "name": "Article content",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 100,
      "usd_list_per_unit": 0.001,
      "usd_lowest_per_call_list": 0.001,
      "usd_lowest_per_call_best_plan": 0.0005263
    },
    {
      "endpoint": "/twitter/create_tweet_v2",
      "name": "Post tweet",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 200,
      "usd_list_per_unit": 0.002,
      "usd_lowest_per_call_list": 0.002,
      "usd_lowest_per_call_best_plan": 0.0010526
    },
    {
      "endpoint": "/twitter/like_tweet_v2",
      "name": "Like / unlike / retweet / follow / bookmark / DM and other v2 write actions",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 200,
      "usd_list_per_unit": 0.002,
      "usd_lowest_per_call_list": 0.002,
      "usd_lowest_per_call_best_plan": 0.0010526,
      "note": "same price for every *_v2 write action"
    },
    {
      "endpoint": "/twitter/upload_media_v2",
      "name": "Upload media v2",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 300,
      "usd_list_per_unit": 0.003,
      "usd_lowest_per_call_list": 0.003,
      "usd_lowest_per_call_best_plan": 0.0015789
    },
    {
      "endpoint": "/twitter/login_by_email_or_username",
      "name": "Login (v1)",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 300,
      "usd_list_per_unit": 0.003,
      "usd_lowest_per_call_list": 0.003,
      "usd_lowest_per_call_best_plan": 0.0015789
    },
    {
      "endpoint": "/twitter/user_login_v2",
      "name": "Login (v2)",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 10000,
      "usd_list_per_unit": 0.1,
      "usd_lowest_per_call_list": 0.1,
      "usd_lowest_per_call_best_plan": 0.0526316
    },
    {
      "endpoint": "/twitter/user_login_v3",
      "name": "Login (v3)",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 500,
      "usd_list_per_unit": 0.005,
      "usd_lowest_per_call_list": 0.005,
      "usd_lowest_per_call_best_plan": 0.0026316
    },
    {
      "endpoint": "/twitter/send_tweet_v3",
      "name": "v3 write actions (tweet, reply, like, retweet, follow, quote)",
      "billing_unit": "call",
      "min_credits_per_call": 15,
      "credits_per_unit": 200,
      "usd_list_per_unit": 0.002,
      "usd_lowest_per_call_list": 0.002,
      "usd_lowest_per_call_best_plan": 0.0010526
    }
  ],
  "payg_topup_bonus": [
    {
      "usd": 50,
      "bonus_pct": 0.01,
      "bonus_pct_crypto": 0.03
    },
    {
      "usd": 100,
      "bonus_pct": 0.02,
      "bonus_pct_crypto": 0.04
    },
    {
      "usd": 200,
      "bonus_pct": 0.03,
      "bonus_pct_crypto": 0.05
    },
    {
      "usd": 500,
      "bonus_pct": 0.04,
      "bonus_pct_crypto": 0.06
    },
    {
      "usd": 1000,
      "bonus_pct": 0.05,
      "bonus_pct_crypto": 0.07
    },
    {
      "usd": 2500,
      "bonus_pct": 0.07,
      "bonus_pct_crypto": 0.09
    },
    {
      "usd": 5000,
      "bonus_pct": 0.1,
      "bonus_pct_crypto": 0.12
    }
  ],
  "subscriptions": [
    {
      "tier": "starter",
      "usd_per_month": 29,
      "credits_from_fee": 2900000,
      "bonus_pct_same_month": 0.08,
      "return_pct_over_next_12_months": 0.05,
      "topup_extra_bonus_pct": 0.08
    },
    {
      "tier": "builder",
      "usd_per_month": 99,
      "credits_from_fee": 9900000,
      "bonus_pct_same_month": 0.14,
      "return_pct_over_next_12_months": 0.08,
      "topup_extra_bonus_pct": 0.14
    },
    {
      "tier": "pro",
      "usd_per_month": 199,
      "credits_from_fee": 19900000,
      "bonus_pct_same_month": 0.26,
      "return_pct_over_next_12_months": 0.15,
      "topup_extra_bonus_pct": 0.26
    },
    {
      "tier": "scale",
      "usd_per_month": 499,
      "credits_from_fee": 49900000,
      "bonus_pct_same_month": 0.4,
      "return_pct_over_next_12_months": 0.25,
      "topup_extra_bonus_pct": 0.4
    },
    {
      "tier": "business",
      "usd_per_month": 1499,
      "credits_from_fee": 149900000,
      "bonus_pct_same_month": 0.5,
      "return_pct_over_next_12_months": 0.4,
      "topup_extra_bonus_pct": 0.5
    }
  ],
  "credits_per_usd_multiplier": {
    "list": 1,
    "payg_1000": 1.05,
    "sub_starter": 1.13,
    "sub_builder": 1.22,
    "sub_pro": 1.41,
    "sub_scale": 1.65,
    "sub_business": 1.9,
    "sub_business_plus_payg_1000": 1.95
  },
  "rules": [
    "Subscription fee is converted to credits in full, plus the tier's same-month bonus.",
    "Subscribers who top up pay-as-you-go also get the tier's same-month bonus on top of the top-up bonus.",
    "Monthly return: each month, total payments of the past 12 months (subscription + top-ups) ÷ 12 × the current tier's return %, credited from the following month. Released only while the subscription is active.",
    "Bonus credits (top-up bonus, subscription bonus, monthly return, sign-up credits) expire after 31 days. Paid credits do not expire.",
    "Multipliers assume every bonus credit is used before it expires and every monthly return is received."
  ],
  "examples": [
    {
      "case": "Advanced search returns 0 tweets",
      "credits": 15,
      "usd_list": 0.00015,
      "usd_business": 0.0000789
    },
    {
      "case": "Advanced search returns 3 tweets",
      "credits": 45,
      "usd_list": 0.00045,
      "usd_business": 0.0002368
    },
    {
      "case": "Advanced search returns 20 tweets",
      "credits": 300,
      "usd_list": 0.003,
      "usd_business": 0.0015789
    },
    {
      "case": "Tweet details for 1 tweet",
      "credits": 15,
      "usd_list": 0.00015,
      "usd_business": 0.0000789
    },
    {
      "case": "User profile",
      "credits": 18,
      "usd_list": 0.00018,
      "usd_business": 0.0000947
    },
    {
      "case": "1,000 tweets via search",
      "credits": 15000,
      "usd_list": 0.15,
      "usd_business": 0.0789474
    }
  ]
}