> ## 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 YouTube niches with their categories and the number of creators. Niches provide more granular categorization of YouTube creators than topics. ## OpenAPI ````yaml /api-v3/api-v3.yaml get /youtube/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: /youtube/niches: get: tags: - YouTube summary: List Niches description: >- Retrieve all available YouTube niches with their categories and the number of creators. Niches provide more granular categorization of YouTube creators than topics. operationId: getYoutubeNiches responses: '200': description: YouTube niches data returned successfully. content: application/json: schema: type: object description: YouTube Niches API response with all available niches. properties: data: type: array description: YouTube niches. items: type: object description: Niche with metadata. properties: id: type: string description: The unique identifier. examples: - id_entertainment_Gaming name: type: string description: The niche name. examples: - Gaming category: type: string description: Category classifications. examples: - Entertainment channelCount: type: integer description: Number of creators associated with this niche. minimum: 0 examples: - 1234 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_vlog_PeopleBlogs name: Vlog category: People Blogs channelCount: 13004 - id: id_shorts_PeopleBlogs name: Shorts category: People Blogs channelCount: 7709 - id: id_love_PeopleBlogs name: Love category: People Blogs channelCount: 4153 - id: id_news_PeopleBlogs name: News category: People Blogs channelCount: 2605 - id: id_asmr_PeopleBlogs name: Asmr category: People Blogs channelCount: 4490 - id: id_viral_PeopleBlogs name: Viral category: People Blogs channelCount: 6626 - id: id_tiktok_PeopleBlogs name: Tiktok category: People Blogs channelCount: 4898 - id: id_food_PeopleBlogs name: Food category: People Blogs channelCount: 5136 - id: id_funny_PeopleBlogs name: Funny category: People Blogs channelCount: 4719 - id: id_family_PeopleBlogs name: Family category: People Blogs channelCount: 3208 traceId: aabd94f7ff9e2d0f3fc4e218abd692d0 timestamp: 1772076193778 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 description: Quota error response format. 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/youtube/niches" \ -H "api-key: " components: securitySchemes: ApiKeyAuth: type: apiKey description: The valid CreatorDB API key for authentication. name: api-key in: header ````