> ## Documentation Index > Fetch the complete documentation index at: https://docs.topyappers.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Creators by ID (v2) > Fetch full creator profiles by passing userIds returned from the search endpoint. ## OpenAPI ````yaml POST /api/v2/creators/get openapi: 3.1.0 info: title: Creators API description: >- Creators API — v1 GET and v2 search share the same query parameters (posting cadence, average video duration, monetization post counts, demographics, etc.). Creator objects in responses use **snake_case** keys (see `Creator` schema). license: name: MIT version: 1.0.0 servers: - url: https://api.topyappers.com security: - apiKeyAuth: [] paths: /api/v2/creators/get: post: summary: Get creators by IDs description: >- Fetch full creator profiles by passing userIds returned from the search endpoint. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GetCreatorsRequest' responses: '200': description: >- Successful response from the public API (`message`, echoed `requestedIds`, and `response` containing paginated creator objects in snake_case). content: application/json: schema: $ref: '#/components/schemas/V2CreatorsGetProxyResponse' '400': description: Unexpected error content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/RateLimitExceeded' components: schemas: GetCreatorsRequest: type: object description: >- POST body for `/api/v2/creators/get`. The live gateway accepts **`userIds`** (camelCase) or **`user_ids`** (snake_case). properties: userIds: type: array items: type: string description: Creator ids from search (e.g. `youtube_...`, `instagram_...`) user_ids: type: array items: type: string description: Snake_case alias for `userIds` (same values). required: - userIds V2CreatorsGetProxyResponse: type: object description: Envelope returned by `POST /api/v2/creators/get` on api.topyappers.com. required: - message - requestedIds - response properties: message: type: string example: OK requestedIds: type: array items: type: string description: Echo of ids from the request body. response: $ref: '#/components/schemas/CreatorsPageResult' Error: type: object required: - code - message properties: code: type: integer format: int32 message: type: string RateLimitExceeded: type: object required: - code - message properties: code: type: integer format: int32 message: type: string CreatorsPageResult: type: object description: >- Paginated list payload inside `response` (from the upstream `PageResultItem`). properties: data: type: array items: $ref: '#/components/schemas/Creator' page: type: integer example: 1 next_page: type: integer example: 0 total_pages: type: integer example: 1 total: type: integer description: Total hit count when provided is_trial: type: boolean description: True for demo/trial responses required: - data Creator: type: object description: >- Creator profile as returned by the API (snake_case, from influencer projection / index). Fields may be `null` when unknown; some index-only fields (e.g. `date_created_timestamp`) appear depending on data source. example: user_id: UCECuDLnD9j3y901oNxJFerw handle: April Apple Tech nickname: April Apple Tech bio: Tech review and business content. source: youtube email: null categories: - Tech Reviews - Gadget Reviews - Smartphone Comparisons - Business Technology followers: 2500 following: 0 total_videos: 296 total_likes: 0 avg_views: 35 avg_likes: 3 avg_comments: 1 engagement_rate: 0.11 main_website: null websites: [] description: null promoted_products: - DIHRAMS - iphone best_promotion_niches: - Consumer Electronics - Mobile Devices - Tech Accessories - Online Retailers - Business Software main_category: Technology country: United Arab Emirates date_created_timestamp: 1775636932.147 avatar_url: >- https://images.0xw.app/avatars/creators/bd6493d02eaf43ad9740efa20ec08cd1.png age: 10-19 gender: male account_type: ugc race: black hair_color: white body_complexion: hulk language: english hashtags: - iphone17 - cinimaticvideo - iphoneair - shotoniphone uploads_per_week: 0.39 uploads_per_month: 1.66 avg_video_duration_seconds: null promotions_count: 2 affiliate_posts_count: 0 sponsorship_posts_count: 0 required: - user_id - handle - nickname - avatar_url - followers - following - total_videos - total_likes - source - categories - websites - promoted_products - best_promotion_niches - avg_views - avg_likes - avg_comments - engagement_rate properties: user_id: type: string description: >- Stable creator id (includes platform prefix, e.g. youtube_, instagram_, tiktok_) handle: type: string description: Public handle / channel name nickname: type: string bio: type: - string - 'null' description: Profile bio text source: type: string enum: - tiktok - instagram - youtube description: Platform / data source email: type: - string - 'null' format: email categories: type: array items: type: string description: Detected content category labels followers: type: integer following: type: integer total_videos: type: integer total_likes: type: integer avg_views: type: number format: float avg_likes: type: number format: float avg_comments: type: number format: float engagement_rate: type: number format: float description: Engagement rate (ratio stored as fraction, e.g. 0.11 = 11%) main_website: type: - string - 'null' websites: type: array items: type: string description: type: - string - 'null' description: Longer description when available (distinct from bio) promoted_products: type: array items: type: string best_promotion_niches: type: array items: type: string description: AI-derived niches the creator is suited to promote main_category: type: - string - 'null' description: Primary canonical category country: type: - string - 'null' date_created_timestamp: type: - number - 'null' format: double description: >- Unix timestamp (seconds) for creator record creation when provided by index avatar_url: type: string format: uri age: type: - string - 'null' description: Age bucket, e.g. 20-29 gender: type: - string - 'null' account_type: type: - string - 'null' description: >- Creator account type when classified: `faceless`, `ugc`, `agc`, `clipper`, `brand` race: type: - string - 'null' hair_color: type: - string - 'null' body_complexion: type: - string - 'null' language: type: - string - 'null' description: Primary content language (lowercase) example: english hashtags: type: array items: type: string description: Top hashtags used by the creator uploads_per_week: type: - number - 'null' format: float description: Average posts per week (posting cadence) uploads_per_month: type: - number - 'null' format: float avg_video_duration_seconds: type: - number - 'null' format: float description: Average video length in seconds across analyzed content promotions_count: type: - integer - 'null' description: Promotion-type posts in analyzed sample affiliate_posts_count: type: - integer - 'null' sponsorship_posts_count: type: - integer - 'null' securitySchemes: apiKeyAuth: type: apiKey in: header name: x-ty-api-key description: API key for TopYappers API authentication ````