{"openapi":"3.1.0","info":{"title":"TikTok API","version":"1.0.0","description":"20 endpoints for live TikTok public data — user profiles, posts, search, hashtags, media + 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":"Hashtags"},{"name":"Search"},{"name":"Media"},{"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/users/profile":{"get":{"operationId":"get_v1_users_profile","tags":["Users"],"summary":"User profile","description":"Full TikTok user profile by username or numeric user id. Returns avatar, bio, follower / following counts and verified flag.","parameters":[{"name":"username","in":"query","required":false,"description":"TikTok username (without @). Alternative to id_or_username.","schema":{"type":"string"},"example":"jlo"},{"name":"id_or_username","in":"query","required":false,"description":"Numeric user id or username. One of username / id_or_username is required.","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":85661282,"videos":426,"followers":17855147,"following":309},"avatar":"https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d4a90dd0556e3bbbd2e82c8ab8d0de70~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=c01126c1&x-expires=1779555600&x-signature=vPxB%2FuC8pe9RUQUIcnhXUcMGIFg%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-21T17:51:09.136Z","request_id":"e72d3413-f435-4b7e-a3a7-d9952ed6abff"},"status":"ok","message":"User profile 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/search":{"get":{"operationId":"get_v1_users_search","tags":["Users"],"summary":"User search","description":"Search TikTok users by free-text query. Returns ranked user matches with username, display name, follower count.","parameters":[{"name":"q","in":"query","required":true,"description":"Free-text search query.","schema":{"type":"string"},"example":"chef"},{"name":"count","in":"query","required":false,"description":"Max results (default 20, capped at 50).","schema":{"type":"integer","maximum":50,"minimum":1},"example":20}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"query":"chef","users":[{"username":"chefchrischo","profile_url":"https://www.tiktok.com/@chefchrischo"},{"username":"chefreactions","profile_url":"https://www.tiktok.com/@chefreactions"},{"username":"chefbae","profile_url":"https://www.tiktok.com/@chefbae"},{"username":"chefthomson","profile_url":"https://www.tiktok.com/@chefthomson"},{"username":"chefaaronsanchez","profile_url":"https://www.tiktok.com/@chefaaronsanchez"},{"username":"chef__tyler","profile_url":"https://www.tiktok.com/@chef__tyler"},{"username":"chefklosangeles","profile_url":"https://www.tiktok.com/@chefklosangeles"},{"username":"chef.michael","profile_url":"https://www.tiktok.com/@chef.michael"},{"username":"daronthechef","profile_url":"https://www.tiktok.com/@daronthechef"},{"username":"thestayathomechef","profile_url":"https://www.tiktok.com/@thestayathomechef"},{"username":"twisted.chef","profile_url":"https://www.tiktok.com/@twisted.chef"},{"username":"rappingchef","profile_url":"https://www.tiktok.com/@rappingchef"},{"username":"chefkeysh","profile_url":"https://www.tiktok.com/@chefkeysh"},{"username":"chefsymon","profile_url":"https://www.tiktok.com/@chefsymon"},{"username":"_.chefk","profile_url":"https://www.tiktok.com/@_.chefk"},{"username":"chefthombateman","profile_url":"https://www.tiktok.com/@chefthombateman"},{"username":"flakeysalt","profile_url":"https://www.tiktok.com/@flakeysalt"},{"username":"chefp.s","profile_url":"https://www.tiktok.com/@chefp.s"},{"username":"the_funnychef","profile_url":"https://www.tiktok.com/@the_funnychef"},{"username":"chefpaige75","profile_url":"https://www.tiktok.com/@chefpaige75"}],"source":"brave_tiktok_search"},"meta":{"timestamp":"2026-05-21T17:51:10.158Z","request_id":"99e343df-a434-4b61-9e2a-61dad5af9276"},"status":"ok","message":"Users 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/insights":{"get":{"operationId":"get_v1_users_insights","tags":["Users"],"summary":"User insights","description":"Engagement insights for a TikTok user — average likes per post, engagement rate, post frequency, audience growth.","parameters":[{"name":"username","in":"query","required":false,"description":"TikTok username. Alternative to id_or_username.","schema":{"type":"string"},"example":"jlo"},{"name":"id_or_username","in":"query","required":false,"description":"Numeric user id or username. One of username / id_or_username is required.","schema":{"type":"string"},"example":"jlo"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"6611099612067856390","stats":{"likes":85661283,"videos":426,"followers":17855147,"following":309},"sec_uid":"MS4wLjABAAAA2EvW1E1RwMcww5EY5bG0z2TeJ3dusTXaAKNJBQatp8IGSbOvWYWRm6TIIZ46Q40v","language":"en","username":"jlo","verified":true,"private_account":false},"meta":{"timestamp":"2026-05-21T17:51:10.960Z","request_id":"d8ec90fc-3d56-48b0-93c1-11a94793f075"},"status":"ok","message":"User insights 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/web-profile-info":{"get":{"operationId":"get_v1_users_web_profile_info","tags":["Users"],"summary":"User web profile info","description":"Web-style profile payload mirroring the TikTok profile page — same shape as the data the website renders.","parameters":[{"name":"username","in":"query","required":false,"description":"TikTok username. Alternative to id_or_username.","schema":{"type":"string"},"example":"jlo"},{"name":"id_or_username","in":"query","required":false,"description":"Numeric user id or username. One of username / id_or_username is required.","schema":{"type":"string"},"example":"jlo"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"needFix":false,"userInfo":{"user":{"id":"6611099612067856390","ftc":false,"roomId":"","secUid":"MS4wLjABAAAA2EvW1E1RwMcww5EY5bG0z2TeJ3dusTXaAKNJBQatp8IGSbOvWYWRm6TIIZ46Q40v","secret":false,"bioLink":{"link":"https://JenniferLopez.lnk.to/jlo25","risk":3},"shortId":"","language":"en","nickname":"JLO","relation":0,"ttSeller":false,"uniqueId":"jlo","verified":true,"eventList":[],"signature":"The #1 Single SAVE ME TONIGHT with David Guetta OUT NOW 💫 OFFICE ROMANCE coming to Netflix June 5","createTime":1548716114,"profileTab":{"showMusicTab":true,"showPlayListTab":true,"showQuestionTab":true},"avatarThumb":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d4a90dd0556e3bbbd2e82c8ab8d0de70~tplv-tiktokx-cropcenter:100:100.jpeg?dr=10399&refresh_token=45f17fc2&x-expires=1779555600&x-signature=%2FHPe51x4iT89KO%2BLych1xgwyu0Q%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","duetSetting":0,"isADVirtual":false,"avatarLarger":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d4a90dd0556e3bbbd2e82c8ab8d0de70~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=fa9f1eda&x-expires=1779555600&x-signature=Sx%2Fr1KIxFJbEGJNr3GYgceqyt1k%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","avatarMedium":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d4a90dd0556e3bbbd2e82c8ab8d0de70~tplv-tiktokx-cropcenter:720:720.jpeg?dr=10399&refresh_token=e27a28eb&x-expires=1779555600&x-signature=xpMpGf8lQ1ERF5Z9aE8jrmWr0HQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","openFavorite":false,"isEmbedBanned":false,"stitchSetting":0,"canExpPlaylist":true,"commentSetting":0,"isOrganization":0,"privateAccount":false,"UserStoryStatus":1,"downloadSetting":0,"recommendReason":"","commerceUserInfo":{"commerceUser":false},"nickNameModifyTime":0,"suggestAccountBind":false,"uniqueIdModifyTime":0,"followingVisibility":1,"nowInvitationCardUrl":"","profileEmbedPermission":1},"stats":{"heart":85700000,"diggCount":0,"heartCount":85700000,"videoCount":426,"friendCount":159,"followerCount":17900000,"followingCount":309},"statsV2":{"heart":"85661283","diggCount":"0","heartCount":"85661283","videoCount":"426","friendCount":"159","followerCount":"17855147","followingCount":"309"},"itemList":[]},"shareMeta":{"desc":"@jlo 17.9m Followers, 309 Following, 85.7m Likes - Watch awesome short videos created by JLO","title":"JLO on TikTok"},"statusMsg":"","statusCode":0},"meta":{"timestamp":"2026-05-21T17:51:12.543Z","request_id":"8126efda-ade8-4da5-bab6-1217da7ab20d"},"status":"ok","message":"Web profile info 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/posts/select":{"get":{"operationId":"get_v1_posts_select","tags":["Posts"],"summary":"Post select","description":"Resolve a TikTok post by either video URL or username + numeric id. Pass the url query param OR both username and id. Returns the same post payload as posts/detail.","parameters":[{"name":"url","in":"query","required":false,"description":"TikTok video URL (alternative to username+id)","schema":{"type":"string"},"example":"https://www.tiktok.com/@scout2015/video/6718335390845095173"},{"name":"username","in":"query","required":false,"description":"TikTok username, used together with id","schema":{"type":"string"},"example":"scout2015"},{"name":"id","in":"query","required":false,"description":"TikTok video numeric id, used together with username","schema":{"type":"string"},"example":"6718335390845095173"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"6718335390845095173","title":"Scramble up ur name & I’ll try to guess it😍❤️ #foryoupage #petsoftiktok #aesthetic","width":"100%","height":"100%","post_url":"https://www.tiktok.com/@scout2015/video/6718335390845095173","username":"scout2015","video_id":"6718335390845095173","author_url":"https://www.tiktok.com/@scout2015","embed_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>","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=1779555600&x-signature=VHaGTbrhiEFdtHC0hJJBK2Z8v7s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","thumbnail_width":576,"thumbnail_height":1024},"meta":{"timestamp":"2026-05-21T17:51:13.672Z","request_id":"278d2baf-39f4-45f9-aa28-97769a288095"},"status":"ok","message":"Post selected 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/info":{"get":{"operationId":"get_v1_posts_info","tags":["Posts"],"summary":"Post info","description":"Extended post payload — captions, stats, music, hashtags, mentions. Pass either url or username + id.","parameters":[{"name":"url","in":"query","required":false,"description":"TikTok video URL (alternative to username + id).","schema":{"type":"string"},"example":"https://www.tiktok.com/@scout2015/video/6718335390845095173"},{"name":"username","in":"query","required":false,"description":"TikTok username, used together with id.","schema":{"type":"string"},"example":"scout2015"},{"name":"id","in":"query","required":false,"description":"TikTok video numeric id, used together with username.","schema":{"type":"string"},"example":"6718335390845095173"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"6718335390845095173","title":"Scramble up ur name & I’ll try to guess it😍❤️ #foryoupage #petsoftiktok #aesthetic","width":"100%","height":"100%","post_url":"https://www.tiktok.com/@scout2015/video/6718335390845095173","username":"scout2015","video_id":"6718335390845095173","author_url":"https://www.tiktok.com/@scout2015","embed_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>","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=1779555600&x-signature=VHaGTbrhiEFdtHC0hJJBK2Z8v7s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","thumbnail_width":576,"thumbnail_height":1024},"meta":{"timestamp":"2026-05-21T17:51:14.239Z","request_id":"9fb88f56-0630-4c63-b6bd-06951a19492d"},"status":"ok","message":"Post info 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/search":{"get":{"operationId":"get_v1_posts_search","tags":["Posts"],"summary":"Post search","description":"Search TikTok posts by free-text query. Returns ranked video matches with captions, stats and author.","parameters":[{"name":"q","in":"query","required":true,"description":"Free-text search query.","schema":{"type":"string"},"example":"recipe"},{"name":"count","in":"query","required":false,"description":"Max results (default 20, capped at 50).","schema":{"type":"integer","maximum":50,"minimum":1},"example":20}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"posts":[{"id":"7214783393450429697","post_url":"https://www.tiktok.com/@frommylittlekitchen/video/7214783393450429697","username":"frommylittlekitchen","video_id":"7214783393450429697"},{"id":"7480598109484010794","post_url":"https://www.tiktok.com/@ddlovato/video/7480598109484010794","username":"ddlovato","video_id":"7480598109484010794"},{"id":"7463489217960643882","post_url":"https://www.tiktok.com/@geoffreyzakarian/video/7463489217960643882","username":"geoffreyzakarian","video_id":"7463489217960643882"},{"id":"7122225011259133227","post_url":"https://www.tiktok.com/@mealsandmunchies/video/7122225011259133227","username":"mealsandmunchies","video_id":"7122225011259133227"},{"id":"7446885506299776264","post_url":"https://www.tiktok.com/@recime.app/video/7446885506299776264","username":"recime.app","video_id":"7446885506299776264"},{"id":"7489147525967007007","post_url":"https://www.tiktok.com/@tiktok/video/7489147525967007007","username":"tiktok","video_id":"7489147525967007007"},{"id":"7553433413227646221","post_url":"https://www.tiktok.com/@cooking_recipescr/video/7553433413227646221","username":"cooking_recipescr","video_id":"7553433413227646221"},{"id":"7294466044616330503","post_url":"https://www.tiktok.com/@recime.app/video/7294466044616330503","username":"recime.app","video_id":"7294466044616330503"},{"id":"7490716178357243182","post_url":"https://www.tiktok.com/@cookingwithkatiecross/video/7490716178357243182","username":"cookingwithkatiecross","video_id":"7490716178357243182"},{"id":"7380890963092180255","post_url":"https://www.tiktok.com/@mealsandmunchies/video/7380890963092180255","username":"mealsandmunchies","video_id":"7380890963092180255"},{"id":"7030448355121581358","post_url":"https://www.tiktok.com/@lannahheblanccc/video/7030448355121581358","username":"lannahheblanccc","video_id":"7030448355121581358"},{"id":"7485464265663614254","post_url":"https://www.tiktok.com/@adrianassweetlife/video/7485464265663614254","username":"adrianassweetlife","video_id":"7485464265663614254"},{"id":"7173318002287611182","post_url":"https://www.tiktok.com/@recipe_collector/video/7173318002287611182","username":"recipe_collector","video_id":"7173318002287611182"},{"id":"7640482254774357278","post_url":"https://www.tiktok.com/@healthy.tasty.recipes/video/7640482254774357278","username":"healthy.tasty.recipes","video_id":"7640482254774357278"},{"id":"7353619572576079137","post_url":"https://www.tiktok.com/@thelittleplantation/video/7353619572576079137","username":"thelittleplantation","video_id":"7353619572576079137"},{"id":"7285534538682436907","post_url":"https://www.tiktok.com/@mealsandmunchies/video/7285534538682436907","username":"mealsandmunchies","video_id":"7285534538682436907"},{"id":"7468371143808929067","post_url":"https://www.tiktok.com/@tinekeyounger/video/7468371143808929067","username":"tinekeyounger","video_id":"7468371143808929067"},{"id":"7638192157005794590","post_url":"https://www.tiktok.com/@fanpage.bestrecipe/video/7638192157005794590","username":"fanpage.bestrecipe","video_id":"7638192157005794590"},{"id":"7032449194078194991","post_url":"https://www.tiktok.com/@samsungfoodofficial/video/7032449194078194991","username":"samsungfoodofficial","video_id":"7032449194078194991"},{"id":"7475113012874186030","post_url":"https://www.tiktok.com/@naraazizasmith/video/7475113012874186030","username":"naraazizasmith","video_id":"7475113012874186030"}],"query":"recipe","source":"brave_tiktok_search"},"meta":{"timestamp":"2026-05-21T17:51:15.220Z","request_id":"30d69916-0ad2-4bc6-8834-ee0dd5f35511"},"status":"ok","message":"Posts 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/hashtags/search":{"get":{"operationId":"get_v1_hashtags_search","tags":["Hashtags"],"summary":"Hashtag search","description":"Search TikTok hashtags by free-text query. Returns trending hashtags with view counts.","parameters":[{"name":"q","in":"query","required":true,"description":"Free-text hashtag search query.","schema":{"type":"string"},"example":"summer"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":12,"query":"summer","source":"brave_tiktok_search","hashtags":[{"link":"https://www.tiktok.com/tag/summer","name":"summer","hashtag":"#summer"},{"link":"https://www.tiktok.com/tag/summer%F0%9F%A4%8D","name":"summer🤍","hashtag":"#summer🤍"},{"link":"https://www.tiktok.com/tag/summertime%E2%98%80%EF%B8%8F","name":"summertime☀️","hashtag":"#summertime☀️"},{"link":"https://www.tiktok.com/tag/summertime%F0%9F%A4%97","name":"summertime🤗","hashtag":"#summertime🤗"},{"link":"https://www.tiktok.com/tag/summertime%F0%9F%8C%8A%F0%9F%8C%B4","name":"summertime🌊🌴","hashtag":"#summertime🌊🌴"},{"link":"https://www.tiktok.com/tag/summertime%F0%9F%98%94%F0%9F%98%94","name":"summertime😔😔","hashtag":"#summertime😔😔"},{"link":"https://www.tiktok.com/tag/summer%F0%9F%92%99%F0%9F%8F%8A%E2%80%8D%E2%99%80%EF%B8%8F%F0%9F%8F%9D","name":"summer💙🏊‍♀️🏝","hashtag":"#summer💙🏊‍♀️🏝"},{"link":"https://www.tiktok.com/tag/summertiktok","name":"summertiktok","hashtag":"#summertiktok"},{"link":"https://www.tiktok.com/tag/summerfashion","name":"summerfashion","hashtag":"#summerfashion"},{"link":"https://www.tiktok.com/tag/summerideas","name":"summerideas","hashtag":"#summerideas"},{"link":"https://www.tiktok.com/tag/summervibe","name":"summervibe","hashtag":"#summervibe"},{"link":"https://www.tiktok.com/tag/hotgirlsummer","name":"hotgirlsummer","hashtag":"#hotgirlsummer"}]},"meta":{"timestamp":"2026-05-21T17:51:16.144Z","request_id":"1a2cd107-61c2-4a5e-b115-3097cfd6803c"},"status":"ok","message":"Hashtags 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/hashtags/media":{"get":{"operationId":"get_v1_hashtags_media","tags":["Hashtags"],"summary":"Hashtag media","description":"Latest posts tagged with a specific hashtag — captions, stats, author info.","parameters":[{"name":"hashtag","in":"query","required":true,"description":"Hashtag (without #).","schema":{"type":"string"},"example":"recipe"},{"name":"count","in":"query","required":false,"description":"Max results (default 20, capped at 50).","schema":{"type":"integer","maximum":50,"minimum":1},"example":20}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"media":[{"id":"7195321149796928811","post_url":"https://www.tiktok.com/@setupspawn/video/7195321149796928811","username":"setupspawn","video_id":"7195321149796928811","matched_hashtag":"#recipe"},{"id":"7419353376749604139","post_url":"https://www.tiktok.com/@foodinwindow/video/7419353376749604139","username":"foodinwindow","video_id":"7419353376749604139","matched_hashtag":"#recipe"},{"id":"7490466504538852610","post_url":"https://www.tiktok.com/@recipe.hub1/video/7490466504538852610","username":"recipe.hub1","video_id":"7490466504538852610","matched_hashtag":"#recipe"},{"id":"7390874644900810014","post_url":"https://www.tiktok.com/@thatrecipe.us/video/7390874644900810014","username":"thatrecipe.us","video_id":"7390874644900810014","matched_hashtag":"#recipe"},{"id":"7300296189713403169","post_url":"https://www.tiktok.com/@recettesdefamilles/video/7300296189713403169","username":"recettesdefamilles","video_id":"7300296189713403169","matched_hashtag":"#recipe"},{"id":"7377123064716348714","post_url":"https://www.tiktok.com/@setupspawn/video/7377123064716348714","username":"setupspawn","video_id":"7377123064716348714","matched_hashtag":"#recipe"},{"id":"7475390140404256031","post_url":"https://www.tiktok.com/@thatrecipe.us/video/7475390140404256031","username":"thatrecipe.us","video_id":"7475390140404256031","matched_hashtag":"#recipe"},{"id":"7508521740981570846","post_url":"https://www.tiktok.com/@thatrecipe.us/video/7508521740981570846","username":"thatrecipe.us","video_id":"7508521740981570846","matched_hashtag":"#recipe"},{"id":"7509945678714375455","post_url":"https://www.tiktok.com/@thatrecipe.us/video/7509945678714375455","username":"thatrecipe.us","video_id":"7509945678714375455","matched_hashtag":"#recipe"},{"id":"7489470359658384695","post_url":"https://www.tiktok.com/@recipeeasycook/video/7489470359658384695","username":"recipeeasycook","video_id":"7489470359658384695","matched_hashtag":"#recipe"},{"id":"7522988700414774559","post_url":"https://www.tiktok.com/@thatrecipe.us/video/7522988700414774559","username":"thatrecipe.us","video_id":"7522988700414774559","matched_hashtag":"#recipe"},{"id":"7400903221826424095","post_url":"https://www.tiktok.com/@thatrecipe.us/video/7400903221826424095","username":"thatrecipe.us","video_id":"7400903221826424095","matched_hashtag":"#recipe"},{"id":"7393102826160803102","post_url":"https://www.tiktok.com/@thatrecipe.us/video/7393102826160803102","username":"thatrecipe.us","video_id":"7393102826160803102","matched_hashtag":"#recipe"},{"id":"7489683394910113046","post_url":"https://www.tiktok.com/@recipe.hub1/video/7489683394910113046","username":"recipe.hub1","video_id":"7489683394910113046","matched_hashtag":"#recipe"},{"id":"7456820230438882591","post_url":"https://www.tiktok.com/@thatrecipe.us/video/7456820230438882591","username":"thatrecipe.us","video_id":"7456820230438882591","matched_hashtag":"#recipe"},{"id":"7500149990925323542","post_url":"https://www.tiktok.com/@recipe.hub1/video/7500149990925323542","username":"recipe.hub1","video_id":"7500149990925323542","matched_hashtag":"#recipe"},{"id":"7456914279015533870","post_url":"https://www.tiktok.com/@setupspawn/video/7456914279015533870","username":"setupspawn","video_id":"7456914279015533870","matched_hashtag":"#recipe"},{"id":"7498572043537976598","post_url":"https://www.tiktok.com/@recipe.hub1/video/7498572043537976598","username":"recipe.hub1","video_id":"7498572043537976598","matched_hashtag":"#recipe"},{"id":"7173318002287611182","post_url":"https://www.tiktok.com/@recipe_collector/video/7173318002287611182","username":"recipe_collector","video_id":"7173318002287611182","matched_hashtag":"#recipe"},{"id":"7340010544360901930","post_url":"https://www.tiktok.com/@thatrecipe.us/video/7340010544360901930","username":"thatrecipe.us","video_id":"7340010544360901930","matched_hashtag":"#recipe"}],"source":"brave_tiktok_search","hashtag":"#recipe"},"meta":{"timestamp":"2026-05-21T17:51:17.111Z","request_id":"8a284816-5af4-47e8-a96d-c3b8f1e0aac9"},"status":"ok","message":"Hashtag media 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/search/global":{"get":{"operationId":"get_v1_search_global","tags":["Search"],"summary":"Global search","description":"Combined search across users, posts and hashtags — single query, multi-type results.","parameters":[{"name":"q","in":"query","required":true,"description":"Free-text search query.","schema":{"type":"string"},"example":"chef"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"posts":[{"id":"7477964535081487621","post_url":"https://www.tiktok.com/@chefreactions/video/7477964535081487621","username":"chefreactions","video_id":"7477964535081487621"},{"id":"7403060183817145633","post_url":"https://www.tiktok.com/@chef_donky/video/7403060183817145633","username":"chef_donky","video_id":"7403060183817145633"},{"id":"7450553185225215274","post_url":"https://www.tiktok.com/@jeffandlaurenshow/video/7450553185225215274","username":"jeffandlaurenshow","video_id":"7450553185225215274"},{"id":"7112079360596708613","post_url":"https://www.tiktok.com/@chefreactions/video/7112079360596708613","username":"chefreactions","video_id":"7112079360596708613"},{"id":"7074315044032515374","post_url":"https://www.tiktok.com/@flakeysalt/video/7074315044032515374","username":"flakeysalt","video_id":"7074315044032515374"},{"id":"7486565380748545286","post_url":"https://www.tiktok.com/@chefreactions/video/7486565380748545286","username":"chefreactions","video_id":"7486565380748545286"},{"id":"7506898180458515717","post_url":"https://www.tiktok.com/@chefreactions/video/7506898180458515717","username":"chefreactions","video_id":"7506898180458515717"},{"id":"7188544894204431622","post_url":"https://www.tiktok.com/@chefreactions/video/7188544894204431622","username":"chefreactions","video_id":"7188544894204431622"},{"id":"7272034990349700398","post_url":"https://www.tiktok.com/@livforpasta/video/7272034990349700398","username":"livforpasta","video_id":"7272034990349700398"},{"id":"7123566469937483014","post_url":"https://www.tiktok.com/@chefreactions/video/7123566469937483014","username":"chefreactions","video_id":"7123566469937483014"}],"query":"chef","users":[{"username":"chefchrischo","profile_url":"https://www.tiktok.com/@chefchrischo"},{"username":"chefreactions","profile_url":"https://www.tiktok.com/@chefreactions"},{"username":"chefbae","profile_url":"https://www.tiktok.com/@chefbae"},{"username":"chefthomson","profile_url":"https://www.tiktok.com/@chefthomson"},{"username":"chefaaronsanchez","profile_url":"https://www.tiktok.com/@chefaaronsanchez"},{"username":"chef__tyler","profile_url":"https://www.tiktok.com/@chef__tyler"},{"username":"chefklosangeles","profile_url":"https://www.tiktok.com/@chefklosangeles"},{"username":"chef.michael","profile_url":"https://www.tiktok.com/@chef.michael"},{"username":"daronthechef","profile_url":"https://www.tiktok.com/@daronthechef"},{"username":"thestayathomechef","profile_url":"https://www.tiktok.com/@thestayathomechef"}],"counts":{"posts":10,"users":10,"hashtags":10},"hashtags":[{"link":"https://www.tiktok.com/tag/chef","name":"chef","hashtag":"#chef"},{"link":"https://www.tiktok.com/tag/chefs","name":"chefs","hashtag":"#chefs"},{"link":"https://www.tiktok.com/tag/masterchefsg","name":"masterchefsg","hashtag":"#masterchefsg"},{"link":"https://www.tiktok.com/tag/tiktokchef","name":"tiktokchef","hashtag":"#tiktokchef"},{"link":"https://www.tiktok.com/tag/cookbychef","name":"cookbychef","hashtag":"#cookbychef"},{"link":"https://www.tiktok.com/tag/chefauthorized","name":"chefauthorized","hashtag":"#chefauthorized"},{"link":"https://www.tiktok.com/tag/chefinhome","name":"chefinhome","hashtag":"#chefinhome"},{"link":"https://www.tiktok.com/tag/cheftry","name":"cheftry","hashtag":"#cheftry"},{"link":"https://www.tiktok.com/tag/masterchefgr","name":"masterchefgr","hashtag":"#masterchefgr"},{"link":"https://www.tiktok.com/tag/tiktokchefs","name":"tiktokchefs","hashtag":"#tiktokchefs"}]},"meta":{"timestamp":"2026-05-21T17:51:18.260Z","request_id":"1ff7ca3a-8e6a-4bfa-b984-ce1583c5949c"},"status":"ok","message":"Global search 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/media/info":{"get":{"operationId":"get_v1_media_info","tags":["Media"],"summary":"Media info","description":"Media payload of a post — video CDN URL, thumbnail, dimensions, duration, codec. Pass url or username + id.","parameters":[{"name":"url","in":"query","required":false,"description":"TikTok video URL (alternative to username + id).","schema":{"type":"string"},"example":"https://www.tiktok.com/@scout2015/video/6718335390845095173"},{"name":"username","in":"query","required":false,"description":"TikTok username, used together with id.","schema":{"type":"string"},"example":"scout2015"},{"name":"id","in":"query","required":false,"description":"TikTok video numeric id, used together with username.","schema":{"type":"string"},"example":"6718335390845095173"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"6718335390845095173","title":"Scramble up ur name & I’ll try to guess it😍❤️ #foryoupage #petsoftiktok #aesthetic","width":"100%","height":"100%","post_url":"https://www.tiktok.com/@scout2015/video/6718335390845095173","username":"scout2015","video_id":"6718335390845095173","author_url":"https://www.tiktok.com/@scout2015","embed_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>","author_name":"Scout, Suki & Stella","provider_url":"https://www.tiktok.com","provider_name":"TikTok","thumbnail_url":"https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-p-0068/2367c7d45cf54a1397abd0e72bf22eac~tplv-tiktokx-origin.image?dr=10395&x-expires=1779555600&x-signature=QvIlsofgdFqS6R5BP7bMM%2B%2Fi5Bs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","thumbnail_width":576,"thumbnail_height":1024},"meta":{"timestamp":"2026-05-21T17:51:19.160Z","request_id":"bee1e158-7fed-4766-9483-d54325384837"},"status":"ok","message":"Media 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/media/download":{"get":{"operationId":"get_v1_media_download","tags":["Media"],"summary":"Media download","description":"Direct download link for a TikTok post (with watermark stripped where the provider allows). Pass url or username + id.","parameters":[{"name":"url","in":"query","required":false,"description":"TikTok video URL (alternative to username + id).","schema":{"type":"string"},"example":"https://www.tiktok.com/@scout2015/video/6718335390845095173"},{"name":"username","in":"query","required":false,"description":"TikTok username, used together with id.","schema":{"type":"string"},"example":"scout2015"},{"name":"id","in":"query","required":false,"description":"TikTok video numeric id, used together with username.","schema":{"type":"string"},"example":"6718335390845095173"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"6718335390845095173","post_url":"https://www.tiktok.com/@scout2015/video/6718335390845095173","video_id":"6718335390845095173","embed_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>","thumbnail_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-p-0068/2367c7d45cf54a1397abd0e72bf22eac~tplv-tiktokx-origin.image?dr=10395&x-expires=1779555600&x-signature=VHaGTbrhiEFdtHC0hJJBK2Z8v7s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a"},"meta":{"timestamp":"2026-05-21T17:51:19.801Z","request_id":"a8be2032-3baf-45d3-b4f7-c2b71671c09a"},"status":"ok","message":"Media download data 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":300,"rps_limit":1,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":2700,"monthly_call_quota":12000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":7400,"monthly_call_quota":55000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":18900,"monthly_call_quota":220000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tiktok-api"}