# SocialCrawl API — twitter endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/twitter

## GET /v1/twitter/profile
Get Twitter user profile
Credit cost: 1 (standard)
Parameters:
- handle (required) — Twitter username without the @ symbol
curl "https://www.socialcrawl.dev/v1/twitter/profile?handle=elonmusk" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/twitter/user/tweets
List Twitter user tweets
Credit cost: 1 (standard)
Parameters:
- handle (required) — Twitter username without the @ symbol
- trim (optional, boolean) — Set to true for a trimmed down version of the response
curl "https://www.socialcrawl.dev/v1/twitter/user/tweets?handle=elonmusk" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/twitter/tweet
Get Twitter tweet details
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the tweet
- trim (optional, boolean) — Set to true for a trimmed down version of the response
curl "https://www.socialcrawl.dev/v1/twitter/tweet?url=https://x.com/elonmusk/status/1234567890" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/twitter/community
Get Twitter community details
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the Twitter/X community
curl "https://www.socialcrawl.dev/v1/twitter/community?url=https://x.com/i/communities/1234567890" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/twitter/community/tweets
List Twitter community tweets
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the Twitter/X community
curl "https://www.socialcrawl.dev/v1/twitter/community/tweets?url=https://x.com/i/communities/1234567890" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/twitter/tweet/transcript
Get Twitter video transcript
Credit cost: 10 (premium)
Parameters:
- url (required) — Full URL of the tweet containing a video
curl "https://www.socialcrawl.dev/v1/twitter/tweet/transcript?url=https://x.com/elonmusk/status/1234567890" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/twitter/ai-search
AI-powered X (Twitter) search via xAI Grok
Credit cost: 1 (standard)
Parameters:
- query (required) — Natural-language prompt describing what you want to learn from X. The model autonomously searches X using the x_search tool with any handle / date filters you provide.
- from_handles (optional, string) — Comma-separated X handles (max 10). Restricts the search to posts from these accounts only. Mutually exclusive with exclude_handles.
- exclude_handles (optional, string) — Comma-separated X handles (max 10) to exclude from search results. Mutually exclusive with from_handles.
- from_date (optional, string) — ISO 8601 start date (YYYY-MM-DD). Limits the search window to posts on or after this date.
- to_date (optional, string) — ISO 8601 end date (YYYY-MM-DD). Limits the search window to posts on or before this date.
curl "https://www.socialcrawl.dev/v1/twitter/ai-search?query=What is @elonmusk saying about xAI this week?" \
  -H "x-api-key: sc_your_api_key_here"