# Socify API — YouTube endpoints
# Base URL: https://trysocify.com
# API host: https://api.trysocify.com
# Auth: Authorization: Bearer <SOCIFY_KEY>
# Full catalog: https://trysocify.com/llms-endpoints.txt | JSON: https://trysocify.com/llms.json
# Agents map: https://trysocify.com/agents.txt | Index: https://trysocify.com/llms.txt
# Docs hub: https://trysocify.com/docs/api/youtube | OpenAPI: https://trysocify.com/openapi.json

7 documented YouTube operations. Public channels, videos, Shorts, and comments.
Do not invent paths — only the routes below (and their linked markdown pages) are supported.

## GET /api/v1/youtube/channel
Channel
Fetch public channel details by username or browse id: description, links, and metadata.
Credit cost: 2 credits per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/youtube/channel.md
HTML: https://trysocify.com/docs/api/youtube/channel
SEO: https://trysocify.com/youtube/channel
Parameters:
- username (optional, string) - Channel handle without @. Example: `MrBeast`.
- browse_id (optional, string) - Channel id (UC…). Example: `UCX6OQ3DkcsbYNE6H8uQQuVA`.
curl:
curl -sS "https://trysocify.com/api/v1/youtube/channel?username=MrBeast&browse_id=UCX6OQ3DkcsbYNE6H8uQQuVA" \
  -H "Authorization: Bearer $SOCIFY_KEY"

## GET /api/v1/youtube/videos
Channel Videos
Fetch recent uploads for a channel.
Credit cost: 3 credits per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/youtube/videos.md
HTML: https://trysocify.com/docs/api/youtube/videos
SEO: https://trysocify.com/youtube/videos
Parameters:
- browse_id (required, string) - Channel id (UC…). From User Info or a channel URL. Example: `UCX6OQ3DkcsbYNE6H8uQQuVA`.
- depth (optional, string) - Pages to fetch. Defaults to 1. Example: `1`.
curl:
curl -sS "https://trysocify.com/api/v1/youtube/videos?browse_id=UCX6OQ3DkcsbYNE6H8uQQuVA&depth=1" \
  -H "Authorization: Bearer $SOCIFY_KEY"

## GET /api/v1/youtube/shorts
Channel Shorts
Fetch Shorts for a channel.
Credit cost: 6 credits per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/youtube/shorts.md
HTML: https://trysocify.com/docs/api/youtube/shorts
SEO: https://trysocify.com/youtube/shorts
Parameters:
- browse_id (required, string) - Channel id (UC…). From User Info or a channel URL. Example: `UCX6OQ3DkcsbYNE6H8uQQuVA`.
- depth (optional, string) - Pages to fetch. Defaults to 1. Example: `1`.
curl:
curl -sS "https://trysocify.com/api/v1/youtube/shorts?browse_id=UCX6OQ3DkcsbYNE6H8uQQuVA&depth=1" \
  -H "Authorization: Bearer $SOCIFY_KEY"

## GET /api/v1/youtube/subscribers
YouTube Subscriber Count
Fetch the public subscriber count string for a channel id.
Credit cost: 1 credit per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/youtube/subscribers.md
HTML: https://trysocify.com/docs/api/youtube/subscribers
SEO: https://trysocify.com/youtube/subscribers
Parameters:
- browse_id (required, string) - Channel id (UC…). From User Info or a channel URL. Example: `UCX6OQ3DkcsbYNE6H8uQQuVA`.
curl:
curl -sS "https://trysocify.com/api/v1/youtube/subscribers?browse_id=UCX6OQ3DkcsbYNE6H8uQQuVA" \
  -H "Authorization: Bearer $SOCIFY_KEY"

## GET /api/v1/youtube/video
YouTube Video Info
Fetch public stats for a video or Short by id.
Credit cost: 1 credit per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/youtube/video.md
HTML: https://trysocify.com/docs/api/youtube/video
SEO: https://trysocify.com/youtube/video
Parameters:
- id (required, string) - YouTube video or Short id. Example: `9lhtFHpNfms`.
curl:
curl -sS "https://trysocify.com/api/v1/youtube/video?id=9lhtFHpNfms" \
  -H "Authorization: Bearer $SOCIFY_KEY"

## GET /api/v1/youtube/comments
YouTube Video Comments
Fetch a page of public comments for a video or Short.
Credit cost: 2 credits per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/youtube/comments.md
HTML: https://trysocify.com/docs/api/youtube/comments
SEO: https://trysocify.com/youtube/comments
Parameters:
- id (required, string) - YouTube video or Short id. Example: `9lhtFHpNfms`.
- cursor (optional, string) - Pagination cursor from a previous nextCursor.
curl:
curl -sS "https://trysocify.com/api/v1/youtube/comments?id=9lhtFHpNfms" \
  -H "Authorization: Bearer $SOCIFY_KEY"

## GET /api/v1/youtube/search
YouTube Search
Search public YouTube videos by keyword.
Credit cost: 1 credit per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/youtube/search.md
HTML: https://trysocify.com/docs/api/youtube/search
SEO: https://trysocify.com/youtube/search
Parameters:
- keyword (required, string) - Search text. Example: `magic`.
- depth (optional, string) - Pages to fetch. Defaults to 1. Example: `1`.
curl:
curl -sS "https://trysocify.com/api/v1/youtube/search?keyword=magic&depth=1" \
  -H "Authorization: Bearer $SOCIFY_KEY"