Introduction

Welcome to the Megomi API documentation. Our REST API lets you submit a TikTok video and get back its likes, views, comments, shares, saves, and keranjang kuning (shopping basket) status — see Submit a Video Job to get started.

API Authentication

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

Key Features of Our API

Job Coalescing

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

Smart Caching

Recent results (including “not found”) are cached, so repeat checks don’t trigger redundant scrapes.

Credit-Based Pricing

Buy credit through your dashboard and spend it 1 credit per resolved video — see Credits & Billing.

Developer First

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

Response Status Codes

Code	Meaning
`200`	Success
`202`	Accepted — didn’t resolve within ~10s; wait for your webhook, or resubmit to check again
`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 TikTok (age-gate, bot-check, login wall)
`429`	Too Many Requests — rate limit hit
`500`	Server Error — unexpected error, retry later
`503`	Service Unavailable — the payment provider is unreachable, retry shortly