> ## Documentation Index > Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get hashtag detail > Discover new trends on TikTok through hashtags
2 creditsper request
## Copy for AI

Why Code When AI Can Do It For You?

Stop writing code like it's 1970! Let AI do the heavy lifting - click the button to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

## OpenAPI ````yaml en/tiktok-ads-library.openapi.json GET /v1/tk-ads/trends_hashtag_detail openapi: 3.0.1 info: title: Tiktok-ads API english documentation description: >- The english reference documentation of the Tiktok-ads API includes the interface's purpose, parameter description, response status, and sample structure. version: 1.0.0 servers: - url: https://api.keyapi.ai description: Production-KeyAPI security: [] tags: [] paths: /v1/tk-ads/trends_hashtag_detail: get: tags: [] summary: Get hashtag detail description: Discover new trends on TikTok through hashtags parameters: - name: hashtagID in: query description: '' required: true example: '7126660302946435118' schema: type: string example: '7126660302946435118' - name: countryCode in: query description: Country Code, US|JP|IV|TH|ID required: true example: US schema: type: string example: US - name: timeRange in: query description: >- Time range(default:7). Available values: 7=Last 7 Days, 30=Last 30 Days, 90=Last 90 Days required: false example: 90 schema: type: integer default: 7 responses: '200': description: '' content: application/json: schema: type: object properties: {} example: code: 0 message: success data: BaseResp: StatusCode: 0 StatusMessage: '' ageProfile: - ageLevel: '3' vvPercent: '31.52' - ageLevel: '5' vvPercent: '33.55' - ageLevel: '4' vvPercent: '34.93' countryCode: US hashtagID: '7126660302946435118' hashtagName: worththesearch industryIDs: [] popularityCurve: - timestamp: '1781481600' value: 0 - timestamp: '1781568000' value: 0 - timestamp: '1781654400' value: 0 - timestamp: '1781740800' value: 0 - timestamp: '1781827200' value: 0 - timestamp: '1781913600' value: 0 - timestamp: '1782000000' value: 0 - timestamp: '1782259200' value: 0 - timestamp: '1782345600' value: 0 - timestamp: '1782518400' value: 0 - timestamp: '1782604800' value: 0 - timestamp: '1782691200' value: 0 - timestamp: '1783036800' value: 0 - timestamp: '1783123200' value: 0 - timestamp: '1783209600' value: 0 - timestamp: '1783296000' value: 0 - timestamp: '1783382400' value: 0 - timestamp: '1783468800' value: 0 - timestamp: '1783987200' value: 0 - timestamp: '1784160000' value: 0 - timestamp: '1784419200' value: 0 - timestamp: '1784505600' value: 0 - timestamp: '1784678400' value: 0 - timestamp: '1784764800' value: 0 - timestamp: '1785024000' value: 0 - timestamp: '1785110400' value: 0 - timestamp: '1785369600' value: 17.863427047941045 - timestamp: '1785456000' value: 0 - timestamp: '1785542400' value: 0 - timestamp: '1785628800' value: 0 - timestamp: '1785715200' value: 0 - timestamp: '1785801600' value: 0 - timestamp: '1785888000' value: 0 - timestamp: '1785974400' value: 0 - timestamp: '1786060800' value: 0 - timestamp: '1786147200' value: 0 - timestamp: '1786233600' value: 0 - timestamp: '1786320000' value: 7.095341463103424 - timestamp: '1786406400' value: 0 - timestamp: '1786492800' value: 8.049917986055497 - timestamp: '1786579200' value: 0 - timestamp: '1786665600' value: 23.637138799929218 - timestamp: '1786752000' value: 0 - timestamp: '1786838400' value: 0 - timestamp: '1786924800' value: 0 - timestamp: '1787011200' value: 7.095341463103424 - timestamp: '1787097600' value: 0 - timestamp: '1787184000' value: 23.749123299993073 - timestamp: '1787270400' value: 23.371851508445584 - timestamp: '1787356800' value: 0 - timestamp: '1787443200' value: 0 - timestamp: '1787529600' value: 55.025318272546464 - timestamp: '1787616000' value: 63.34441093312145 - timestamp: '1787702400' value: 96.21869661333866 - timestamp: '1787788800' value: 94.80168409607163 - timestamp: '1787875200' value: 96.3460182515207 - timestamp: '1787961600' value: 98.2340014483413 - timestamp: '1788048000' value: 95.60157090271811 - timestamp: '1788134400' value: 94.17812049844592 - timestamp: '1788220800' value: 92.80150945990245 - timestamp: '1788307200' value: 100 - timestamp: '1788393600' value: 97.78617901771737 - timestamp: '1788480000' value: 97.16087587752217 - timestamp: '1788566400' value: 96.61861438688956 - timestamp: '1788652800' value: 94.48730739785461 - timestamp: '1788739200' value: 93.78900803006077 - timestamp: '1788825600' value: 92.79688662388801 - timestamp: '1788912000' value: 96.00314285076313 - timestamp: '1788998400' value: 93.76990709664176 - timestamp: '1789084800' value: 94.47075494159995 - timestamp: '1789171200' value: 93.16478214500383 publishCnt: 133133 representativeCountryProfile: - countryCode: US countryTgiScore: '772.74' timeRange: 90 videoList: - coverURL: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-37c799-sg/o0RvZ4ikUgEG2pBAiUwpbqaIcBKHqIhv8IEZl~tplv-noop.image?dr=18692&refresh_token=422d64be&x-expires=1789406686&x-signature=vgEvIaS7kvQkUjbdfJ4e%2F8co7F0%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=f193193c&idc=my&VideoID=v12044gd0000da8qi8nog65min45jang itemID: '7679106044861123854' vid: v12044gd0000da8qi8nog65min45jang videoURL: default: >- https://v16m-default.tiktokcdn.com/edef36d78f90f37934a26f3019e689c6/6aa82dde/video/tos/alisg/tos-alisg-ve-37c799-sg/okvHRipEBgARi4IlvqEmCa4qc2QpIHQUZBhGw/?a=0&bti=Nzg3NWYzLTQ6&&bt=1932&ft=cApXJCz7ThWHuZ-DLGZmo0P&mime_type=video_mp4&rc=O2U7aTw3aWk1OzYzO2hoNkBpamQ4cXA5cjt0ZDMzZzczNEBgY2AzYjNfX14xNF5iYDIxYSNrZzFmMmRrZjVhLS1kMS9zcw%3D%3D&vvpl=1&l=202609141924162B8853A12A292280698D&btag=e00088000&vid=v12044gd0000da8qi8nog65min45jang - coverURL: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-37c799-sg/oIZgogteAAfNgL7HNLerVUGKnOfCYIiIdpQHIe~tplv-noop.image?dr=18692&refresh_token=bcdf71c0&x-expires=1789406774&x-signature=ThBFYi0QG4J4jv2k4JgiiNVt3%2Fk%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=f193193c&idc=my&VideoID=v15044gf0000daflfovog65upemg41r0 itemID: '7682959389602450719' vid: v15044gf0000daflfovog65upemg41r0 videoURL: default: >- https://v16m-default.tiktokcdn.com/6891da3c6ab43dcc33c4ff176f49287b/6aa82e36/video/tos/alisg/tos-alisg-ve-37c799-sg/o0eUXINMiiGfQfxIMWLfHgfzgYNrRAK7VHBoLA/?a=0&bti=Nzg3NWYzLTQ6&&bt=1351&ft=cApXJCz7ThWHuZ-DLGZmo0P&mime_type=video_mp4&rc=NjZnZDUzNWk8OWg3aGVkNUBpMzRqaHg5cnJvZDMzaTczNEBjMzNfXzVhXl4xNC1gLi5hYSNvMWptMmRzY2NhLS1kMTJzcw%3D%3D&vvpl=1&l=202609141924162B8853A12A292280698D&btag=e00088000&vid=v15044gf0000daflfovog65upemg41r0 - coverURL: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-37c799-sg/o4QZFjCVeJnyQF69428DHADIkzHfAu1AgQ06Ee~tplv-noop.image?dr=18692&refresh_token=791be51b&x-expires=1789406755&x-signature=OCqtyTOW1TQeKfwKQxFzvip2Oo4%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=f193193c&idc=my&VideoID=v12044gd0000da9u8bnog65sdfa1qptg itemID: '7679732439601696013' vid: v12044gd0000da9u8bnog65sdfa1qptg videoURL: default: >- https://v16m-default.tiktokcdn.com/f81acf4db71e5f3550644b40a70c720b/6aa82e23/video/tos/alisg/tos-alisg-ve-37c799-sg/ocATP75GgiEFyLaTLaB94UvkLE8pQPdgBiZIQ/?a=0&bti=Nzg3NWYzLTQ6&&bt=516&ft=cApXJCz7ThWHuZ-DLGZmo0P&mime_type=video_mp4&rc=aDdnN2Y1PDg8PGY4M2loOEBpanM0aXY5cmV4ZDMzZzczNEA1NDFfYDBeXmIxLl8xMmAyYSNxbl5hMmRrNTZhLS1kMS9zcw%3D%3D&vvpl=1&l=202609141924162B8853A12A292280698D&btag=e00088000&vid=v12044gd0000da9u8bnog65sdfa1qptg - coverURL: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-37c799-sg/oMCiTmbBiVg8araIaUPikZBAt4EIXpc3yUKFH~tplv-noop.image?dr=18692&refresh_token=24622579&x-expires=1789406740&x-signature=925Bgw3gDoLtR7sHhpLZ5HhpPik%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=f193193c&idc=my&VideoID=v12044gd0000daatiq7og65sp9gtp4lg itemID: '7680286859620109582' vid: v12044gd0000daatiq7og65sp9gtp4lg videoURL: default: >- https://v16m-default.tiktokcdn.com/1df61bc40267886db85c5ff53f426816/6aa82e14/video/tos/alisg/tos-alisg-ve-37c799-sg/ocWE5EFlJQD4o5gAlWSgfMElqrIfR7ODSXQduB/?a=0&bti=Nzg3NWYzLTQ6&&bt=1129&ft=cApXJCz7ThWHuZ-DLGZmo0P&mime_type=video_mp4&rc=aDZpNzk2NjRpaGRnNjVnZkBpajd3PHY5cnR3ZDMzZzczNEAzYGBiMC5jX18xYjMvXi8xYSNpbWRtMmQ0Zl5hLS1kMS9zcw%3D%3D&vvpl=1&l=202609141924162B8853A12A292280698D&btag=e00088000&vid=v12044gd0000daatiq7og65sp9gtp4lg - coverURL: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-37c799-sg/osOOqQNQG3Oz5Cz1AIetAZGf4LfIFVIIXBEjmd~tplv-noop.image?dr=18692&refresh_token=df64ab59&x-expires=1789406717&x-signature=pRHbaOVCamPRbxeduHoF3rJf6Fg%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=f193193c&idc=my&VideoID=v15044gf0000daesspnog65gfp3foqh0 itemID: '7682523871559437598' vid: v15044gf0000daesspnog65gfp3foqh0 videoURL: default: >- https://v16m-default.tiktokcdn.com/7ac546a8bf8a727e40c327f7c5014adc/6aa82dfd/video/tos/alisg/tos-alisg-ve-37c799-sg/ocfzQqEfNGAgnIqjn5LBIjVg0I4A1CLOI3eB7I/?a=0&bti=Nzg3NWYzLTQ6&&bt=2857&ft=cApXJCz7ThWHuZ-DLGZmo0P&mime_type=video_mp4&rc=ZGc3NDg3NTdmNmhpN2llO0BpM3Rpc2o5cnN2ZDMzaTczNEAyNDEtYS9gXzIxM2AuL2AtYSNlbDBjMmRrcGJhLS1kMTJzcw%3D%3D&vvpl=1&l=202609141924162B8853A12A292280698D&btag=e00088000&vid=v15044gf0000daesspnog65gfp3foqh0 - coverURL: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-37c799-sg/o08STuWEV3RADQQQPBFqABuDgOSIfDmbfgkEFy~tplv-noop.image?dr=18692&refresh_token=6563c39e&x-expires=1789406732&x-signature=vpCHrK6B66Zp69G0fcKxRy7ZT4A%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=f193193c&idc=my&VideoID=v12044gd0000da90b4vog65pbms05u3g itemID: '7679206482969218317' vid: v12044gd0000da90b4vog65pbms05u3g videoURL: default: >- https://v16m-default.tiktokcdn.com/2682a8245324c0280aec274628f89632/6aa82e0c/video/tos/alisg/tos-alisg-ve-37c799-sg/ooqvShkuTB8QgAFRyDFI35RgHkEAgpfseWCDEO/?a=0&bti=Nzg3NWYzLTQ6&&bt=408&ft=cApXJCz7ThWHuZ-DLGZmo0P&mime_type=video_mp4&rc=MzxnaGdoPDk5aWc8aTg7PEBpangzcHM5cjczZDMzZzczNEAvLWIzXl4wNS8xXmI1MzE0YSMwMnBfMmRzXzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202609141924162B8853A12A292280698D&btag=e00088000&vid=v12044gd0000da90b4vog65pbms05u3g - coverURL: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-37c799-sg/owfQXLuAEEBEvNAK6PDPVqQ7lQe5xnR45FoEuo~tplv-noop.image?dr=18692&refresh_token=aecc21a3&x-expires=1789406707&x-signature=drw0r5Q7AHtjrDcsnedpkvP95fs%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=f193193c&idc=my&VideoID=v15044gf0000dabpsrnog65t2l10d7q0 itemID: '7680783222413757727' vid: v15044gf0000dabpsrnog65t2l10d7q0 videoURL: default: >- https://v16m-default.tiktokcdn.com/bc7c2952e98384ced187d451e60451ae/6aa82df3/video/tos/alisg/tos-alisg-ve-37c799-sg/ogGWnbiEIiA1bxSvUoiqXGKG0BeIyCAFBA8IQ9/?a=0&bti=Nzg3NWYzLTQ6&&bt=1013&ft=cApXJCz7ThWHuZ-DLGZmo0P&mime_type=video_mp4&rc=NztkMzo2Z2U5ZTc2Mzs6M0BpMzozb3c5cnVzZDMzaTczNEA2M2NiLjVeNS0xLjEwNjIxYSNuYS4vMmRrcF9hLS1kMTJzcw%3D%3D&vvpl=1&l=202609141924162B8853A12A292280698D&btag=e00088000&vid=v15044gf0000dabpsrnog65t2l10d7q0 - coverURL: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-37c799-sg/o4QIzFVEfCyzIxD0QfFiZqEAExfFcMjG2MsAjE~tplv-noop.image?dr=18692&refresh_token=5f37222f&x-expires=1789406781&x-signature=%2FhJ1FG62bbsku%2FFbE8fzAgGHxLE%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=f193193c&idc=my&VideoID=v15044gf0000dacvm1nog65hh0n3mpn0 itemID: '7681447994075532574' vid: v15044gf0000dacvm1nog65hh0n3mpn0 videoURL: default: >- https://v16m-default.tiktokcdn.com/4cd28e95b546530d1dcc462ada7971d3/6aa82e3d/video/tos/alisg/tos-alisg-ve-37c799-sg/oQIIIMGq3IAfzabF2lfszfglcAEjECDMVQxjIF/?a=0&bti=Nzg3NWYzLTQ6&&bt=852&ft=cApXJCz7ThWHuZ-DLGZmo0P&mime_type=video_mp4&rc=NDk0PGYzOjZkNDdkNWk5ZEBpM3M2M2s5cjR5ZDMzaTczNEAyMl82LzYxNjMxLTVhMi9hYSNramtlMmRramBhLS1kMTJzcw%3D%3D&vvpl=1&l=202609141924162B8853A12A292280698D&btag=e00088000&vid=v15044gf0000dacvm1nog65hh0n3mpn0 - coverURL: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-37c799-sg/oUTLoICOIUjqMvoblees5QXgVOSguG2fOCIAAI~tplv-noop.image?dr=18692&refresh_token=dde82930&x-expires=1789406687&x-signature=6T0COqOkDOdYEzdl37mUMpAXIic%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=f193193c&idc=my&VideoID=v15044gf0000daebrrfog65vb5q0e9q0 itemID: '7682226614578580766' vid: v15044gf0000daebrrfog65vb5q0e9q0 videoURL: default: >- https://v16m-default.tiktokcdn.com/6f7ad75db820f1753b58987260b9e742/6aa82ddf/video/tos/alisg/tos-alisg-ve-37c799-sg/o4DZJFEEIEAqt4nfXwFVc3SH0J3Q2EAWDBLRQf/?a=0&bti=Nzg3NWYzLTQ6&&bt=880&ft=cApXJCz7ThWHuZ-DLGZmo0P&mime_type=video_mp4&rc=PDk4MzxnNTQ3aDdnPDZkO0BpMzwzOHk5cnVlZDMzaTczNEAvMy4yYTQ2Xl8xYTVgLl8yYSNuYm5fMmRjb2JhLS1kMTJzcw%3D%3D&vvpl=1&l=202609141924162B8853A12A292280698D&btag=e00088000&vid=v15044gf0000daebrrfog65vb5q0e9q0 - coverURL: >- https://p16-common-sign.tiktokcdn.com/tos-alisg-p-37c799-sg/ogFYbIfqpAjVE3kHExoAVRDBVoIfQZoRESiAQD~tplv-noop.image?dr=18692&refresh_token=4b99c60b&x-expires=1789406697&x-signature=wyjUORCiWRZxMo1oouJeu4b6jG4%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=f193193c&idc=my&VideoID=v15044gf0000dai0c97og65okl2glrog itemID: '7684274290937597214' vid: v15044gf0000dai0c97og65okl2glrog videoURL: default: >- https://v16m-default.tiktokcdn.com/08e735db11fcbb0ff59fdebf9c122d04/6aa82de9/video/tos/alisg/tos-alisg-ve-37c799-sg/osIiGpE4EivJRxVkABQQUAQKWVBdU7OakqBPF/?a=0&bti=Nzg3NWYzLTQ6&&bt=1028&ft=cApXJCz7ThWHuZ-DLGZmo0P&mime_type=video_mp4&rc=ZGczZDk8Nmg0OjY8Njo1OkBpanVqb3I5cjwzZDMzaTczNEBjM19eYmM2NmExXmNgMzRjYSNsaS9oMmQ0YGZhLS1kMTJzcw%3D%3D&vvpl=1&l=202609141924162B8853A12A292280698D&btag=e00088000&vid=v15044gf0000dai0c97og65okl2glrog vv: 202206946 requestId: 294aa65d-d227-43bb-b7f0-128775c7c503 headers: {} '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' deprecated: false security: - JWT Bearer: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request GET \ --url 'https://api.keyapi.ai/v1/tk-ads/trends_hashtag_detail?hashtagID=7126660302946435118&countryCode=US&timeRange=90' \ --header 'Authorization: Bearer ' - lang: python label: Python source: |- import requests response = requests.get( 'https://api.keyapi.ai/v1/tk-ads/trends_hashtag_detail', params={"hashtagID":"7126660302946435118","countryCode":"US","timeRange":90}, headers={'Authorization': 'Bearer '} ) print(response.json()) - lang: javascript label: JavaScript source: >- const params = new URLSearchParams({"hashtagID":"7126660302946435118","countryCode":"US","timeRange":90}); const response = await fetch(`https://api.keyapi.ai/v1/tk-ads/trends_hashtag_detail?${params}`, { method: 'GET', headers: { 'Authorization': 'Bearer ' } }); const data = await response.json(); console.log(data); components: responses: '400': description: Bad Request content: application/json: schema: type: object example: code: 400 data: null message: 'Missing required parameter: handle' '401': description: Unauthorized content: application/json: schema: type: object example: code: 401 data: null message: apiKey is null '402': description: Payment Required content: application/json: schema: type: object example: code: 402 data: null message: apiKey quota is not enough '429': description: Too Many Requests content: application/json: schema: type: object example: code: 429 data: null message: qps limit exceeded '500': description: Internal Server Error content: application/json: schema: type: object example: code: 500 data: null message: Internal server error securitySchemes: JWT Bearer: type: http scheme: bearer bearerFormat: JWT description: |- API key for authentication. Format: `sk_live_xxxxxxxxxxxxx` Get your API key from the [Dashboard](http://keyapi.ai/app/dashboard). ````