Skip to content

Introduction

Welcome to the Megomi API documentation. Our REST API returns public data from TikTok (videos, transcripts, profiles, comments, trending hashtags, the trending feed, songs, audience estimates) and Instagram (posts, reels, profiles) Threads (posts with their replies, profiles) and YouTube (video and Short details, transcripts) and LinkedIn (profiles and posts). For example, submit a TikTok video and get back its likes, views, comments, shares, saves, and keranjang kuning (shopping basket) status — see TikTok Video Info to get started.

All API requests require authentication using an API key, via either the Authorization: Bearer <key> header or the x-api-key header.

Job Coalescing

Multiple requests for the same video attach to one in-flight job instead of starting duplicates.

Smart Caching

Recent results are cached for 10 minutes. Asking again for a target your key already paid for is free; a different key asking for the same target is charged normally.

Credit-Based Pricing

Buy credit through your dashboard. Most endpoints cost 1 credit per successful request; a few cost more (for example, Instagram download_media adds 9 credits). Only a 200 is charged.

Developer First

Clean JSON responses, code samples in every language, and predictable schemas.

Code Meaning
200 Success — the only response that’s ever charged
400 Bad Request — invalid or missing parameters
401 Unauthorized — invalid or missing API key
402 Payment Required — insufficient credit balance
403 Forbidden — the job was blocked by the source (age-gate, bot-check, login wall)
404 Not Found — no such route, or the target doesn’t exist (deleted, private, or never existed). Not charged
429 Too Many Requests — rate limit hit
500 Server Error — unexpected error, retry later
503 Service Unavailable — no result within the wait window, or a part of the service is briefly unavailable (a Retry-After header says when to retry). Not charged; resubmit the same request shortly to pick it up from cache once it lands