X / Twitter Scraper logo

X / Twitter Scraper API

Extract X search results, profile tweets, and home timeline posts as structured JSON using a managed signed-in session.

Use Cases

Social Listening & Brand Monitoring

Search X for keywords, hashtags, or mentions and collect structured tweet data including engagement metrics, usernames, and timestamps.

Competitor & Influencer Research

Pull a public profile's recent tweets to track what accounts are posting, how often, and how their audience responds.

Trend & Sentiment Analysis

Use the search endpoint across top and latest tabs to capture the spread of a topic and feed results into NLP or sentiment pipelines.

Home Timeline Aggregation

Fetch the following or for_you home timeline to build personal feed archives, test algorithm differences, or monitor curated content.

API Endpoints

Available endpoints for the X / Twitter Scraper API

POST /v1/x/lists

X Lists API

Scrape a public X or Twitter list page. Requires a managed x.com login on kernel. If no saved login is available, the API returns HTTP 428 with hosted_url.

Parameters

url string required URL returned by the matching search endpoint.
POST /v1/x/profile

X profile

Fetch tweets from an X profile inside a managed signed-in session. Requires a managed x.com login on kernel. If no saved login is available, the API returns HTTP 428 with hosted_url.

Parameters

limit integer Maximum number of tweets to collect from the profile timeline. Preferred name; max_tweets remains supported.
max_tweets integer Maximum number of tweets to collect from the profile timeline. You can also use limit.
profile_url string X profile URL, for example https://x.com/jack. You can also use url.
url string X profile URL, for example https://x.com/jack. Preferred name; profile_url remains supported.
username string X username without the leading @.
POST /v1/x/search

X search

Search X posts inside a managed signed-in session. Requires a managed x.com login on kernel. If no saved login is available, the API returns HTTP 428 with hosted_url.

Parameters

limit integer Maximum number of tweets to collect from the current search surface. Preferred name; max_tweets remains supported.
max_tweets integer Maximum number of tweets to collect from the current search surface. You can also use limit.
query string required Keyword or phrase to search on X.
tab string Search tab to scrape.
POST /v1/x/timeline

X timeline

Fetch tweets from the signed-in X home timeline using managed auth. Requires a managed x.com login on kernel. If no saved login is available, the API returns HTTP 428 with hosted_url.

Parameters

limit integer Maximum number of tweets to collect from the requested home timeline. Preferred name; max_tweets remains supported.
max_tweets integer Maximum number of tweets to collect from the requested home timeline. You can also use limit.
timeline_type string Which signed-in home timeline to scrape.
POST /v1/x/trends

X Trends API

Scrape public X explore trends. Requires a managed x.com login on kernel. If no saved login is available, the API returns HTTP 428 with hosted_url.

Parameters

limit integer Maximum number of results to return.
query string Search query.

Frequently Asked Questions

Common questions about the X / Twitter Scraper API

Do I need an X account?

These endpoints require a connected X account. Use your Browsable API key and complete the sign-in flow when prompted. Access is limited to content available to that account.

Which search tabs does the search endpoint support?

The search endpoint supports the top, latest, people, media, and lists tabs. Defaults to top.

How many tweets can I collect per request?

Search, profile and timeline accept max_tweets from 1 to 500, defaulting to 100. Trends uses its own limit parameter; list lookup has a separate contract.

What does the profile endpoint return?

It returns structured profile metadata plus an array of recent tweets from the profile timeline, each with text, engagement counts, and a direct link.

Start scraping X / Twitter

Get your free API key