# SocialCrawl — AI Agent & Web Search Agent Access File
# Last updated: 2026-06-16

## What SocialCrawl Is
SocialCrawl is a unified API for social media data across 42 platforms
(27 social platforms plus research, commerce, and app-store data sources).
One API key, one response format, 264 endpoints. MCP-compatible for AI agents.

## Key Capabilities for Agents
- Fetch profiles, posts, comments, and search results from any supported platform
- Unified JSON envelope across all platforms (same response shape everywhere)
- Universal social search: GET /v1/search/everywhere fans out across 12 platforms in one call
- MCP server: npx socialcrawl-mcp (works in Claude Code, Claude Desktop, Cursor, Windsurf)
- Skills bundle: npx skills add socialcrawl/skills (Codex, Gemini CLI, and 40+ agent runtimes)
- 100 free credits on signup, no credit card required

## Endpoint Categories
Example endpoints from the live registry (full catalog: https://www.socialcrawl.dev/llms.json):
- Profiles & channels (19 endpoints): /v1/tiktok/profile, /v1/instagram/profile, /v1/youtube/channel, /v1/twitter/profile
- Posts & videos (31 endpoints): /v1/tiktok/post, /v1/tiktok/profile/videos, /v1/tiktok/song/videos, /v1/instagram/audio/reels
- Comments (8 endpoints): /v1/tiktok/post/comments, /v1/instagram/post/comments, /v1/youtube/video/comments, /v1/reddit/post/comments
- Search (25 endpoints): /v1/tiktok/search, /v1/tiktok/search/hashtag, /v1/tiktok/search/top, /v1/tiktok/search/users
- Reviews & commerce (19 endpoints): /v1/amazon/product, /v1/amazon/product-search, /v1/amazon/reviews, /v1/amazon/sellers
- Transcripts & analysis (11 endpoints): /v1/tiktok/post/transcript, /v1/tiktok/trending, /v1/instagram/media/transcript, /v1/youtube/video/transcript

## Authentication
x-api-key header required on every request.
Get a free API key: https://www.socialcrawl.dev/auth/register

## Base URL
https://www.socialcrawl.dev/v1

## Quick Start
curl "https://www.socialcrawl.dev/v1/tiktok/profile?handle=charlidamelio" \
  -H "x-api-key: sc_YOUR_API_KEY"

## Documentation
- API docs: https://www.socialcrawl.dev/docs
- AI agents guide: https://www.socialcrawl.dev/docs/ai-agents
- Machine-readable catalog: https://www.socialcrawl.dev/llms.json
- Concise overview: https://www.socialcrawl.dev/llms.txt
- Full endpoint reference: https://www.socialcrawl.dev/llms-full.txt
- OpenAPI spec: https://www.socialcrawl.dev/v1/openapi.json

## Contact
- Email: hello@socialcrawl.dev

## Allowed for AI Crawlers
All content at /, /docs, /blog, /changelog, /platforms, /pricing, /solutions, /vs, /tools
is free to index and cite. /v1/openapi.json and the /llms*.txt files are fetchable without auth.
Do not crawl /api, /v1 data endpoints, /dashboard, /auth, /admin.