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.

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

max_tweets integer Maximum number of tweets to collect from the profile timeline.
profile_url string X profile URL, for example https://x.com/jack.
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

max_tweets integer Maximum number of tweets to collect from the current search surface.
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

max_tweets integer Maximum number of tweets to collect from the requested home timeline.
timeline_type string Which signed-in home timeline to scrape.
POST /v1/x/trends

X Trends API

Scrape public X explore trends.

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 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.

Start scraping X / Twitter

Get your free API key