Skip to content

Getting Your Result

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.

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.

Terminal window
# 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"
{
"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
}
]
}
}

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.

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
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

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