# Social Fetch API - Telegram endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

3 documented Telegram operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/telegram/channels/{handle}
Get Telegram channel
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/telegram/channels/handle/get.mdx
SDK: client.telegram.getChannel({ handle: "durov" })
Parameters:
- handle (required, string) - Telegram public username (channel or group), with or without leading @.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/telegram/channels/durov" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/telegram/channels/{handle}/posts
List Telegram channel posts
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/telegram/channels/handle/posts/get.mdx
SDK: client.telegram.getChannelPosts({ handle: "durov" })
Parameters:
- handle (required, string) - Telegram public username (channel or group), with or without leading @.
- cursor (optional, string) - Opaque pagination cursor from a previous response. Omit for the first page.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/telegram/channels/durov/posts" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/telegram/channels/{handle}/posts/{postId}
Get Telegram channel post
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/telegram/channels/handle/posts/postid/get.mdx
SDK: client.telegram.getChannelPost({ handle: "Premiumoji", postId: "93" })
Parameters:
- handle (required, string) - Telegram public username (channel or group), with or without leading @.
- postId (required, string) - Numeric Telegram channel post ID from the public URL.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `restricted`
curl "https://api.socialfetch.dev/v1/telegram/channels/durov/posts/515" \
  -H "x-api-key: YOUR_API_KEY"