Telegram Media Downloader API
Resolve public Telegram channel post links into downloadable photos and videos. Each returned item costs two credits.
$ curl -X POST https://developers.getinsaver.com/v1/resolve \ -H "Authorization: Bearer $GIS_KEY" \ -H "Content-Type: application/json" \ -d '{"service":"telegram","url":"https://t.me/channel/123","max_results":10}'
{
"ok": true,
"service": "telegram",
"source_url": "https://t.me/channel/123",
"item_count": 1,
"items": [
{
"type": "video",
"url": "https://cdn.example/post.mp4"
}
],
"metadata": {
"title": null,
"author": "channel",
"caption": null
},
"request_id": "3f1c…e81a",
"credits_used": 2
}What you get
Supported links
- t.me/channel/123
Response
An items array of { type, url } with direct, short-lived media URLs, plus author metadata when available.
Billing
2 credits per returned item. Failed or empty requests are refunded in full.
FAQ
Do private groups work?
No. Private channels, groups and invite links (t.me/c/…) cannot be read. Use public post links like t.me/channel/123.
Do failed requests cost credits?
No. Credits are reserved while a request runs and refunded in full when it fails or finds no media. You only pay for items that come back.
What counts as one result?
Each media item the API returns: one video, one photo, or one carousel slide. A Reel is usually one result; a ten-photo carousel is ten. Instagram Stories, Highlights and Telegram cost 2 credits per result; every other service costs 1.
Telegram Media Downloader API: key facts
- Endpoint
- POST /v1/resolve (one endpoint for every service)
- Free trial
- 20 result credits after email verification, no card
- Price
- from $19 for 7,500 results ($1.33–$2.53 per 1,000)
- Billing
- prepaid credits, no subscription, no expiry; failed or empty requests cost 0
- Limits
- up to 20 items per request; 120 requests per minute per account; 2 in progress at once on the trial, 8 on paid accounts
- Payment
- card (Stripe) or USDT TRC20 (OxaPay)
Make your first call in five minutes.
20 free credits when you verify your email. No card needed.