> ## Documentation Index > Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt > Use this file to discover all available pages before exploring further. # Get popular songs > Get trending songs from TikTok's Creative Center. Note: this endpoint can take up to 30 seconds to respond. 💳 **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/tiktok/music/popular openapi: 3.1.0 info: title: SociaVault API version: 1.0.0 description: >- # SociaVault API Documentation The SociaVault API provides comprehensive access to social media data extraction across multiple platforms. ## Features - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter, Reddit, Threads, and more - **Credit-Based System**: Pay-as-you-go pricing with transparent credit costs - **High Performance**: Fast, reliable data extraction - **Comprehensive Data**: Detailed user profiles, videos, posts, comments, and analytics ## Authentication All API requests require authentication using an API key in the `X-API-Key` header: ```bash X-API-Key: sk_live_your_api_key_here ``` Get your API key from the [SociaVault Dashboard](https://sociavault.com/dashboard). ## Credits Each endpoint consumes credits based on data complexity: - Simple requests (profiles): 1 credit - Complex requests (demographics): 20+ credits - Paginated requests: Credits per page Check your credit balance in the dashboard or via the API. ## Support - **Documentation**: https://docs.sociavault.com - **Email**: support@sociavault.com - **Discord**: https://discord.gg/sociavault contact: name: SociaVault Support email: support@sociavault.com url: https://sociavault.com/support license: name: Commercial url: https://sociavault.com/terms servers: - url: https://api.sociavault.com description: Production API security: - ApiKeyAuth: [] tags: - name: account description: Account management and credit balance externalDocs: description: Learn more url: https://docs.sociavault.com/account - name: tiktok description: Scrape TikTok profiles, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok - name: tiktok-shop description: Everything about TikTok Shop externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok-shop - name: instagram description: Gets Instagram profiles, posts, and reels externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/instagram - name: youtube description: Scrape YouTube channels, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/youtube - name: linkedin description: Scrape LinkedIn externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedin - name: facebook description: Get public Facebook profiles and posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebook - name: facebookAdLibrary description: Scrapes the Facebook (Meta) Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookAdLibrary - name: facebookMarketplace description: Search Facebook Marketplace and pull full listing details externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookMarketplace - name: googleAdLibrary description: >- Scrape the Google Ad Transparency Library. *This only gets the public ads. Some ads you need to log in for and sadly we can't get those. Also, since there are so many variations, the return types might not all be 100% the same. externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/googleAdLibrary - name: linkedinAdLibrary description: Search the LinkedIn Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedinAdLibrary - name: twitter description: Get Twitter profiles, tweets, followers and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/twitter - name: reddit description: Scrape Reddit posts and comments externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/reddit - name: threads description: Get Threads posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/threads - name: google description: Scrape Google search results externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/google paths: /v1/scrape/tiktok/music/popular: get: tags: - tiktok summary: Get popular songs description: >- Get trending songs from TikTok's Creative Center. Note: this endpoint can take up to 30 seconds to respond. operationId: tiktok_Get_popular_songs parameters: - name: page in: query description: Page number required: false schema: type: integer example: 1 - name: timePeriod in: query description: Time period to get popular songs from required: false schema: type: string enum: - '7' - '30' - '130' example: 7 - name: rankType in: query description: Get popular or surging songs required: false schema: type: string enum: - popular - surging example: popular - name: newOnBoard in: query description: New to top 100 required: false schema: type: boolean - name: commercialMusic in: query description: Approved for business use? required: false schema: type: boolean - name: countryCode in: query description: Country code to get popular songs from required: false schema: type: string enum: - AR - AU - AT - BH - BD - BY - BE - BR - BG - KH - CA - CL - CO - HR - CZ - DK - EG - EE - FI - FR - DE - GR - HU - IS - ID - IQ - IE - IL - IT - JP - JO - KZ - KW - LV - LB - LT - LU - MO - MY - MX - MA - MM - NL - NZ - NG - 'NO' - OM - PK - PE - PH - PL - PT - QA - RO - SA - SG - SK - ZA - KR - ES - SE - CH - TW - TH - TR - UA - AE - GB - US - UZ - VN example: US responses: '200': description: >- Successful response **Key Response Fields:** - `data.sound_list[].title`: Song title - `data.sound_list[].author`: Artist name - `data.sound_list[].clip_id`: Unique clip ID - `data.sound_list[].song_id`: Unique song ID - `data.sound_list[].cover`: Album/cover art URL (720x720) - `data.sound_list[].duration`: Clip duration in seconds - `data.sound_list[].link`: Direct TikTok music page URL - `data.sound_list[].rank`: Current position on the chart - `data.sound_list[].rank_diff`: Change in rank since last period (`null` if new) - `data.sound_list[].country_code`: 2-letter country code (e.g. `US`) - `data.sound_list[].promoted`: Whether the song is being promoted - `data.sound_list[].if_cml`: Whether the song is approved for commercial/business use - `data.sound_list[].trend[]`: Popularity trend data over time — each entry has `time` (Unix timestamp) and `value` (relative popularity 0–1) - `data.sound_list[].related_items[]`: Sample videos using this sound — each has `item_id` (video ID) and `cover_uri` (thumbnail URL) - `data.pagination.page`: Current page number - `data.pagination.size`: Items per page - `data.pagination.total`: Total number of songs available - `data.pagination.has_more`: Whether more pages exist content: application/json: example: success: true data: success: true pagination: page: 1 size: 20 total: 99 has_more: true sound_list: '0': author: Bad Bunny clip_id: '7456415250359977985' country_code: US cover: >- https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/oQf9COv1EdtdFFZBgAgEAAD0V3AfCoDlaELfzu.jpeg duration: 60 if_cml: false is_search: false link: https://www.tiktok.com/music/x-7456415250359977985 on_list_times: null promoted: false rank: 1 rank_diff: null rank_diff_type: 4 related_items: '0': item_id: 7603178147533983000 cover_uri: >- https://p16-sign-sg.tiktokcdn.com/tos-alisg-p-0037/ogwzpDOifoIVgMkpASDIR6kiGfOiDsEcBBvBgV~tplv-noop.image?dr=18692&refresh_token=404e5835&x-expires=1770602246&x-signature=wKmbDtrs%2FwscIhRthuDK9fknCYg%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v1c044g50000d61uekfog65g996dalng '1': item_id: 7602758701946015000 cover_uri: >- https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/o8A4Wmlv3MY6bEOcBrIEaCiBBJxh1wyUiiPg5~tplv-noop.image?dr=18692&refresh_token=9485d2be&x-expires=1770602294&x-signature=vjj61NRPf0Namf9DmE0q%2BsxdPx0%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v12044gd0000d616n27og65qst9jfio0 '2': item_id: 7602736294757715000 cover_uri: >- https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/owBZgWBhiOicIx9NJEIURMisIyCvYaybAyB4V~tplv-noop.image?dr=18692&refresh_token=6b46f046&x-expires=1770602255&x-signature=OKNsKkgMGxYxWVr%2FW%2B9h65vfAXs%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v12044gd0000d615apnog65i8o9ophug '3': item_id: 7602788189702540000 cover_uri: >- https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/oAvTyfyNTAzTIjKKAQL2BDkGjeAeL2QIHICsFQ~tplv-noop.image?dr=18692&refresh_token=0e584db2&x-expires=1770602240&x-signature=8EpQDTeFCWm8xsx%2F%2FKWUaftEnfI%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v12044gd0000d618ckfog65kts0d5vdg song_id: '7456422804994459649' title: DtMF trend: '0': time: 1769904000 value: 0.2 '1': time: 1769990400 value: 0.21 '2': time: 1770076800 value: 0.25 '3': time: 1770163200 value: 0.33 '4': time: 1770249600 value: 0.38 '5': time: 1770336000 value: 0.33 '6': time: 1770422400 value: 1 url_title: DtMF credits_used: 1 endpoint: tiktok/popular/songs note: Can take up to 30 seconds to complete '400': description: Bad Request - Invalid parameters or missing required fields content: application/json: schema: type: object properties: error: type: string example: 'Missing required parameter: handle' endpoint: type: string credits_required: type: integer required: - error '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: type: object properties: error: type: string example: Invalid API key docs: type: string example: https://docs.sociavault.com/authentication required: - error '402': description: Payment Required - Insufficient credits content: application/json: schema: type: object properties: error: type: string example: Insufficient credits required: type: integer example: 1 description: Credits required for this request available: type: integer example: 0 description: Credits currently available required: - error - required - available '500': description: Internal Server Error - Service configuration or processing error content: application/json: schema: type: object properties: error: type: string example: Service configuration error required: - error components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: |- API key for authentication. Format: `sk_live_xxxxxxxxxxxxx` Get your API key from the [Dashboard](https://sociavault.com/dashboard). ````