> ## 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 Niches > Retrieve all available TikTok niche categories and their creator counts. Niches categorize creators by content themes. ## OpenAPI ````yaml /api-v3/api-v3.yaml get /tiktok/niches 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: Brand description: Brand analysis endpoints including sponsor search and brand reports. - name: Facebook description: Facebook creator data endpoints with metrics and search capabilities. - 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: Niches description: >- Niche-related endpoints for content category analysis and related searches. - name: Threads description: Threads creator data endpoints with basic metrics and historical data. - name: TikTok description: >- TikTok creator data endpoints with metrics and advanced search functionality. - name: Topic description: Topic-based analysis and reporting endpoints for content categorization. - name: YouTube description: >- YouTube creator data endpoints including basic metrics, historical data, and detailed analytics. paths: /tiktok/niches: get: tags: - TikTok summary: List Niches description: >- Retrieve all available TikTok niche categories and their creator counts. Niches categorize creators by content themes. operationId: getTiktokNiches responses: '200': description: TikTok niches data returned successfully. content: application/json: schema: type: object description: TikTok Niches API response with all available niches. properties: data: type: array description: TikTok niches. items: type: object description: Niche with metadata. properties: id: type: string description: The unique identifier. examples: - niche_Entertainment_Comedy name: type: string description: The niche name. examples: - Comedy category: type: string description: Category classifications. examples: - Entertainment channelCount: type: integer description: Number of creators associated with this niche. minimum: 0 examples: - 9012 required: - id - name - category - channelCount creditsUsed: type: integer description: Number of API credits consumed by this request. examples: - 1 creditsAvailable: type: integer description: Number of API credits remaining. examples: - -1 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 examples: default: value: data: - id: id_capcut_All name: Capcut category: All channelCount: 252193 - id: id_palagi_All name: Palagi category: All channelCount: 78266 - id: id_trending_All name: Trending category: All channelCount: 104173 - id: id_christmas_All name: Christmas category: All channelCount: 132159 - id: id_prepare_All name: Prepare category: All channelCount: 49884 - id: id_humor_All name: Humor category: All channelCount: 75487 - id: id_trend_All name: Trend category: All channelCount: 107639 - id: id_funny_All name: Funny category: All channelCount: 79880 - id: id_comedy_All name: Comedy category: All channelCount: 49504 - id: id_motivation_All name: Motivation category: All channelCount: 41842 traceId: 13b6aee50b7a305432c39a7baf7fe7a2 timestamp: 1772096850140 creditsAvailable: 9999 creditsUsed: 1 errorCode: '' errorDescription: '' success: true '400': description: Validation error. content: application/json: schema: type: object title: ValidationErrorResponse properties: success: const: false error: type: string message: type: string timestamp: type: integer required: - success - error - message - timestamp examples: unexpected parameter: summary: Unexpected query parameter value: success: false error: VALIDATION_ERROR message: Unrecognized query parameter. timestamp: 1770099403116 '429': description: Exceeded quota or rate limit. content: application/json: schema: type: object title: QuotaErrorResponse properties: success: const: false error: type: string message: type: string remainingPlanCredit: type: number required: - success - error - message - remainingPlanCredit examples: rate limit: summary: Rate limit exceeded value: success: false error: RATE_LIMIT_EXCEEDED message: Too many requests. Please try again later. quota exceeded: summary: Credit quota exceeded value: success: false error: QUOTA_EXCEEDED message: Not enough credits to complete this request. 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/niches" \ -H "Content-Type: application/json" \ -H "api-key: " components: securitySchemes: ApiKeyAuth: type: apiKey description: The valid CreatorDB API key for authentication. name: api-key in: header ````