REST API
Documentation
Every request goes to https://api.interapi.dev and returns JSON. Pick an API to see its parameters and test it with your own link.
https://api.interapi.dev
Authentication
Pass your key in the X-API-Key header. Authorization: Bearer ia_live_… and the ?api=ia_live_… parameter also work — use the parameter when a third-party client such as Telegram downloads a file by URL.
X-API-Key: ia_live_…
Authorization: Bearer ia_live_…
https://api.interapi.dev/api/v1/tiktok?url=…&api=ia_live_…Status codes
200 | Success. The request price is charged — 5 to 15 credits. |
|---|---|
400 | Invalid or unsupported link. |
401 | Key missing or invalid. |
402 | Out of credits — top up in the dashboard. |
403 | Private content or disabled account. |
404 | Post not found. |
429 | Rate limit exceeded. |
5xx | Our error. No credits are charged. |
Credits
The price depends on the API — 5 to 15 credits per successful request; /api/v1/auto costs as much as the platform it detects. 4xx responses (bad link, deleted post) cost at most 1 credit, 5xx responses are free. Every response carries X-Balance-Remaining and X-Request-Cost headers.
| API | Credits per request |
|---|---|
Instagram /api/v1/instagram | 6 |
TikTok /api/v1/tiktok | 6 |
YouTube /api/v1/youtube | 15 |
X (Twitter) /api/v1/x | 5 |
Facebook /api/v1/facebook | 5 |
Pinterest /api/v1/pinterest | 5 |
RuTube /api/v1/rutube | 5 |
Likee /api/v1/likee | 5 |
YouTube Search /api/v1/youtube/search | 6 |
Shazam /api/v1/shazam | 5 |
File downloads
If a direct URL from the response does not open for your client, hand it a link to our proxy instead. Pass the key as the api parameter; downloads cost no credits.
# Instagram / TikTok / Pinterest file
curl -L -o media.mp4 \
"https://api.interapi.dev/api/v1/media/file?source=tiktok&url=https%3A%2F%2Fvt.tiktok.com%2FZSQrfS4U7%2F&api=YOUR_API_KEY"
# YouTube: kind=audio|video, format_id=best|<itag>
curl -L -o track.m4a \
"https://api.interapi.dev/api/v1/youtube/file?url=https%3A%2F%2Fyoutu.be%2FUFk4_Ybx7yk&kind=audio&api=YOUR_API_KEY"API
- Instagram Media API
GET /api/v1/instagramDownload videos and photos from public Instagram posts, Reels, and carousels via a direct link. - TikTok Video API
GET /api/v1/tiktokDownload TikTok videos without watermark: SD, HD, and a separate MP3 audio track. - YouTube Video API
GET /api/v1/youtubeDownload YouTube video and audio: MP4, WebM, and M4A in multiple qualities up to 720p and beyond. - X (Twitter) Media API
GET /api/v1/xDownload videos, GIFs, and photos from X (Twitter) posts via x.com or twitter.com links. - Facebook Video API
GET /api/v1/facebookDownload public Facebook videos and Reels in HD and SD via facebook.com or fb.watch links. - Pinterest Media API
GET /api/v1/pinterestDownload videos, images, and GIFs from Pinterest via pin.it or pinterest.com links. - RuTube Video API
GET /api/v1/rutubeRuTube videos and Shorts in several qualities up to 1080p: an HLS link for every resolution. - Likee Video API
GET /api/v1/likeeDownload short Likee videos via likee.video links or l.likee.video/v/… short links. - YouTube Search API
GET /api/v1/youtube/searchSearch videos, music, playlists, channels, and live streams on YouTube and YouTube Music. - Shazam API
GET / POST /api/v1/shazamIdentify a song from audio or video via URL or file upload.