Skip to content
All sites
Data API

X Data API

Posts, profiles, search and trends from X (formerly Twitter).

8endpointsRate Limit · TLS Fingerprint · login_wall handled for you
twitter.comGET/twitter/trendsGET/twitter/trend…GET/twitter/tweet…{ } JSON

X Data API overview

Extract tweets, profiles, search, timelines and trends from X as structured JSON. Choose an endpoint below, check its parameters, and run it in the dashboard playground.

/v1/twitter/… Open playground

Key Features

Structured JSON

Clean, normalized records for tweets, profiles, search, timelines and trends. No HTML parsing on your side.

8 endpoints

Across 3 categories, all under one base path.

Anti-bot handled

Rate Limit, TLS Fingerprint, login_wall cleared for you behind the scenes.

Fresh or cached

Serve instantly from the warm store, or force a live scrape per request.

Regions & Languages

Global coverage. Results are returned for the default locale.

Pagination

Page through results with cursor.

Quick Start

Use your dedicated Data API key. Follow this endpoint's method and parameters.

data_api.py
# Install: pip install requests
import json
import os
import requests

params = json.loads("{\"woeid\":\"1\"}")
response = requests.request(
    "GET", "https://api.capzy.ai/v1/twitter/trends",
    headers={"X-API-Key": os.environ["CAPZY_DATA_API_KEY"]},
    params=params,
    timeout=120,
)
response.raise_for_status()
print(response.json())

Per-run pricing

failed requests are free
EndpointCategoryPrice / 1k results
/v1/data/twitter/trendsTrendsTrends1 credit / run
/v1/data/twitter/trends/by-locationTrends by LocationTrends1 credit / run
/v1/data/twitter/tweets/{id}Tweet DetailTweets1 credit / run
/v1/data/twitter/tweets/by-idsTweets by IDsTweets1 credit / run
/v1/data/twitter/users/{id}/articlesUser ArticlesUsers1 credit / run
/v1/data/twitter/users/{username}/by_usernameUser by UsernameUsers1 credit / run
/v1/data/twitter/users/{id}/tweetsUser TweetsUsers1 credit / run
/v1/data/twitter/users/batch/by-usernamesBatch Users by UsernamesUsers1 credit / run