How do I get a user's tweets with an API?

Send a GET request to /v1/twitter/user-tweets with the handle parameter (no @ symbol). SocialCrawl returns an array of the user's recent tweets with full text, engagement counts, media attachments, and creation timestamps in a unified schema.

What fields are returned per tweet?

Each tweet includes tweet ID, full text, like count, retweet count, reply count, quote count, media attachments (images, video URLs), language, creation timestamp, and a boolean flag for whether the tweet is a retweet or quote.

Can I trim the response to save bandwidth?

Yes. Pass the optional trim=true parameter and the endpoint returns a lighter payload with just the essential fields. Useful when you only need text, IDs, and engagement counts for bulk collection jobs.

How much does this endpoint cost?

One credit per request on the standard tier. New accounts get 100 free credits with no credit card required. There's no rate limit — you pay only for what you pull, and there is no monthly minimum or subscription required.

Do I need an X API Pro subscription to read tweets?

No. SocialCrawl doesn't use the official X API, so you don't need Pro, Basic, or Enterprise access. Send your x-api-key and a handle — public tweet data comes back directly without a developer portal.

100 free credits — no credit card required

User Tweets Data API

Name: X User Tweets API
Brand: SocialCrawl
Availability: InStock

Scrape X User Tweets data with one API call. Returns a list of recent tweets posted by a Twitter/X user. Each tweet includes the full text, like count, retweet count, reply count, media attachments, and creation timestamp.

Start for free View Documentation

Try the X User Tweets API

See real data before writing a single line

GET/v1/twitter/user/tweets

Searching 28 platforms in parallel

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

TikTok Shop·

Amazon Shop·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·UUtility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

TikTok Shop·

Amazon Shop·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·UUtility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

TikTok Shop·

Amazon Shop·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·UUtility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

TikTok Shop·

Amazon Shop·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·UUtility·

Universal Search

X API

What can you do with the User Tweets API?

The User Tweets endpoint gives you structured X data with computed fields in a single request. No scraping infrastructure to build or maintain.

Example Request

GET /v1/twitter/user/tweets?handle=elonmusk

Parameters

Parameter	Required	Description
handle	Yes	Twitter username without the @ symbol
trim	No	Set to true for a trimmed down version of the response

API Details

How does the X User Tweets API work?

Send a GET request with your API key and get back clean, structured JSON. Every response follows our unified schema with computed fields.

Method

GET

Response

JSON

Why SocialCrawl

Why use SocialCrawl for X User Tweets data?

We handle the complexity of X data extraction so you can focus on building. Unified schema, AI enrichment, and zero platform logic in your code.

One schema for every platform — write your integration once
Computed fields on every response: engagement rate, reach, category, language
No scraping infrastructure to build, no proxies to manage, no rate limits to fight
Real-time data from X — no caching, no delays

Developer First

How do you scrape social media data in seconds?

The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 28 platforms covering 10B+ monthly active users.

One schema, every platform

Query 28 platforms with identical response structures. Write your integration once.

Computed fields, not just scraped

Every response includes engagement_rate, estimated_reach, content_category, and language — ready to use.

No code required

Visual Data Explorer — paste any URL, get rich result cards, sortable tables, CSV export.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()

[ .JSON ]

{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}

+ 28 platforms

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Ask AI about SocialCrawl

Ask ChatGPT Ask Perplexity Ask Gemini Ask Claude Ask Grok

Ready to scrape X User Tweets data?

Get your API key and start pulling X data in under 60 seconds.

Start for free