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

# List Hashtags

> Retrieve the hashtags used by the most TikTok creators in CreatorDB, with the number of creators using each, most-used first. Pass an `id` unchanged as a `hashtags` search filter value.



## OpenAPI

````yaml /api-v3/api-v3.yaml get /tiktok/hashtags
openapi: 3.1.0
info:
  version: 1.0.0
  title: CreatorDB Headless API V3
  description: '# CreatorDB Headless API V3'
  contact:
    name: CreatorDB
    url: https://www.creatordb.app
    email: support@creatordb.app
  license:
    url: http://www.apache.org/licenses/LICENSE-2.0.html
    name: Apache 2.0
servers:
  - url: https://apiv3.creatordb.app
    description: Production Environment (CreatorDB Headless API V3)
security:
  - ApiKeyAuth: []
tags:
  - name: Creator
    description: >-
      Cross-platform creator endpoints. Each result is one creator, with their
      linked YouTube, Instagram, and TikTok accounts grouped together.
  - name: General operations
    description: >-
      General-purpose endpoints such as API status, content retrieval, and
      cross-platform operations.
  - name: Instagram
    description: >-
      Instagram creator data endpoints with metrics and advanced search
      capabilities.
  - name: Sponsor
    description: Sponsor analysis endpoints including sponsor search and sponsor reports.
  - name: TikTok
    description: >-
      TikTok creator data endpoints with metrics and advanced search
      functionality.
  - name: YouTube
    description: >-
      YouTube creator data endpoints including basic metrics, historical data,
      and detailed analytics.
