# agents.txt
# Standard: https://agents-txt.com
# Site: https://trysocify.com
# Docs index for LLMs: https://trysocify.com/llms.txt
# JSON: https://trysocify.com/agents.json
# Last updated: 2026-10-24

# Socify — AI agent and crawler access file
# Unified social scraping API: public social data as JSON. Prefer REST, OpenAPI, or MCP over HTML scraping.

Authorization: x-api-key
Identity: required

MCP: https://api.trysocify.com/mcp
MCP: https://trysocify.com/mcp

Skills: https://trysocify.com/skills/socify-api/SKILL.md

## What Socify is
Socify is a hosted social media scraping API over synchronous REST: structured public social data as JSON.
One Bearer API key (Authorization: Bearer sk_live_...), one { ok, platform, resource, data, meta } response envelope, 51 documented operations across 9 platforms: Instagram, TikTok, YouTube, Threads, Reddit, LinkedIn, Twitch, X (twitter), Snapchat.
Hosted MCP: https://api.trysocify.com/mcp (also https://trysocify.com/mcp) — Auth: Authorization Bearer API key.
Docs: https://trysocify.com/docs · Pricing: https://trysocify.com/pricing · Credits: https://trysocify.com/docs/credits.md
Platform hubs: https://trysocify.com/platforms.

## Key capabilities for agents
- Fetch profiles, posts, comments, search, and engagement as JSON (no DIY scraper fleet)
- Unified envelope and consistent meta (credits_charged, latency_ms) across platforms
- Hosted MCP with list_endpoints, lookup, and one tool per catalog endpoint
- Agent Skill: https://trysocify.com/skills/socify-api/SKILL.md
- 100 free credits on signup (monthly)

## Instructions
- Authenticate every /api/v1/{platform}/{resource} request with Authorization: Bearer <SOCIFY_KEY>. Never put the key in the URL or query string.
- Never invent endpoint paths. Start with https://trysocify.com/llms.txt, pick a platform file under /llms-{platform}.txt, or use https://trysocify.com/llms-endpoints.txt for the full list with markdown doc links.
- Prefer the linked per-route .md docs page over parsing OpenAPI for routine integration work.
- Docs and many pages have markdown twins: append .md (for example /docs/authentication.md) or open the link from llms.txt.
- On HTTP 401, fix the API key. On HTTP 402, insufficient credits — top up at https://trysocify.com/pricing (Stripe Checkout). Not x402/MPP machine payments.
- Metered routes bill on successful lookup. Plan batch jobs against the credits guide.
- For AI IDE tool calling, prefer MCP. For server-side pipelines, prefer REST with an API key.
- Do not scrape HTML on trysocify.com or social platforms when the API covers the need.

## Endpoint categories (platform files)
Counts from the live catalog. Each file lists parameters, credits, and example curls:
- Instagram (15): https://trysocify.com/llms-instagram.txt
- TikTok (12): https://trysocify.com/llms-tiktok.txt
- YouTube (7): https://trysocify.com/llms-youtube.txt
- Threads (4): https://trysocify.com/llms-threads.txt
- Reddit (3): https://trysocify.com/llms-reddit.txt
- LinkedIn (4): https://trysocify.com/llms-linkedin.txt
- Twitch (2): https://trysocify.com/llms-twitch.txt
- X (3): https://trysocify.com/llms-twitter.txt
- Snapchat (1): https://trysocify.com/llms-snapchat.txt

Full flat catalog: https://trysocify.com/llms-endpoints.txt
Live endpoint inventory (no auth): https://trysocify.com/catalog.json
Structured JSON: https://trysocify.com/llms.json
OpenAPI: https://trysocify.com/openapi.json

## Authentication
REST / MCP: Authorization: Bearer <SOCIFY_KEY> required on lookups.
Create a key: https://trysocify.com/dashboard/keys (100 free credits / month).
Auth docs: https://trysocify.com/docs/authentication.md
Agent configuration: https://trysocify.com/.well-known/agent-configuration

## Base URL
https://trysocify.com
API host (MCP / Railway): https://api.trysocify.com

## Quick start
```bash
curl -sS 'https://trysocify.com/api/v1/instagram/profile?username=natgeo' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

## Documentation
- Orientation: https://trysocify.com/llms.txt
- Agents file (this page): https://trysocify.com/agents.txt
- Structured capabilities: https://trysocify.com/agents.json
- Full endpoint catalog: https://trysocify.com/llms-endpoints.txt
- Live catalog JSON: https://trysocify.com/catalog.json
- Structured inventory: https://trysocify.com/llms.json
- Quickstart: https://trysocify.com/docs/quickstart.md
- MCP: https://trysocify.com/mcp · card: https://trysocify.com/mcp/server-card
- Skill: https://trysocify.com/skills/socify-api/SKILL.md
- Errors: https://trysocify.com/docs/errors.md
- Credits: https://trysocify.com/docs/credits.md
- Pricing: https://trysocify.com/pricing
- Platforms: https://trysocify.com/platforms
- OpenAPI: https://trysocify.com/openapi.json
- AI catalog: https://trysocify.com/.well-known/ai-catalog.json

## Allowed for AI crawlers
Public marketing and docs at /, /docs, /blog, /tutorials, /tools, /pricing, /compare, /platforms, /status, /faq, /privacy, /terms are free to index and cite.
https://trysocify.com/openapi.json, https://trysocify.com/llms.txt, https://trysocify.com/llms-full.txt, https://trysocify.com/llms-endpoints.txt, https://trysocify.com/llms.json, https://trysocify.com/catalog.json, https://trysocify.com/agents.txt, https://trysocify.com/agents.json, /llms-{platform}.txt, and markdown mirrors under /docs/**/*.md are fetchable without auth.
Public catalog (no auth): https://trysocify.com/catalog.json (preferred) or https://trysocify.com/api/v1/catalog.
Do not crawl authenticated dashboard surfaces (/dashboard), private /api/* account routes, or live /api/v1/{platform}/{resource} data lookups without a Bearer key.