---
title: "Twitter (X) API: real-time structured data | Scrape.ly"
description: "Scrape public posts from X (Twitter) profiles and tweet URLs: text, timestamps, likes, reposts, replies, views, media, and author details."
url: https://scrape.ly/api/twitter-x-api
markdown: https://scrape.ly/api/twitter-x-api.md
---

G2

4.7/5

[Excellent](https://www.trustpilot.com/review/scrape.ly)

[Trustpilot](https://www.trustpilot.com/review/scrape.ly)

# Turn X (Twitter) into structured data

Scrape public posts from X (Twitter) profiles and tweet URLs: text, timestamps, likes, reposts, replies, views, media, and author details.

[Try Twitter (X) API](https://scrape.ly/store/echofield/tweet-scraper.md)

01 Integration

## Integrate X (Twitter) API your way

Connect to Scrape.ly using Python, JavaScript, HTTP, cURL, OpenAPI, or MCP and start extracting X (Twitter) data in minutes.

from scrapely_client import ScrapelyClient

client = ScrapelyClient ( 'YOUR_TOKEN' , api_url = 'https\://api.scrape.ly' )

run = client. actor ( 'echofield/tweet-scraper' ) . call (

run_input = {

'twitterHandles' : \[ 'NASA' ] ,

'maxItems' : 20 ,

'sort' : 'Latest' ,

}

)

for item in client. dataset ( run.default_dataset_id ) . iterate_items () :

print ( item )

02 Input & Output

## Send a handle, get structured posts

Pass handles, tweet URLs, and result limits into Scrape.ly. Get structured outputs with post text, timestamps, likes, reposts, replies, and quotes, bookmarks, and media and author details, and more.

Input

1 2 3 4 5 6 7

```
{
 "twitterHandles":[
  "NASA"
 ],
 "maxItems":20,
 "sort":"Latest"
}
```

Output

1 2 3 4 5 6 7 8 9 10 11

```
{
 "id":"2111148671219753420",
 "text":"RT @NASASpox: There was plenty to see across @NASA this week 🚀\n \n🔴 Perseverance breaks a record on Mars\n🛰️ Fresh cargo arrives at the ISS\n🌌…",
 "createdAt":"Fri Oct 16 17:34:01 +0000 2026",
 "likeCount":0,
 "retweetCount":65,
 "replyCount":0,
 "quoteCount":0,
 "isRetweet":true,
 "url":"https://x.com/NASA/status/2111148671219753420"
}
```

03 How it works

## Start extracting X (Twitter) data in four simple steps

Scrape.ly keeps the setup simple so you can move from signup to live X (Twitter) data without wasting time on scraping infrastructure.

[Get started for free](https://my.scrape.ly/register)

Step 1

### Create your Scrape.ly account

Create your account and get access to ready-made APIs, scrapers, and automation tools.

Step 2

### Get your Scrape.ly API token

Copy your API token from the Scrape.ly dashboard and use it to authenticate your requests.

Step 3

### Connect Twitter (X) API

Choose Python, JavaScript, HTTP, or MCP and connect Scrape.ly to your app or workflow.

Step 4

### Fetch X (Twitter) data

Send your handles, tweet URLs, and result limits, then receive clean structured data ready for analysis.

04 Why Scrape.ly

## Everything you need to extract data reliably

Scrape.ly gives you ready-made APIs, proxy support, monitoring, exports, integrations, and scalable infrastructure in one platform.

### Never Get Blocked

Use built-in proxy support to reduce blocks, rate limits, and failed requests.

### Export Any Format

Get results in JSON, CSV, Excel, XML, HTML table, RSS, or other workflow-friendly formats.

### Monitor Every Run

Track scraper status, performance, failures, retries, and outputs from one dashboard.

### Built-In Integrations

Connect with webhooks, APIs, automation tools, cloud apps, and internal systems.

### Scalable Infrastructure

Run small tests or high-volume extraction jobs without rebuilding your scraping stack.

### Developer-Friendly

Use clean APIs, SDKs, docs, examples, and structured outputs built for real workflows.

05 AI-Ready Data

## Feed X (Twitter) data into your tools instantly

Connect Scrape.ly with your apps, dashboards, sheets, agents, and automation workflows to turn X (Twitter) data into action.

[Browse integrations](https://scrape.ly/integrations.md) [API Reference](https://scrape.ly/docs/api-overview.md)

![AI-ready data workflow illustration](https://scrape.ly/assets/pages/api/ai-ready-data/ai-ready.svg)

06 Explore APIs

## More X (Twitter) APIs on Scrape.ly

Browse ready-made X (Twitter) scrapers and APIs available inside Scrape.ly and choose the one that fits your workflow.

![Tweet Scraper logo](https://scrape.ly/cdn-cgi/image/width=132,fit=scale-down,format=auto/https://api.scrape.ly/v2/actors/db236ad041a24e7cb/picture.webp?v=dcc89a415a7965b3628cc4fcfa7d40da)

### [Tweet Scraper](https://scrape.ly/store/echofield/tweet-scraper.md)

scrape.ly/store/echofield/tweet-scraper

---

[Echofield](https://scrape.ly/users/echofield.md "Developed by Echofield")

Social media News

---

909 monthly users

[Try for free](https://my.scrape.ly/store/echofield~tweet-scraper?intent=signup)

### Check other related APIs

[View all](https://scrape.ly/api.md)

[Threads API](https://scrape.ly/api/threads-api.md)

[Reddit API](https://scrape.ly/api/reddit-api.md)

[YouTube API](https://scrape.ly/api/youtube-api.md)

[Pinterest API](https://scrape.ly/api/pinterest-api.md)

[Instagram API](https://scrape.ly/api/instagram-api.md)

[TikTok API](https://scrape.ly/api/tiktok-api.md)

07 FAQ

## Common questions about X (Twitter) API

Quick answers about using Scrape.ly's X (Twitter) API, available data, setup, and legal usage.

Got more questions? [Reach out to us](mailto:hello@scrape.ly?subject=X%20%28Twitter%29%20API%20question\&body=I%20have%20a%20question%20about%20the%20X%20%28Twitter%29%20API.)

### How is this different from an official X (Twitter) API?

---

Official APIs, where they exist, usually need approval, keys, or paid tiers and limit which public data you can pull. Scrape.ly's Twitter (X) API collects the public data shown on X (Twitter) and returns it as structured JSON, with no approval process.

### Can I try the Twitter (X) API for free?

### What data can I get from the Twitter (X) API?

### Is it legal to scrape X (Twitter) data?

### How do I get started with the Twitter (X) API?

G2

4.7/5

[Excellent](https://www.trustpilot.com/review/scrape.ly)

[Trustpilot](https://www.trustpilot.com/review/scrape.ly)

## The internet is full of data. Start owning yours.

Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes.

[Get Started Free](https://my.scrape.ly/register) [Chat with Support](mailto:hello@scrape.ly?subject=Question%20about%20Scrape.ly\&body=Hi%2C%20I%20have%20a%20question%20about%20Scrape.ly.)

No credit card. No setup calls.