# X Data API (https://www.socialcrawl.dev/platforms/twitter)

> Twitter data API: 17 endpoints for profiles, user tweets, tweet details, X communities, video transcripts, and Grok-powered AI search. Most calls cost 1 credit; transcripts are 10. Start with 100 free credits, no credit card, and no $100+/month official X API tier just to read public data.

TL;DR: SocialCrawl's X API exposes 17 endpoints, 0 to 10 credits per call, all returning one unified JSON schema with computed fields such as engagement rate, language and content category. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Profile | GET | `/v1/twitter/profile` | 1 | Get Twitter user profile |
| User Tweets | GET | `/v1/twitter/user/tweets` | 1 to 5 | List Twitter user tweets |
| Tweet | GET | `/v1/twitter/tweet` | 1 | Get Twitter tweet details |
| Community | GET | `/v1/twitter/community` | 1 | Get Twitter community details |
| Community Tweets | GET | `/v1/twitter/community/tweets` | 1 | List Twitter community tweets |
| Tweet Transcript | GET | `/v1/twitter/tweet/transcript` | 10 | Get Twitter video transcript |
| AI Search | GET | `/v1/twitter/ai-search` | 5 | AI-powered X (Twitter) search via xAI Grok |
| Search Tweets | GET | `/v1/twitter/search/tweets` | 1 to 9 | Search Twitter tweets |
| Tweet Replies | GET | `/v1/twitter/tweet/replies` | 1 to 5 | List Twitter tweet replies |
| User Media | GET | `/v1/twitter/user/media` | 1 | List Twitter user media tweets |
| User Followers | GET | `/v1/twitter/user/followers` | 1 | List Twitter user followers |
| User Following | GET | `/v1/twitter/user/following` | 1 | List Twitter user following |
| Tweet Retweeters | GET | `/v1/twitter/tweet/retweeters` | 1 | List Twitter tweet retweeters |
| Search Users | GET | `/v1/twitter/search/users` | 1 | Search Twitter users |
| Profile Full | GET | `/v1/twitter/profile/full` | 5 | X (Twitter) profile, recent posts, and computed analytics in one call. |
| Search Hashtag | GET | `/v1/twitter/search/hashtag` | 0 to 1 | Search X (Twitter) posts carrying a hashtag |
| Search Mentions | GET | `/v1/twitter/search/mentions` | 0 to 1 | Search X (Twitter) posts that mention an account |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/twitter/profile" \
  --data-urlencode "handle=elonmusk" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## SocialCrawl vs Official X API

| Feature | SocialCrawl | Official X API |
| --- | --- | --- |
| Authentication | One x-api-key header | OAuth 2.0 with developer app credentials |
| Setup / approval | Sign up and call immediately | Developer portal signup and paid tier selection |
| Rate limits | Credit-based, pay per request | Hard caps per tier; reads heavily restricted on lower tiers |
| Response schema | Unified JSON envelope shared across 69 platforms | X-specific payloads you map yourself |
| Pricing | 1 credit per request (10 for video transcripts); 100 free credits | Paid tiers required for meaningful read access |
| Data coverage | Profiles, tweets, communities, transcripts, AI search: read-only public data | Full platform access including posting, DMs, and realtime streams |
| Maintenance | Schema stays stable when X changes internals | You track API version and tier policy changes |

## FAQ

### How do I scrape Twitter and X data with an API?

Send a GET request to any of the 17 SocialCrawl Twitter endpoints with an x-api-key header. No OAuth, no developer portal review, no $200/month X API tier, just a handle or URL and a key. Responses come back in a unified schema with computed fields like engagement_rate and estimated_reach.

### What Twitter / X endpoints does SocialCrawl offer?

17 endpoints: profile (user data by handle), profile/full (profile plus recent posts plus computed analytics), user/tweets (recent tweets from a user, cursor-paged), user/media (only the tweets carrying a photo or video), tweet (full tweet details from a URL), tweet/replies (the replies to a tweet), tweet/retweeters (the accounts that retweeted it), tweet/transcript (video captions), search/tweets (keyword search with X search operators), search/users (account typeahead), user/followers and user/following (the follow graph), community and community/tweets (X communities), and ai-search (AI-powered X search via xAI Grok).

### How much does the Twitter API cost?

Most endpoints cost 1 credit on the standard tier: profile, user tweets, tweet details, tweet replies, retweeters, followers, following, user media, community, community tweets, keyword search, and user search. AI search costs 5 credits (advanced) and so does the profile/full composite. Tweet video transcripts cost 10 credits (premium). New accounts get 100 free credits, no credit card required, so you can pull around 100 requests before paying anything.

### Do I need an X Developer account or OAuth token?

No. SocialCrawl works without an X Developer account, OAuth token, Basic/Pro API subscription, or Twitter login. Pass your SocialCrawl x-api-key plus a handle or tweet URL. Public profile and tweet data comes back in a unified schema directly.

### Is scraping Twitter data legal?

SocialCrawl reads only publicly visible Twitter and X data through the same interfaces any browser uses. You are responsible for making sure your use case complies with X's terms of service and applicable data protection regulations like GDPR and CCPA. SocialCrawl operates under a documented GDPR legitimate-interest framework: public, logged-out data only, no credential use, short-lived caches (2 to 30 minutes) with no persistent store, and a public opt-out channel for anyone whose public info appears in responses. Full details: socialcrawl.dev/legal/public-data-notice.

### Can I get tweets from a specific X community?

Yes. Two dedicated endpoints wrap X communities: community returns the community name, description, member count, and rules from a community URL; community/tweets returns the recent tweets posted inside that community with engagement metrics and author info.

### What is the best Twitter scraper API?

SocialCrawl is a strong choice for read-only Twitter data: 17 endpoints covering profiles, tweets, X communities, video transcripts, and Grok-powered AI search, all behind one x-api-key. Most calls cost 1 credit, transcripts cost 10, and new accounts get 100 free credits with no credit card or X developer tier required.

### Is there a Twitter data API without the paid X tier?

Yes, SocialCrawl is a Twitter data API that reads public profiles, user tweets, tweet details, X communities, video transcripts, and Grok-powered AI search as unified JSON, with no X developer tier. The official X API is the route for posting, DMs, and realtime streams, but meaningful read access sits behind paid tiers. SocialCrawl needs only an x-api-key: most calls cost 1 credit, tweet video transcripts cost 10, and new accounts start with 100 free credits on signup.

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What is the SocialCrawl Twitter / X API?
- How to scrape Twitter data without the $200/month X API tier
- Compare SocialCrawl vs twitterapi.io for scraping tweets