# Socify — full agent reference

> Unified social media scraping API. Nine platforms, Bearer API key, credit-metered lookups. Prefer OpenAPI or MCP over HTML scraping.

Base URL: https://trysocify.com
API host: https://api.trysocify.com
Auth: Authorization: Bearer <SOCIFY_KEY>
Pattern: GET /api/v1/:platform/:resource?param=value
Quota: monthly credits (no request RPM limit). Free plan: 100 credits/month.
HTTP 402: insufficient credits — buy or upgrade at /pricing or /dashboard.
Do not scrape HTML. Use REST, OpenAPI, or MCP.

## Discovery

- [llms.txt](https://trysocify.com/llms.txt): Curated index
- [llms-endpoints.txt](https://trysocify.com/llms-endpoints.txt): Flat operation list
- [catalog.json](https://trysocify.com/catalog.json): Live endpoint inventory (no auth)
- [llms.json](https://trysocify.com/llms.json): Structured index
- [agents.txt](https://trysocify.com/agents.txt): Agent onboarding + platform map
- [agents.json](https://trysocify.com/agents.json): Structured capabilities
- [OpenAPI](https://trysocify.com/openapi.json): Formal REST contract
- [API catalog](https://trysocify.com/.well-known/api-catalog): RFC 9727 linkset
- [AI catalog](https://trysocify.com/.well-known/ai-catalog.json): MCP + OpenAPI artifacts
- [MCP server card](https://trysocify.com/mcp/server-card): SEP-2127 connection card
- [Agent configuration](https://trysocify.com/.well-known/agent-configuration): Auth discovery
- [Skill](https://trysocify.com/skills/socify-api/SKILL.md): How to call Socify

## Auth & MCP

- Create key: https://trysocify.com/dashboard/keys
- Auth docs: https://trysocify.com/docs/authentication
- MCP (Streamable HTTP): https://api.trysocify.com/mcp (also https://trysocify.com/mcp)
- MCP tools: list_endpoints, lookup, plus one tool per endpoint

## Docs

- [Introduction](https://trysocify.com/docs)
- [Authentication](https://trysocify.com/docs/authentication)
- [Quickstart](https://trysocify.com/docs/quickstart)
- [Response format](https://trysocify.com/docs/response)
- [Errors](https://trysocify.com/docs/errors)
- [Credits](https://trysocify.com/docs/credits)
- [Changelog](https://trysocify.com/docs/changelog)
- [API reference](https://trysocify.com/docs/api)

## Platform files (params + curls)

- [Instagram](https://trysocify.com/llms-instagram.txt): 15 endpoints
- [TikTok](https://trysocify.com/llms-tiktok.txt): 12 endpoints
- [YouTube](https://trysocify.com/llms-youtube.txt): 7 endpoints
- [Threads](https://trysocify.com/llms-threads.txt): 4 endpoints
- [Reddit](https://trysocify.com/llms-reddit.txt): 3 endpoints
- [LinkedIn](https://trysocify.com/llms-linkedin.txt): 4 endpoints
- [Twitch](https://trysocify.com/llms-twitch.txt): 2 endpoints
- [X](https://trysocify.com/llms-twitter.txt): 3 endpoints
- [Snapchat](https://trysocify.com/llms-snapchat.txt): 1 endpoints

## Endpoints (51 across 9 platforms)

### Instagram (`instagram`)

Platform file: https://trysocify.com/llms-instagram.txt

- [`/api/v1/instagram/profile`](https://trysocify.com/docs/api/instagram/profile.md): Docs · [SEO](https://trysocify.com/instagram/profile) · OpenAPI path `/api/v1/instagram/profile`
- [`/api/v1/instagram/posts`](https://trysocify.com/docs/api/instagram/posts.md): Docs · [SEO](https://trysocify.com/instagram/posts) · OpenAPI path `/api/v1/instagram/posts`
- [`/api/v1/instagram/comments`](https://trysocify.com/docs/api/instagram/comments.md): Docs · [SEO](https://trysocify.com/instagram/comments) · OpenAPI path `/api/v1/instagram/comments`
- [`/api/v1/instagram/reels`](https://trysocify.com/docs/api/instagram/reels.md): Docs · [SEO](https://trysocify.com/instagram/reels) · OpenAPI path `/api/v1/instagram/reels`
- [`/api/v1/instagram/hashtag`](https://trysocify.com/docs/api/instagram/hashtag.md): Docs · [SEO](https://trysocify.com/instagram/hashtag) · OpenAPI path `/api/v1/instagram/hashtag`
- [`/api/v1/instagram/hashtag-posts`](https://trysocify.com/docs/api/instagram/hashtag-posts.md): Docs · [SEO](https://trysocify.com/instagram/hashtag-posts) · OpenAPI path `/api/v1/instagram/hashtag-posts`
- [`/api/v1/instagram/followers`](https://trysocify.com/docs/api/instagram/followers.md): Docs · [SEO](https://trysocify.com/instagram/followers) · OpenAPI path `/api/v1/instagram/followers`
- [`/api/v1/instagram/following`](https://trysocify.com/docs/api/instagram/following.md): Docs · [SEO](https://trysocify.com/instagram/following) · OpenAPI path `/api/v1/instagram/following`
- [`/api/v1/instagram/post`](https://trysocify.com/docs/api/instagram/post.md): Docs · [SEO](https://trysocify.com/instagram/post) · OpenAPI path `/api/v1/instagram/post`
- [`/api/v1/instagram/stories`](https://trysocify.com/docs/api/instagram/stories.md): Docs · [SEO](https://trysocify.com/instagram/stories) · OpenAPI path `/api/v1/instagram/stories`
- [`/api/v1/instagram/highlights`](https://trysocify.com/docs/api/instagram/highlights.md): Docs · [SEO](https://trysocify.com/instagram/highlights) · OpenAPI path `/api/v1/instagram/highlights`
- [`/api/v1/instagram/tagged`](https://trysocify.com/docs/api/instagram/tagged.md): Docs · [SEO](https://trysocify.com/instagram/tagged) · OpenAPI path `/api/v1/instagram/tagged`
- [`/api/v1/instagram/search`](https://trysocify.com/docs/api/instagram/search.md): Docs · [SEO](https://trysocify.com/instagram/search) · OpenAPI path `/api/v1/instagram/search`
- [`/api/v1/instagram/likers`](https://trysocify.com/docs/api/instagram/likers.md): Docs · [SEO](https://trysocify.com/instagram/likers) · OpenAPI path `/api/v1/instagram/likers`
- [`/api/v1/instagram/related`](https://trysocify.com/docs/api/instagram/related.md): Docs · [SEO](https://trysocify.com/instagram/related) · OpenAPI path `/api/v1/instagram/related`
### TikTok (`tiktok`)

Platform file: https://trysocify.com/llms-tiktok.txt

- [`/api/v1/tiktok/profile`](https://trysocify.com/docs/api/tiktok/profile.md): Docs · [SEO](https://trysocify.com/tiktok/profile) · OpenAPI path `/api/v1/tiktok/profile`
- [`/api/v1/tiktok/videos`](https://trysocify.com/docs/api/tiktok/videos.md): Docs · [SEO](https://trysocify.com/tiktok/videos) · OpenAPI path `/api/v1/tiktok/videos`
- [`/api/v1/tiktok/comments`](https://trysocify.com/docs/api/tiktok/comments.md): Docs · [SEO](https://trysocify.com/tiktok/comments) · OpenAPI path `/api/v1/tiktok/comments`
- [`/api/v1/tiktok/hashtag`](https://trysocify.com/docs/api/tiktok/hashtag.md): Docs · [SEO](https://trysocify.com/tiktok/hashtag) · OpenAPI path `/api/v1/tiktok/hashtag`
- [`/api/v1/tiktok/hashtag-videos`](https://trysocify.com/docs/api/tiktok/hashtag-videos.md): Docs · [SEO](https://trysocify.com/tiktok/hashtag-videos) · OpenAPI path `/api/v1/tiktok/hashtag-videos`
- [`/api/v1/tiktok/search`](https://trysocify.com/docs/api/tiktok/search.md): Docs · [SEO](https://trysocify.com/tiktok/search) · OpenAPI path `/api/v1/tiktok/search`
- [`/api/v1/tiktok/followers`](https://trysocify.com/docs/api/tiktok/followers.md): Docs · [SEO](https://trysocify.com/tiktok/followers) · OpenAPI path `/api/v1/tiktok/followers`
- [`/api/v1/tiktok/following`](https://trysocify.com/docs/api/tiktok/following.md): Docs · [SEO](https://trysocify.com/tiktok/following) · OpenAPI path `/api/v1/tiktok/following`
- [`/api/v1/tiktok/video`](https://trysocify.com/docs/api/tiktok/video.md): Docs · [SEO](https://trysocify.com/tiktok/video) · OpenAPI path `/api/v1/tiktok/video`
- [`/api/v1/tiktok/liked`](https://trysocify.com/docs/api/tiktok/liked.md): Docs · [SEO](https://trysocify.com/tiktok/liked) · OpenAPI path `/api/v1/tiktok/liked`
- [`/api/v1/tiktok/playlists`](https://trysocify.com/docs/api/tiktok/playlists.md): Docs · [SEO](https://trysocify.com/tiktok/playlists) · OpenAPI path `/api/v1/tiktok/playlists`
- [`/api/v1/tiktok/replies`](https://trysocify.com/docs/api/tiktok/replies.md): Docs · [SEO](https://trysocify.com/tiktok/replies) · OpenAPI path `/api/v1/tiktok/replies`
### YouTube (`youtube`)

Platform file: https://trysocify.com/llms-youtube.txt

- [`/api/v1/youtube/channel`](https://trysocify.com/docs/api/youtube/channel.md): Docs · [SEO](https://trysocify.com/youtube/channel) · OpenAPI path `/api/v1/youtube/channel`
- [`/api/v1/youtube/videos`](https://trysocify.com/docs/api/youtube/videos.md): Docs · [SEO](https://trysocify.com/youtube/videos) · OpenAPI path `/api/v1/youtube/videos`
- [`/api/v1/youtube/shorts`](https://trysocify.com/docs/api/youtube/shorts.md): Docs · [SEO](https://trysocify.com/youtube/shorts) · OpenAPI path `/api/v1/youtube/shorts`
- [`/api/v1/youtube/subscribers`](https://trysocify.com/docs/api/youtube/subscribers.md): Docs · [SEO](https://trysocify.com/youtube/subscribers) · OpenAPI path `/api/v1/youtube/subscribers`
- [`/api/v1/youtube/video`](https://trysocify.com/docs/api/youtube/video.md): Docs · [SEO](https://trysocify.com/youtube/video) · OpenAPI path `/api/v1/youtube/video`
- [`/api/v1/youtube/comments`](https://trysocify.com/docs/api/youtube/comments.md): Docs · [SEO](https://trysocify.com/youtube/comments) · OpenAPI path `/api/v1/youtube/comments`
- [`/api/v1/youtube/search`](https://trysocify.com/docs/api/youtube/search.md): Docs · [SEO](https://trysocify.com/youtube/search) · OpenAPI path `/api/v1/youtube/search`
### Threads (`threads`)

Platform file: https://trysocify.com/llms-threads.txt

- [`/api/v1/threads/profile`](https://trysocify.com/docs/api/threads/profile.md): Docs · [SEO](https://trysocify.com/threads/profile) · OpenAPI path `/api/v1/threads/profile`
- [`/api/v1/threads/posts`](https://trysocify.com/docs/api/threads/posts.md): Docs · [SEO](https://trysocify.com/threads/posts) · OpenAPI path `/api/v1/threads/posts`
- [`/api/v1/threads/post`](https://trysocify.com/docs/api/threads/post.md): Docs · [SEO](https://trysocify.com/threads/post) · OpenAPI path `/api/v1/threads/post`
- [`/api/v1/threads/search`](https://trysocify.com/docs/api/threads/search.md): Docs · [SEO](https://trysocify.com/threads/search) · OpenAPI path `/api/v1/threads/search`
### Reddit (`reddit`)

Platform file: https://trysocify.com/llms-reddit.txt

- [`/api/v1/reddit/search`](https://trysocify.com/docs/api/reddit/search.md): Docs · [SEO](https://trysocify.com/reddit/search) · OpenAPI path `/api/v1/reddit/search`
- [`/api/v1/reddit/posts`](https://trysocify.com/docs/api/reddit/posts.md): Docs · [SEO](https://trysocify.com/reddit/posts) · OpenAPI path `/api/v1/reddit/posts`
- [`/api/v1/reddit/comments`](https://trysocify.com/docs/api/reddit/comments.md): Docs · [SEO](https://trysocify.com/reddit/comments) · OpenAPI path `/api/v1/reddit/comments`
### LinkedIn (`linkedin`)

Platform file: https://trysocify.com/llms-linkedin.txt

- [`/api/v1/linkedin/company`](https://trysocify.com/docs/api/linkedin/company.md): Docs · [SEO](https://trysocify.com/linkedin/company) · OpenAPI path `/api/v1/linkedin/company`
- [`/api/v1/linkedin/job`](https://trysocify.com/docs/api/linkedin/job.md): Docs · [SEO](https://trysocify.com/linkedin/job) · OpenAPI path `/api/v1/linkedin/job`
- [`/api/v1/linkedin/post`](https://trysocify.com/docs/api/linkedin/post.md): Docs · [SEO](https://trysocify.com/linkedin/post) · OpenAPI path `/api/v1/linkedin/post`
- [`/api/v1/linkedin/profile`](https://trysocify.com/docs/api/linkedin/profile.md): Docs · [SEO](https://trysocify.com/linkedin/profile) · OpenAPI path `/api/v1/linkedin/profile`
### Twitch (`twitch`)

Platform file: https://trysocify.com/llms-twitch.txt

- [`/api/v1/twitch/search`](https://trysocify.com/docs/api/twitch/search.md): Docs · [SEO](https://trysocify.com/twitch/search) · OpenAPI path `/api/v1/twitch/search`
- [`/api/v1/twitch/followers`](https://trysocify.com/docs/api/twitch/followers.md): Docs · [SEO](https://trysocify.com/twitch/followers) · OpenAPI path `/api/v1/twitch/followers`
### X (`twitter`)

Platform file: https://trysocify.com/llms-twitter.txt

- [`/api/v1/twitter/profile`](https://trysocify.com/docs/api/twitter/profile.md): Docs · [SEO](https://trysocify.com/twitter/profile) · OpenAPI path `/api/v1/twitter/profile`
- [`/api/v1/twitter/tweets`](https://trysocify.com/docs/api/twitter/tweets.md): Docs · [SEO](https://trysocify.com/twitter/tweets) · OpenAPI path `/api/v1/twitter/tweets`
- [`/api/v1/twitter/post`](https://trysocify.com/docs/api/twitter/post.md): Docs · [SEO](https://trysocify.com/twitter/post) · OpenAPI path `/api/v1/twitter/post`
### Snapchat (`snapchat`)

Platform file: https://trysocify.com/llms-snapchat.txt

- [`/api/v1/snapchat/profile`](https://trysocify.com/docs/api/snapchat/profile.md): Docs · [SEO](https://trysocify.com/snapchat/profile) · OpenAPI path `/api/v1/snapchat/profile`

## 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)
- [Changelog](https://trysocify.com/docs/changelog)