X logo

X / Twitter Scraping API

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

Use Cases

How teams use this API to build powerful applications

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 API

POST /v1/x/search

X search

Search X posts inside a managed signed-in session. Supports top, latest, people, media, and lists tabs. Requires a managed x.com login on kernel. If no saved login is available, the API returns HTTP 428 with hosted_url.

Parameters

query string required Keyword or phrase to search on X.
tab string Search tab to scrape: top, latest, people, media, or lists. Defaults to top.
max_tweets integer Maximum number of tweets to collect (1–500). Defaults to 100.
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

profile_url string X profile URL, for example https://x.com/jack. Provide one of profile_url or username.
username string X username without the leading @. Provide one of profile_url or username.
max_tweets integer Maximum number of tweets to collect from the profile timeline (1–500). Defaults to 100.
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

timeline_type string Which signed-in home timeline to scrape: following or for_you. Defaults to following.
max_tweets integer Maximum number of tweets to collect (1–500). Defaults to 100.

Features

What makes this API powerful and reliable

Search X with support for top, latest, people, media, and lists tabs
Collect up to 500 tweets per request with configurable max_tweets
Scrape public profile timelines by URL or username
Fetch the signed-in home timeline (following or for_you)
Structured JSON output with engagement metrics per tweet
Managed x.com authentication — no credentials to manage

Frequently Asked Questions

Common questions about the X API

Do I need my own X account or API key?

No. Browsable uses managed authentication to run requests inside a signed-in X session. You do not need to provide credentials or apply for API access.

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?

Each endpoint accepts a max_tweets parameter between 1 and 500. Defaults to 100.

Can I use /twitter/ instead of /x/ in the path?

Yes. /v1/twitter/search, /v1/twitter/profile, and /v1/twitter/timeline are accepted aliases and behave identically to the /x/ paths.

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.

The X API is live!

Start extracting X data in seconds. Try it now in our interactive playground or get your API key and integrate it into your application.

Free tier available • No credit card required • Start in under 60 seconds

Instant Setup

Start making API calls in under a minute

Reliable & Fast

99.9% uptime with sub-second response times

Transparent Pricing

Pay only for what you use, no hidden fees