paths:
  /tiktok/hashtags:
    get:
      tags:
        - TikTok
      summary: List Hashtags
      description: >-
        Retrieve the hashtags used by the most TikTok creators in CreatorDB,
        with the number of creators using each, most-used first. Pass an `id`
        unchanged as a `hashtags` search filter value.
      operationId: getTiktokHashtags
      responses:
        '200':
          description: TikTok hashtags data returned successfully.
          content:
            application/json:
              schema:
                type: object
                description: TikTok Hashtags API response with the hashtag catalog.
                properties:
                  data:
                    type: array
                    description: TikTok hashtags, most-used first. Up to 40,000 entries.
                    items:
                      type: object
                      description: Hashtag with metadata.
                      properties:
                        id:
                          type: string
                          description: >-
                            The hashtag, including the `#`. Pass it unchanged as
                            a `hashtags` search filter value. The filter ignores
                            the `#` and letter case.
                          examples:
                            - '#fyp'
                        name:
                          type: string
                          description: Display name. Same as `id`.
                          examples:
                            - '#fyp'
                        category:
                          type: string
                          description: Always `All`. Hashtags have no categories.
                          examples:
                            - All
                        channelCount:
                          type: integer
                          description: Number of creators on TikTok who use this hashtag.
                          minimum: 0
                          examples:
                            - 2093188
                      required:
                        - id
                        - name
                        - category
                        - channelCount
                  creditsUsed:
                    type: number
                    description: Number of API credits consumed by this request.
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: >-
                      Number of API credits remaining. Equals
                      planCreditsAvailable plus purchasedCreditsAvailable.
                    examples:
                      - 975
                  planCreditsAvailable:
                    type: number
                    description: Plan credits remaining after this request.
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: Purchased credits remaining after this request.
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: >-
                      Remaining credits this API key can spend after this
                      request, before reaching its spend limit. Present only
                      when the key has a spend limit.
                    examples:
                      - 4975
                  traceId:
                    type: string
                    description: Unique trace ID for each request.
                    examples:
                      - f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0
                  timestamp:
                    type: integer
                    description: >-
                      Time the response was generated, represented as a Unix
                      timestamp in milliseconds.
                    examples:
                      - 1750732453635
                  errorCode:
                    type: string
                    description: >-
                      Error code returned if the request fails. Empty if the
                      request is successful.
                    examples:
                      - ''
                  errorDescription:
                    type: string
                    description: >-
                      Description of the error. Empty if the request is
                      successful.
                    examples:
                      - ''
                  success:
                    type: boolean
                    description: '`true` if the request is successful.'
                    examples:
                      - true
                required:
                  - data
                  - traceId
                  - timestamp
                  - errorCode
                  - errorDescription
                  - success
                  - creditsUsed
                  - creditsAvailable
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      - id: '#fyp'
                        name: '#fyp'
                        category: All
                        channelCount: 2093188
                      - id: '#capcut'
                        name: '#capcut'
                        category: All
                        channelCount: 1402362
                      - id: '#viral'
                        name: '#viral'
                        category: All
                        channelCount: 933440
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 0f58e95d22ea888a76166ecf6bb251ef
                    timestamp: 1790650819000
                    errorCode: ''
                    errorDescription: ''
                    success: true
        '400':
          description: >-
            The request is invalid. Validation errors return `ValidationError`
            in `error`, with a `details` array that lists each problem. Other
            invalid requests return `BadRequestError`.
          content:
            application/json:
              schema:
                type: object
                title: BadRequestErrorResponse
                properties:
                  success:
                    const: false
                  error:
                    type: string
                    enum:
                      - ValidationError
                      - BadRequestError
                    description: >-
                      The type of error. Use `errorCode` to handle errors in
                      your code.
                  message:
                    type: string
                    description: >-
                      Summary of the error. `Request validation failed` for
                      validation errors.
                  errorCode:
                    type: string
                    description: >-
                      Machine-readable error code, for example
                      `VALIDATION_ERROR`.
                  traceId:
                    type: string
                    description: Unique trace ID for each request.
                  timestamp:
                    type: integer
                    description: >-
                      Time the response was generated, represented as a Unix
                      timestamp in milliseconds.
                  details:
                    type: array
                    description: Validation errors only. One entry for each problem found.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          description: >-
                            Path of the request field with the problem, for
                            example `filters.0.filterName`. `unknown` when the
                            problem involves more than one field, such as a
                            missing identifier.
                        message:
                          type: string
                          description: Description of the problem.
                        value:
                          type: string
                          description: >-
                            The value received, when relevant. For example,
                            `Received: undefined` for a missing field.
                      required:
                        - field
                        - message
                required:
                  - success
                  - error
                  - message
                  - errorCode
                  - traceId
                  - timestamp
        '402':
          description: >-
            Insufficient credits, or the API key has reached its spend limit.
            Nothing is charged.
          content:
            application/json:
              schema:
                type: object
                title: PaymentRequiredErrorResponse
                properties:
                  success:
                    const: false
                  error:
                    type: string
                    description: >-
                      The type of error. Use `errorCode` to handle errors in
                      your code.
                  message:
                    type: string
                  errorCode:
                    type: string
                    enum:
                      - INSUFFICIENT_CREDITS
                      - KEY_SPEND_THRESHOLD_EXCEEDED
                  traceId:
                    type: string
                  timestamp:
                    type: integer
                  details:
                    type: object
                    properties:
                      creditsAvailable:
                        type: number
                        description: >-
                          For `INSUFFICIENT_CREDITS`, your remaining credit
                          balance. For `KEY_SPEND_THRESHOLD_EXCEEDED`, the
                          credits remaining under this key's spend limit.
                      creditsUsed:
                        type: number
                        description: Always `0`.
                required:
                  - success
                  - error
                  - message
                  - errorCode
                  - traceId
                  - timestamp
                  - details
              examples:
                insufficient credits:
                  summary: Credit balance exhausted
                  value:
                    success: false
                    error: PaymentRequiredError
                    message: Insufficient credits
                    errorCode: INSUFFICIENT_CREDITS
                    traceId: c4e5af55f3bb9d11cc20481bfc80c1df
                    timestamp: 1791959292593
                    details:
                      creditsAvailable: 0
                      creditsUsed: 0
                key spend limit:
                  summary: API key spend limit reached
                  value:
                    success: false
                    error: PaymentRequiredError
                    message: API key spending limit exceeded
                    errorCode: KEY_SPEND_THRESHOLD_EXCEEDED
                    traceId: c4e5af55f3bb9d11cc20481bfc80c1df
                    timestamp: 1791959292593
                    details:
                      creditsAvailable: 0
                      creditsUsed: 0
      security:
        - ApiKeyAuth: []
      servers:
        - url: https://apiv3.creatordb.app
          description: Production Environment (CreatorDB Headless API V3)
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X GET "https://apiv3.creatordb.app/tiktok/hashtags" \
              -H "api-key: <YOUR_API_KEY_HERE>"
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      description: The valid CreatorDB API key for authentication.
      name: api-key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.