Submitting a job through the video-jobs submit endpoint waits up to 45 seconds and answers 200 with the result inline the moment it’s ready. If the job doesn’t resolve to a chargeable success in that window, you get 404 (not found), 403 (blocked), or 503 (no data fetched) instead — none of which are charged — and from there, there is no separate endpoint to poll.
The transcript endpoint follows the same rules and adds its own finishReasons, none of them charged; see Finish reasons below.
Resubmit the same request
Section titled “Resubmit the same request”Send the exact same submit request again (same videoUrl). Megomi recognizes it’s the same target already in flight for your key and attaches to that existing request instead of creating a new one — so you’re never charged twice for one video, and a request that’s now finished comes back inline as a 200 with cached: true. A 503 in particular is worth retrying this way: the lookup may still be running in the background and finish shortly after your window closed.
This is literally the same call as your original submit — see TikTok Video Info for the full request/response shape. The only thing to note here is what changes on a resubmit:
| Field | What to expect on a resubmit |
|---|---|
requestId |
A new opaque ID for this call — it’s a separate request row, even though it’s attached to the same underlying job |
coalesced |
true if a job for this video was already in flight when you resubmitted |
cached |
true on a 200 response — this is what tells you the result was already known rather than freshly scraped |
result |
Populated on a 200 |
A resubmitted request against a job that’s still running waits the same way the original did: 200 inline if it finishes within this call’s own window, otherwise another 404/403/503.
# Same request as your original submit call.curl -X POST "https://api.megomi.my.id/api/v1/tiktok/video?url=https://www.tiktok.com/@creator/video/7123456789012345678" \ -H "x-api-key: YOUR_API_KEY"const params = new URLSearchParams({ url: "https://www.tiktok.com/@creator/video/7123456789012345678",});const res = await fetch(`https://api.megomi.my.id/api/v1/tiktok/video?${params}`, { method: "POST", headers: { "x-api-key": process.env.MEGOMI_API_KEY },});const data = await res.json();{ "requestId": "req_9f1kQ3zP7mLxA2dR", "itemId": "7123456789012345678", "status": "success", "coalesced": false, "cached": true, "result": { "likes": 44855, "views": 355687, "comments": 270, "shares": 3100, "saves": 980, "hasBasket": true, "basketProducts": [ { "productId": "1729494515984797858", "title": "Margherita pizza kit", "sellerId": "7000000000000000003", "currency": "USD", "productUrl": "https://www.tiktok.com/view/product/1729494515984797858" } ] }, "success": true, "credits_charged": 0, "credits_remaining": 249, "cached_at": "2026-10-02T09:15:42.381Z", "aweme_detail": { "aweme_id": "7123456789012345678", "desc": "Stopped by the viral @Pizza Place #pizza", "desc_language": "en", "region": "US", "create_time": 1737673396, "create_time_utc": "2025-01-23T23:03:16.000Z", "statistics": { "aweme_id": "7123456789012345678", "play_count": 355687, "digg_count": 44855, "comment_count": 270, "share_count": 3100, "collect_count": 980, "repost_count": 0 }, "video": { "duration": 89000, "width": 576, "height": 1024, "ratio": "540p", "cover": { "url_list": [ "https://p16-sign.tiktokcdn-us.com/cover.image" ] }, "origin_cover": { "url_list": [ "https://p16-sign.tiktokcdn-us.com/origin.image" ] }, "play_addr": { "url_list": [ "https://v16-webapp-prime.tiktok.com/video/tos/play/" ] }, "download_addr": { "url_list": [ "https://v16-webapp-prime.tiktok.com/video/tos/download/" ] }, "bit_rate": [ { "bit_rate": 628217, "gear_name": "adapt_lower_720_2", "quality_type": 14, "is_bytevc1": 1, "play_addr": { "uri": "v12044gd0000example", "url_list": [ "https://v16-webapp-prime.tiktok.com/video/tos/720/" ], "width": 720, "height": 1280, "data_size": 7051192, "url_key": "v12044gd0000example_bytevc1_720p_628217", "file_hash": "0123456789abcdef0123456789abcdef", "file_cs": "c:0-75721-0b32" } }, { "bit_rate": 514600, "gear_name": "lower_540_0", "quality_type": 24, "is_bytevc1": 0, "play_addr": { "url_list": [ "https://v16-webapp-prime.tiktok.com/video/tos/540/" ], "width": 576, "height": 1024 } } ] }, "author": { "uid": "7000000000000000001", "unique_id": "creator", "nickname": "Example Creator", "sec_uid": "MS4wLjABAAAAexampleSecUid", "signature": "Example creator bio.", "avatar_thumb": { "url_list": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/thumb.webp" ] }, "avatar_medium": { "url_list": [ "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/medium.webp" ] }, "verification_type": 1, "secret": 0, "follower_count": 4200000, "following_count": 12, "total_favorited": 250000000, "aweme_count": 1500, "favoriting_count": 312, "create_time": 1577836800, "unique_id_modify_time": 1737751061, "comment_setting": 0, "duet_setting": 0, "stitch_setting": 0, "download_setting": 0 }, "is_ad": false, "url": "https://www.tiktok.com/@creator/video/7123456789012345678", "shop_product_url": "https://www.tiktok.com/shop/pdp/1729494515984797858", "group_id": "7123456789012345678", "content_type": "video", "share_url": "https://www.tiktok.com/@creator/video/7123456789012345678", "music": { "id_str": "7123456789012345679", "mid": "7123456789012345679", "title": "original sound - creator", "author": "Example Creator", "duration": 89, "is_original_sound": true, "play_url": { "url_list": [ "https://sf77-ies-music-va.tiktokcdn.com/obj/ies-music-ttp-dup-us/7123456789012345679.mp3" ] }, "cover_large": { "url_list": [ "https://p16-sign-va.tiktokcdn.com/music/large.jpeg" ] }, "is_commerce_music": false, "is_unlimited_music": false, "is_copyrighted": false, "is_private": false, "shoot_duration": 89 }, "added_sound_music_info": { "id_str": "7123456789012345679", "mid": "7123456789012345679", "title": "original sound - creator", "author": "Example Creator", "duration": 89, "is_original_sound": true, "play_url": { "url_list": [ "https://sf77-ies-music-va.tiktokcdn.com/obj/ies-music-ttp-dup-us/7123456789012345679.mp3" ] }, "cover_large": { "url_list": [ "https://p16-sign-va.tiktokcdn.com/music/large.jpeg" ] }, "is_commerce_music": false, "is_unlimited_music": false, "is_copyrighted": false, "is_private": false, "shoot_duration": 89 }, "text_extra": [ { "start": 21, "end": 33, "type": 0, "user_id": "7000000000000000002", "sec_uid": "MS4wLjABAAAAexampleMention" }, { "start": 34, "end": 40, "type": 1, "hashtag_name": "pizza", "hashtag_id": "10087" } ], "cha_list": [ { "cid": "10087", "cha_name": "pizza" } ], "status": { "aweme_id": "7123456789012345678", "allow_share": true, "private_status": 0 }, "item_comment_settings": 0, "item_duet": 0, "item_stitch": 0, "aigc_info": { "created_by_ai": false }, "engagement_rate": 13.83, "shop_products": [ { "product_id": "1729494515984797858", "title": "Margherita pizza kit", "seller_id": "7000000000000000003", "currency": "USD", "source": "TikTok Shop", "cover_url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-example-sg/cover~tplv-resize-jpeg:800:800.jpeg", "image_urls": [ "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-example-sg/cover~tplv-resize-jpeg:800:800.jpeg" ], "categories": [ { "category_id": "600001", "name": "Food & Beverages", "level": 1 }, { "category_id": "600002", "name": "Meal Kits", "level": 2 } ], "sku_count": 3, "url": "https://www.tiktok.com/shop/pdp/1729494515984797858", "seo_url": "https://shop-id.tokopedia.com/pdp/margherita-pizza-kit/1729494515984797858" } ], "commerce_metrics_status": "unavailable", "content_desc": "[\"Stopped by the viral @Amici Pizza #pizza\"]", "content_desc_extra": [ { "line_idx": 0, "start": 34, "end": 40, "type": 1, "hashtag_id": "10087", "hashtag_name": "pizza", "is_commerce": false } ], "song": { "id": "7123456789012345679", "title": "original sound - creator", "artist": "Example Creator", "duration": 89, "is_original_sound": true, "cover_url": "https://p16-sign-va.tiktokcdn.com/music/large.jpeg" }, "hashtags": [ { "id": "10087", "name": "pizza", "start": 34, "end": 40 } ] }}{ "status": 503, "title": "Service Unavailable", "detail": "no data fetched within 45s; you were not charged. The lookup is still running: submitting the same request again shortly may return it from cache, and is never charged twice", "requestId": "req_1qLr6PxV8nWtE3sJ", "finishReason": "no-data-fetched"}Finish reasons
Section titled “Finish reasons”A 403, 404 or 503 carries a finishReason, a short code for what happened, and a detail sentence that says it in words. Branch on the code, not on detail. A code not listed here can appear: treat it by its status code. Retry-After, when present, is a hint in seconds, not a promise. None of these is ever charged.
503: nothing was fetched
Section titled “503: nothing was fetched”Retrying is safe, and is never charged twice.
finishReason |
What happened | Retry-After |
|---|---|---|
no-data-fetched |
The lookup was still running when your wait ran out. Resubmit shortly to collect it from cache | 5 |
worker-cold-start-timeout |
The lookup worker was waking up after being idle and was not ready in time. It keeps warming up, so a retry usually answers at once | 15 |
worker-no-receiver, worker-timeout, worker-tab-unavailable, claim-stale |
The lookup worker was not ready | 15 |
queue-stale |
No lookup worker picked the lookup up (restarting or paused) | 30 |
cooling-down |
Lookups to this source are paused for a few minutes because it is rate-limiting our service, not your key | 120 |
request-failed, fetch-error, http-5xx |
Our service could not reach the source, or the source answered with a server error | 30 |
transcript-fetch-failed |
tiktok/transcript only: TikTok lists captions for the video but the caption file could not be fetched just now |
30 |
in-flight-without-transcript |
tiktok/transcript, and tiktok/video with get_transcript=true: the video was already being fetched without its transcript, and that fetch had not finished when your wait ran out. Nothing was queued for you, so the body has no requestId. Resubmit to start a fetch that includes the transcript |
5 |
server-restarting, no-waiting-request |
The service restarted while you waited, or the lookup was dropped. Submit the same request again | 5 |
403: the source refused the lookup
Section titled “403: the source refused the lookup”finishReason |
What happened | Retry |
|---|---|---|
captcha-challenge, profile-page-challenge |
TikTok answered with a captcha or bot-check page | In a few minutes (Retry-After 300) |
captcha-challenge-skip |
Lookups of this kind are paused for about 10 minutes after repeated captchas | After Retry-After (600) |
empty-response, non-json-response, http-403, http-429 |
The source refused the request, usually rate-limiting our service rather than your key | In a few minutes |
no-item-in-response, no-media-in-response, no-profile-in-response |
The answer did not contain the target: usually a login wall or a soft block | Maybe later |
login-wall |
tiktok/trending/hashtags only: TikTok’s Creative Center asked for a login instead of showing the ranking |
In a few minutes |
404: the target does not exist
Section titled “404: the target does not exist”Cached for an hour, so retrying sooner returns the same answer. The exceptions are no-transcript and transcript-too-large (cached about 10 minutes), no-comments (about 5) and no-trending-hashtags (about 15).
finishReason |
What happened |
|---|---|
tiktok-status-10204, tiktok-status-10216, tiktok-status-10222 |
TikTok reports the video deleted, private, or never existing |
not-a-video |
The TikTok post is not a video (for example a photo post) |
user-not-found, user-unavailable, private-account |
The account does not exist, is not shown (most likely banned), or is private |
no-transcript |
tiktok/transcript only: TikTok has no captions for this video, none of its own and none in the language asked for |
transcript-too-large |
tiktok/transcript only: the captions run past the 256 KiB of WebVTT this API returns |
no-comments |
tiktok/comments only: the first page has no comments. TikTok answers a post with none exactly as it answers one that does not exist, is not shown, or has comments turned off |
no-trending-hashtags |
tiktok/trending/hashtags only: no trending hashtags for this country, period and category |
not-found |
Instagram reports no such post or profile |