> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trending Songs

> Trending songs/sounds ranked by usage (served via the on-device signer path).

<Note>
  Trending songs are served via an on-device signer path and ranked by real usage (the mobile hot-music feed).
</Note>

<Note>
  Each request costs **5 credits**. Failed requests are not charged.
</Note>


## OpenAPI

````yaml GET /v1/tiktok/trending/songs
openapi: 3.1.0
info:
  title: ScrapeBadger TikTok API
  version: 1.0.0
  description: >-
    TikTok scraping API for user profiles, videos, comments, transcripts,
    hashtags, music/sounds, search, trending, and the EU Commercial Content (ad
    transparency) library. Returns clean structured JSON; handles signing,
    anti-bot bypass, and regional proxy routing automatically.
servers:
  - url: https://scrapebadger.com
    description: Production
security:
  - apiKeyAuth: []
paths:
  /v1/tiktok/trending/songs:
    get:
      tags:
        - TikTok Trending
      summary: Trending Songs
      description: >-
        Trending songs/sounds ranked by usage (served via the on-device signer
        path — hot-music feed).
      operationId: getTikTokTrendingSongs
      parameters:
        - name: region
          in: query
          schema:
            type: string
            default: US
          description: >-
            Content region (ISO 3166-1 alpha-2). Routes the request through a
            proxy and signer for that locale.
        - name: period
          in: query
          schema:
            type: integer
            default: 7
          description: Look-back window in days for the trend ranking (e.g. 7, 30, 120).
        - name: count
          in: query
          schema:
            type: integer
            default: 20
            minimum: 1
            maximum: 50
          description: Maximum number of items to return (1-50).
      responses:
        '200':
          description: Trending songs
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrendingSongsResponse'
              example:
                songs:
                  - title: Espresso
                    id: '7011111111111111111'
                    author: Sabrina Carpenter
                    rank: 1
                    rank_diff: 2
                    country_code: US
                    duration: 175
                    user_count: 1800000
                    cover: https://p16-sign.tiktokcdn-us.com/song.jpeg
                    play_url: https://sf16-sg.tiktokcdn.com/song.mp3
                    is_new: false
                    link: https://www.tiktok.com/music/Espresso-7011111111111111111
                region: US
components:
  schemas:
    TrendingSongsResponse:
      type: object
      properties:
        songs:
          type: array
          items:
            $ref: '#/components/schemas/TikTokTrendingSong'
        region:
          type: string
      required:
        - region
    TikTokTrendingSong:
      type: object
      properties:
        title:
          type: string
        id:
          type: string
        author:
          type: string
        rank:
          type: integer
        rank_diff:
          type: integer
        country_code:
          type: string
        duration:
          type: integer
        user_count:
          type: integer
          description: Videos using this sound.
        cover:
          type: string
        play_url:
          type: string
        is_new:
          type: boolean
        link:
          type: string
      description: A trending song/sound entry.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````