> ## Documentation Index
> Fetch the complete documentation index at: https://scrapebadger-feat-flights-booking-options.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Trending Hashtags

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

<Note>
  Trending hashtags are served via an on-device signer path and ranked by real usage (view counts and distinct-creator counts), not the deprecated Creative Center trend lists.
</Note>

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


## OpenAPI

````yaml GET /v1/tiktok/trending/hashtags
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/hashtags:
    get:
      tags:
        - TikTok Trending
      summary: Trending Hashtags
      description: >-
        Trending hashtags ranked by usage (served via the on-device signer path
        — view counts and distinct-creator counts).
      operationId: getTikTokTrendingHashtags
      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 hashtags
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrendingHashtagsResponse'
              example:
                hashtags:
                  - name: fyp
                    id: '229207'
                    rank: 1
                    rank_diff: 0
                    country_code: US
                    industry: Entertainment
                    publish_count: 120000
                    view_count: 55000000000
                    user_count: 98000
                    is_promoted: false
                    is_new: false
                    url: https://www.tiktok.com/tag/fyp
                region: US
components:
  schemas:
    TrendingHashtagsResponse:
      type: object
      properties:
        hashtags:
          type: array
          items:
            $ref: '#/components/schemas/TikTokTrendingHashtag'
        region:
          type: string
      required:
        - region
    TikTokTrendingHashtag:
      type: object
      properties:
        name:
          type: string
        id:
          type: string
        rank:
          type: integer
        rank_diff:
          type: integer
          description: Change in rank vs prior period.
        country_code:
          type: string
        industry:
          type: string
        publish_count:
          type: integer
          description: Videos using it.
        view_count:
          type: integer
        user_count:
          type: integer
          description: Distinct creators using it.
        is_promoted:
          type: boolean
        is_new:
          type: boolean
        url:
          type: string
      description: A trending hashtag entry.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````