SocialCrawl API

Unified social + research data API. One API key, one response format, 27 platforms, 133 endpoints, plus a universal search that fans out to 12 sources in parallel. Author and Post responses are normalized through platform field maps and augmented with deterministic computed fields (engagement_rate, language, content_category, estimated_reach) under data.computed. List archetypes (PostList, CommentList, SearchResult, Audience, Analytics) pass through as { items, next_cursor?, total? } without computed fields. Add ?format=raw to bypass the transform pipeline entirely.

API Key

Resolve the API key before making any call, checking these sources in order:

1. Env var: echo "$SOCIALCRAWL_API_KEY" — if set and starts with sc_ (and is not a placeholder like sc_your_api_key_here), use it.
2. Config file: cat ~/.config/socialcrawl/api_key 2>/dev/null — if the file exists and contains a key starting with sc_, use it.
3. Ask the user: If neither source has a valid key:
   • Tell the user: "I need your SocialCrawl API key to continue. You can find it at https://socialcrawl.dev/dashboard — every account starts with 100 free credits."
   • Ask them to paste their key.
   • After receiving the key, auto-save it so they never need to paste it again:

     mkdir -p ~/.config/socialcrawl && echo "sc_xxxxx" > ~/.config/socialcrawl/api_key
     

   • Tell the user: "I've saved your key to ~/.config/socialcrawl/api_key so it will be available in future sessions."