{"openapi":"3.1.0","info":{"title":"TikTok API","version":"1.0.0","description":"8 endpoints for live TikTok public data — user details, stats, post info, URL helpers.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tiktok-api","description":"oanor gateway"}],"tags":[{"name":"Users"},{"name":"Posts"},{"name":"Utils"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/users/detail":{"get":{"operationId":"get_v1_users_detail","tags":["Users"],"summary":"User detail","description":"Vollständiges Profil per Username. Query: username.","parameters":[{"name":"username","in":"query","required":true,"description":"TikTok username (without @)","schema":{"type":"string"},"example":"jlo"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"6611099612067856390","link":"https://www.tiktok.com/@jlo","stats":{"likes":85480540,"videos":422,"followers":17854695,"following":304},"avatar":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/7a9a3eb7d876704105c12a61757b1ebd~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=b16426af&x-expires=1778072400&x-signature=d8dE%2BhXQZNkv%2Fm5%2BzNGaztFAGQQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","sec_uid":"MS4wLjABAAAA2EvW1E1RwMcww5EY5bG0z2TeJ3dusTXaAKNJBQatp8IGSbOvWYWRm6TIIZ46Q40v","language":"en","nickname":"JLO","username":"jlo","verified":true,"signature":"The #1 Single SAVE ME TONIGHT with David Guetta OUT NOW 💫 OFFICE ROMANCE coming to Netflix June 5","private_account":false},"meta":{"timestamp":"2026-05-04T13:59:45.629Z","request_id":"efc3adf7-6b6b-441e-87aa-3418299194d4"},"status":"ok","message":"User detail retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/users/info-with-region":{"get":{"operationId":"get_v1_users_info_with_region","tags":["Users"],"summary":"User info with region","description":"Profil + Region/Sprache. Query: username.","parameters":[{"name":"username","in":"query","required":true,"description":"TikTok username","schema":{"type":"string"},"example":"jlo"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"6611099612067856390","sec_uid":"MS4wLjABAAAA2EvW1E1RwMcww5EY5bG0z2TeJ3dusTXaAKNJBQatp8IGSbOvWYWRm6TIIZ46Q40v","language":"en","username":"jlo"},"meta":{"timestamp":"2026-05-04T13:59:46.159Z","request_id":"2ef1ad50-7d84-4a39-a2a6-ac48cbc89fdd"},"status":"ok","message":"User region retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/users/id":{"get":{"operationId":"get_v1_users_id","tags":["Users"],"summary":"User ID","description":"Numerische User-ID + sec_uid. Query: username.","parameters":[{"name":"username","in":"query","required":true,"description":"TikTok username","schema":{"type":"string"},"example":"jlo"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"6611099612067856390","sec_uid":"MS4wLjABAAAA2EvW1E1RwMcww5EY5bG0z2TeJ3dusTXaAKNJBQatp8IGSbOvWYWRm6TIIZ46Q40v","username":"jlo"},"meta":{"timestamp":"2026-05-04T13:59:46.528Z","request_id":"5cd39af3-f18b-44f6-8f40-2a1084786297"},"status":"ok","message":"User ID retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/users/stats":{"get":{"operationId":"get_v1_users_stats","tags":["Users"],"summary":"User stats","description":"Followers, Following, Likes, Posts. Query: username.","parameters":[{"name":"username","in":"query","required":true,"description":"TikTok username","schema":{"type":"string"},"example":"jlo"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"6611099612067856390","stats":{"likes":85480540,"videos":422,"followers":17854695,"following":304},"sec_uid":"MS4wLjABAAAA2EvW1E1RwMcww5EY5bG0z2TeJ3dusTXaAKNJBQatp8IGSbOvWYWRm6TIIZ46Q40v","username":"jlo"},"meta":{"timestamp":"2026-05-04T13:59:46.974Z","request_id":"96e50423-b4f1-4e9c-8724-a1f1aef71538"},"status":"ok","message":"User stats retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/users/embed":{"get":{"operationId":"get_v1_users_embed","tags":["Users"],"summary":"User embed","description":"Embed-Daten für ein TikTok-Profil. Query: username.","parameters":[{"name":"username","in":"query","required":true,"description":"TikTok username","schema":{"type":"string"},"example":"jlo"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"html":"<blockquote class=\"tiktok-embed\" cite=\"https://www.tiktok.com/@jlo\" data-unique-id=\"jlo\" data-embed-from=\"oembed\" data-embed-type=\"creator\" style=\"max-width:780px; min-width:288px;\"> <section> <a target=\"_blank\" href=\"https://www.tiktok.com/@jlo?refer=creator_embed\">@jlo</a> </section> </blockquote> <script async src=\"https://www.tiktok.com/embed.js\"></script>","type":"rich","title":"JLO's Creator Profile","width":"100%","height":"100%","version":"1.0","username":"jlo","author_url":"https://www.tiktok.com/@jlo","source_url":"https://www.tiktok.com/@jlo","author_name":"JLO","provider_url":"https://www.tiktok.com","provider_name":"TikTok"},"meta":{"timestamp":"2026-05-04T13:59:47.232Z","request_id":"d0fe2c12-24d8-4d7c-91f9-5c1c72e431ca"},"status":"ok","message":"User embed retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/posts/detail":{"get":{"operationId":"get_v1_posts_detail","tags":["Posts"],"summary":"Post detail","description":"Detail-Daten zu einem Video. Query: url.","parameters":[{"name":"url","in":"query","required":true,"description":"TikTok video URL","schema":{"type":"string"},"example":"https://www.tiktok.com/@scout2015/video/6718335390845095173"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"html":"<blockquote class=\"tiktok-embed\" cite=\"https://www.tiktok.com/@scout2015/video/6718335390845095173\" data-video-id=\"6718335390845095173\" data-embed-from=\"oembed\" style=\"max-width:605px; min-width:325px;\"> <section> <a target=\"_blank\" title=\"@scout2015\" href=\"https://www.tiktok.com/@scout2015?refer=embed\">@scout2015</a> <p>Scramble up ur name & I’ll try to guess it😍❤️ <a title=\"foryoupage\" target=\"_blank\" href=\"https://www.tiktok.com/tag/foryoupage?refer=embed\">#foryoupage</a> <a title=\"petsoftiktok\" target=\"_blank\" href=\"https://www.tiktok.com/tag/petsoftiktok?refer=embed\">#petsoftiktok</a> <a title=\"aesthetic\" target=\"_blank\" href=\"https://www.tiktok.com/tag/aesthetic?refer=embed\">#aesthetic</a></p> <a target=\"_blank\" title=\"♬ original sound - tiff\" href=\"https://www.tiktok.com/music/original-sound-6689804660171082501?refer=embed\">♬ original sound - tiff</a> </section> </blockquote> <script async src=\"https://www.tiktok.com/embed.js\"></script>","type":"video","title":"Scramble up ur name & I’ll try to guess it😍❤️ #foryoupage #petsoftiktok #aesthetic","width":"100%","height":"100%","version":"1.0","username":"scout2015","video_id":"6718335390845095173","author_url":"https://www.tiktok.com/@scout2015","source_url":"https://www.tiktok.com/@scout2015/video/6718335390845095173","author_name":"Scout, Suki & Stella","provider_url":"https://www.tiktok.com","provider_name":"TikTok","thumbnail_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-p-0068/2367c7d45cf54a1397abd0e72bf22eac~tplv-tiktokx-origin.image?dr=10395&x-expires=1778072400&x-signature=7J5JAGv3RuDu%2Fwc3xC5s3EE0CeI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","thumbnail_width":576,"thumbnail_height":1024},"meta":{"timestamp":"2026-05-04T13:59:47.525Z","request_id":"89e10392-958e-48f7-8d8d-13f3fb4758cd"},"status":"ok","message":"Post detail retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/utils/username-from-url":{"get":{"operationId":"get_v1_utils_username_from_url","tags":["Utils"],"summary":"Username from URL","description":"Extrahiert den Username aus einer TikTok-URL.","parameters":[{"name":"url","in":"query","required":true,"description":"TikTok URL","schema":{"type":"string"},"example":"https://www.tiktok.com/@scout2015/video/6718335390845095173"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"username":"scout2015"},"meta":{"timestamp":"2026-05-04T13:59:47.574Z","request_id":"efa214d4-b6b7-47cf-b4bb-f6c58852fb99"},"status":"ok","message":"Username retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/utils/video-id-from-url":{"get":{"operationId":"get_v1_utils_video_id_from_url","tags":["Utils"],"summary":"Video ID from URL","description":"Extrahiert die Video-ID aus einer TikTok-URL.","parameters":[{"name":"url","in":"query","required":true,"description":"TikTok video URL","schema":{"type":"string"},"example":"https://www.tiktok.com/@scout2015/video/6718335390845095173"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"video_id":"6718335390845095173"},"meta":{"timestamp":"2026-05-04T13:59:47.661Z","request_id":"d7fbce14-6815-4fb1-b3f8-9597abefecf4"},"status":"ok","message":"Video ID retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":100,"rps_limit":1,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1500,"monthly_call_quota":25000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4900,"monthly_call_quota":100000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":14900,"monthly_call_quota":500000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tiktok-api"}