# Socify

> Unified social media scraping API. Nine platforms, one Bearer key. REST JSON lookups for public social data: built for apps and agents.

Base URL: https://trysocify.com
Auth: Authorization: Bearer <SOCIFY_KEY>
Pattern: GET /api/v1/:platform/:resource?param=value
Response envelope: ok, platform, resource, data, meta (credits + latency)
Quota: monthly credits (free: 100/mo). No request RPM limit. HTTP 402 = insufficient credits.

MCP (Streamable HTTP): https://api.trysocify.com/mcp
Also proxied at: https://trysocify.com/mcp
OpenAPI: https://trysocify.com/openapi.json

**Recommended reading order:**
1. This file (`/llms.txt`)
2. [`/agents.txt`](https://trysocify.com/agents.txt) — agent onboarding, auth rules, crawl allowlist
3. [`/llms-endpoints.txt`](https://trysocify.com/llms-endpoints.txt) — every operation with markdown links, or `/llms-{platform}.txt` when you already know the platform
4. The linked `.md` page for the specific route
5. [`/docs/quickstart.md`](https://trysocify.com/docs/quickstart.md) — first request
6. [`/openapi.json`](https://trysocify.com/openapi.json) — schemas for codegen only

Create a key at https://trysocify.com/dashboard/keys (free plan: 100 credits / month).
Do not scrape HTML — use REST, OpenAPI, or MCP. Never invent endpoint paths.

## Docs

- [Introduction](https://trysocify.com/docs): Product overview and platform list
- [Introduction (Markdown)](https://trysocify.com/docs.md): LLM-friendly mirror
- [Authentication](https://trysocify.com/docs/authentication.md): API keys and Bearer auth
- [Quickstart](https://trysocify.com/docs/quickstart.md): First request in five steps
- [Response format](https://trysocify.com/docs/response.md): JSON envelope and meta fields
- [Errors](https://trysocify.com/docs/errors.md): HTTP status codes and error bodies
- [Credits](https://trysocify.com/docs/credits.md): Pricing and credit usage
- [Changelog](https://trysocify.com/docs/changelog.md): Product updates and releases
- [API reference](https://trysocify.com/docs/api.md): Endpoints by platform
- [Skill package](https://trysocify.com/skills/socify-api/SKILL.md): Reusable agent instructions

## Platforms (parameters + curls)

Each file lists every operation for that platform with query params, credits, and example curls:

- [Instagram](https://trysocify.com/llms-instagram.txt) — also [docs](https://trysocify.com/docs/api/instagram.md)
- [TikTok](https://trysocify.com/llms-tiktok.txt) — also [docs](https://trysocify.com/docs/api/tiktok.md)
- [YouTube](https://trysocify.com/llms-youtube.txt) — also [docs](https://trysocify.com/docs/api/youtube.md)
- [Threads](https://trysocify.com/llms-threads.txt) — also [docs](https://trysocify.com/docs/api/threads.md)
- [Reddit](https://trysocify.com/llms-reddit.txt) — also [docs](https://trysocify.com/docs/api/reddit.md)
- [LinkedIn](https://trysocify.com/llms-linkedin.txt) — also [docs](https://trysocify.com/docs/api/linkedin.md)
- [Twitch](https://trysocify.com/llms-twitch.txt) — also [docs](https://trysocify.com/docs/api/twitch.md)
- [X (Twitter)](https://trysocify.com/llms-twitter.txt) — also [docs](https://trysocify.com/docs/api/twitter.md)
- [Snapchat](https://trysocify.com/llms-snapchat.txt) — also [docs](https://trysocify.com/docs/api/snapchat.md)

## Catalogs

- [llms-endpoints.txt](https://trysocify.com/llms-endpoints.txt): Flat list of all operations
- [catalog.json](https://trysocify.com/catalog.json): Live endpoint inventory (no auth; preferred over /api/v1/catalog for crawlers)
- [llms-full.txt](https://trysocify.com/llms-full.txt): Expanded agent reference
- [llms.json](https://trysocify.com/llms.json): Structured inventory

## Example

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

## Optional

- [Pricing](https://trysocify.com/pricing)
- [Status](https://trysocify.com/status)
- [agents.txt](https://trysocify.com/agents.txt): Agent capability announcement + instructions
- [agents.json](https://trysocify.com/agents.json): Structured capabilities
- [AI catalog](https://trysocify.com/.well-known/ai-catalog.json): MCP + OpenAPI discovery
- [API catalog](https://trysocify.com/.well-known/api-catalog): RFC 9727 linkset