AI Agent Integration
Using SocialCrawl with AI agents and LLMs
AI Agent Integration
SocialCrawl is designed to be consumed by AI agents. Every response includes computed fields (engagement_rate, language, content_category, estimated_reach) that are ready for downstream reasoning, and the entire 357-endpoint catalogue is published as machine-readable llms.txt and OpenAPI files.
If you're using Claude Code, Cursor, Windsurf, Claude Desktop, or any other MCP-compatible client, install the Skills or MCP package for a one-line setup โ your agent gets local schema validation, zero-credit discovery tools, and direct access to every endpoint without plumbing any HTTP yourself. For a full walkthrough of the four tools and one-line install commands, see the MCP server for social media data page.
How do AI agents discover SocialCrawl?
We provide machine-readable documentation at:
- /llms.txt โ Compact overview of the API
- /llms-full.txt โ Complete self-contained reference, including the
GET /v1/credits/balancemeta endpoint, idempotency semantics,oneOfparameter constraints, and all error codes - /llms.json โ Machine-readable catalog (per-platform endpoint counts, auth, credit tiers, response envelope), generated from the live registry
- /agents.txt โ AI agent access file: capabilities, quick start, and crawl guidance in one place
Point your AI agent at /llms-full.txt for everything it needs to use the API.
How can agents use the OpenAPI specification?
The full OpenAPI 3.1 specification is available at:
- /v1/openapi.json โ JSON format
- /v1/openapi.yaml โ YAML format
What per-platform documentation is available?
Fetch only the endpoints you need โ one file per platform:
| Platform | Reference File |
|---|---|
| TikTok | /llms-tiktok.txt |
/llms-instagram.txt | |
| YouTube | /llms-youtube.txt |
/llms-facebook.txt | |
| Twitter/X | /llms-twitter.txt |
/llms-linkedin.txt | |
/llms-reddit.txt | |
| Threads | /llms-threads.txt |
/llms-pinterest.txt | |
/llms-google.txt | |
| Truth Social | /llms-truthsocial.txt |
| Twitch | /llms-twitch.txt |
| Snapchat | /llms-snapchat.txt |
| Kick | /llms-kick.txt |
| Amazon | /llms-amazon.txt |
| Linktree | /llms-linktree.txt |
| LinkBio | /llms-linkbio.txt |
| LinkMe | /llms-linkme.txt |
| Komi | /llms-komi.txt |
| Pillar | /llms-pillar.txt |
Each file contains only that platform's endpoints with parameters, descriptions, and curl examples. One file exists per supported platform; the full list is linked from /llms.txt.
How do I integrate SocialCrawl with my AI agent?
const response = await fetch(
"https://www.socialcrawl.dev/v1/tiktok/profile?handle=charlidamelio",
{ headers: { "x-api-key": process.env.SOCIALCRAWL_API_KEY } },
);
const { data } = await response.json();
// data is structured and ready for AI reasoning