> ## 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 Topics > Retrieve all available Instagram topics with their categories and creator count. Topics are used for categorizing Instagram creators based on their content themes. Topics are broader than niches. Every Instagram topic ID ends in `_instagram`. ## OpenAPI ````yaml /api-v3/api-v3.yaml get /instagram/topics 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: 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: /instagram/topics: get: tags: - Instagram summary: List Topics description: >- Retrieve all available Instagram topics with their categories and creator count. Topics are used for categorizing Instagram creators based on their content themes. Topics are broader than niches. Every Instagram topic ID ends in `_instagram`. operationId: getInstagramTopics responses: '200': description: Instagram topics data returned successfully. content: application/json: schema: type: object description: Instagram Topics API response with all available topics. properties: data: type: array description: Instagram topics. items: type: object description: Instagram topic item with metadata. properties: id: type: string description: The unique identifier of the topic. examples: - id_lifestyle_HowtoStyle_instagram name: type: string description: The topic name. examples: - Lifestyle category: type: string description: Category classifications. examples: - Howto & Style channelCount: type: integer description: >- Number of creators associated with this Instagram topic. minimum: 0 examples: - 204145 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: - -1 planCreditsAvailable: type: number description: Remaining plan credits after this request, in credits. examples: - 900 purchasedCreditsAvailable: type: number description: >- Remaining purchased-bucket credits after this request, in display units. 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: id_lifestyle_HowtoStyle_instagram name: Lifestyle category: Howto & Style channelCount: 204145 - id: id_beauty_HowtoStyle_instagram name: Beauty category: Howto & Style channelCount: 188822 - id: id_fashion_HowtoStyle_instagram name: Fashion category: Howto & Style channelCount: 186065 - id: id_makeup_HowtoStyle_instagram name: Makeup category: Howto & Style channelCount: 92344 - id: id_hair_HowtoStyle_instagram name: Hair category: Howto & Style channelCount: 90529 - id: id_cooking_HowtoStyle_instagram name: Cooking category: Howto & Style channelCount: 87309 - id: id_photography_HowtoStyle_instagram name: Photography category: Howto & Style channelCount: 74320 - id: id_skincare_HowtoStyle_instagram name: Skincare category: Howto & Style channelCount: 73341 creditsUsed: 1 creditsAvailable: 975 planCreditsAvailable: 900 purchasedCreditsAvailable: 75 traceId: 0f58e95d22ea888a76166ecf6bb251ef timestamp: 1772075633067 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/instagram/topics" \ -H "api-key: " 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.