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

> Twitter data API: 8 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 8 endpoints, 1 to 10 credits per call, all returning one unified JSON schema with AI-enriched fields. 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 | 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 |
| Profile Full | GET | `/v1/twitter/profile/full` | 5 | X (Twitter) profile, recent posts, and computed analytics in one call. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/twitter/profile?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 44 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 8 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 AI-enriched fields like engagement_rate and estimated_reach.

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

8 endpoints, including profile (user data by handle), profile/full (extended profile detail), user/tweets (recent tweets from a user), tweet (full tweet details from a URL), community (X community metadata), community/tweets (tweets inside a community), tweet/transcript (video captions for tweets containing video), and ai-search (AI-powered X search via xAI Grok).

### How much does the Twitter API cost?

Profile, user tweets, tweet details, community, community tweets, and AI search each cost 1 credit on the standard tier. 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: 8 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