### GET /public/v1/accounts/credits/ Source: https://docs.influencers.club/openapi/account-credits-and-usage.md Retrieves the account's remaining and total consumed credits. ```APIDOC ## GET /public/v1/accounts/credits/ ### Description Use your API key to check your remaining credits and total credits used. ### Method GET ### Endpoint /public/v1/accounts/credits/ ### Response #### Success Response (200) - **credits_available** (integer) - remaining credits - **credits_used** (integer) - total credits consumed ### Response Example { "credits_available": 0, "credits_used": 100 } ``` -------------------------------- ### GET /public/v1/discovery/classifier/locations/{platform}/ Source: https://docs.influencers.club/openapi/dictionary/public_v1_discovery_classifier_locations_retrieve Retrieves a list of location identifiers for a given platform, with options for searching, filtering, and pagination. ```APIDOC ## GET /public/v1/discovery/classifier/locations/{platform}/ ### Description Retrieves a list of location identifiers available for a specific platform. These location strings can be used to filter creators by geographic location in discovery searches. Platform-specific location data helps target creators from specific regions, cities, or countries. Supports substring/prefix matching on location names and pagination. ### Method GET ### Endpoint /public/v1/discovery/classifier/locations/{platform}/ ### Parameters #### Path Parameters - **platform** (string) - Required - The platform for which to retrieve locations. #### Query Parameters - **search** (string) - Optional - Search string to filter results by location name. - **offset** (integer) - Optional - Cursor offset for pagination. - **limit** (integer) - Optional - Number of results to return per page (1-100). ### Response #### Success Response (200) - **locations** (array) - A list of location strings. - **next_offset** (integer) - The offset for the next page of results. - **next_url** (string) - The URL for the next page of results. #### Response Example { "locations": [ "New York", "London", "Tokyo" ], "next_offset": 3, "next_url": "/public/v1/discovery/classifier/locations/example_platform/?limit=3&offset=3" } ### Error Handling - **400**: Bad Request - **401**: Unauthorized - **422**: Unprocessable Entity ``` -------------------------------- ### GET /public/v1/enrichment/batch/{batch_id}/download/ Source: https://docs.influencers.club/openapi/batch-enrichment/public_v1_enrichment_batch_download_retrieve Retrieves a temporary presigned URL to download the enriched CSV dataset for a specified batch. This method is recommended for large files due to its speed and reliability. ```APIDOC ## GET /public/v1/enrichment/batch/{batch_id}/download/ ### Description Retrieves a temporary presigned URL to download the enriched CSV dataset for a specified batch. This method is recommended for large files due to its speed and reliability. ### Method GET ### Endpoint /public/v1/enrichment/batch/{batch_id}/download/ ### Parameters #### Path Parameters - **batch_id** (string, required) - Unique batch identifier returned when creating the enrichment batch ### Response #### Success Response (200) - **download_url** (string, required) - Temporary presigned S3 download URL - **filename** (string, required) - Suggested filename for the download - **expires_in** (integer, required) - URL expiration time in seconds - **expires_at** (string, required) - ISO 8601 timestamp when the URL expires - **batch_id** (string, required) - Unique identifier for the batch enrichment job - **total_results** (integer, required) - Number of enriched results in the file - **invalid_records** (integer, required) - Number of invalid records in the batch #### Response Example { "download_url": "https://example.com/path/to/your/file.csv?AWSAccessKeyId=...", "filename": "enrichment_results_batch_123.csv", "expires_in": 3600, "expires_at": "2023-10-27T10:00:00Z", "batch_id": "123e4567-e89b-12d3-a456-426614174000", "total_results": 1500, "invalid_records": 50 } ### Error Responses - **400 Bad Request** - Batch not completed yet or no results file available. - **404 Not Found** - Invalid batch ID or batch does not belong to the client. ``` -------------------------------- ### GET /public/v1/discovery/classifier/brands/ Source: https://docs.influencers.club/openapi/dictionary/public_v1_discovery_classifier_brands_list Retrieves a list of available brand names for use in creator discovery filters. This endpoint does not deduct credits. ```APIDOC ## GET /public/v1/discovery/classifier/brands/ ### Description Retrieve a comprehensive list of brand names available for filtering in creator discovery searches. Returns brand identifiers including full names, cleaned names, and usernames that can be used to find creators who have worked with specific brands or mentioned them in their content. Credits - 0 credits. This endpoint does not deduct credits. ### Method GET ### Endpoint /public/v1/discovery/classifier/brands/ ### Parameters ### Request Body ### Response #### Success Response (200) - `full_name` (string, required) - `cleaned` (string, required) - `username` (string, required) - The creator's username on the platform. #### Response Example { "example": "[response body]" } ``` -------------------------------- ### GET /public/v1/discovery/classifier/languages/ Source: https://docs.influencers.club/openapi/dictionary/public_v1_discovery_classifier_languages_list Retrieves a list of supported languages and their abbreviations. This is useful for filtering creators by their profile language or content language. ```APIDOC ## GET /public/v1/discovery/classifier/languages/ ### Description Retrieves a list of supported languages and their abbreviations. This is useful for filtering creators by their profile language or content language. ### Method GET ### Endpoint /public/v1/discovery/classifier/languages/ ### Response #### Success Response (200) - `language` (string) - The name of the language. - `abbreviation` (string) - The abbreviation for the language. #### Response Example { "example": "{\"language\": \"English\", \"abbreviation\": \"en\"}" } ``` -------------------------------- ### GET /public/v1/discovery/classifier/locations/{platform}/ Source: https://docs.influencers.club/openapi.md Retrieve a list of location identifiers available for a specific platform. Returns location strings that can be used to filter creators by geographic location in discovery searches. Platform-specific location data helps target creators from specific regions, cities, or countries. Use the search parameter for substring/prefix matching on location names (e.g. "London", "United"). Use offset and limit to paginate through results. ```APIDOC ## GET /public/v1/discovery/classifier/locations/{platform}/ ### Description Retrieve a list of location identifiers available for a specific platform. Returns location strings that can be used to filter creators by geographic location in discovery searches. Platform-specific location data helps target creators from specific regions, cities, or countries. Use the search parameter for substring/prefix matching on location names (e.g. "London", "United"). Use offset and limit to paginate through results. ### Method GET ### Endpoint /public/v1/discovery/classifier/locations/{platform}/ ### Parameters #### Path Parameters - **platform** (string) - Required - The platform for which to retrieve locations. #### Query Parameters - **search** (string) - Optional - For substring/prefix matching on location names. - **offset** (integer) - Optional - For paginating through results. - **limit** (integer) - Optional - For paginating through results. ### Credits 0 credits. This endpoint does not deduct credits. ``` -------------------------------- ### POST /public/v1/discovery/creators/similar/ Source: https://docs.influencers.club/openapi/similar-creators.md Discover creators similar to a reference creator based on various similarity criteria. This endpoint returns a paginated list of creator profiles that match the reference creator's characteristics, content style, audience, or other specified attributes. It supports filtering by URL, username, or ID, and allows additional filters to refine similarity matching. Useful for finding lookalike creators, competitors, or creators in the same niche. ```APIDOC ## POST /public/v1/discovery/creators/similar/ ### Description Discover creators similar to a reference creator based on various similarity criteria. This endpoint returns a paginated list of creator profiles that match the reference creator's characteristics, content style, audience, or other specified attributes. It supports filtering by URL, username, or ID, and allows additional filters to refine similarity matching. Useful for finding lookalike creators, competitors, or creators in the same niche. ### Method POST ### Endpoint /public/v1/discovery/creators/similar/ ### Parameters #### Query Parameters - **reference_creator_identifier** (string) - Required - The URL, username, or ID of the reference creator. - **filter_by** (string) - Optional - Specifies the criteria for similarity matching (e.g., 'content_style', 'audience_demographics', 'niche'). - **limit** (integer) - Optional - The maximum number of creators to return per page. - **offset** (integer) - Optional - The number of creators to skip for pagination. ### Request Example ```json { "reference_creator_identifier": "https://www.example.com/creator", "filter_by": "niche", "limit": 10, "offset": 0 } ``` ### Response #### Success Response (200) - **creators** (array) - A list of similar creator profiles. - **profile** (object) - Details of a similar creator. - **id** (string) - The unique identifier of the creator. - **username** (string) - The username of the creator. - **display_name** (string) - The display name of the creator. - **profile_url** (string) - The URL to the creator's profile. - **similarity_score** (number) - A score indicating the degree of similarity. - **pagination** (object) - Pagination information. - **total_creators** (integer) - The total number of similar creators found. - **limit** (integer) - The limit used for the current page. - **offset** (integer) - The offset used for the current page. #### Response Example ```json { "creators": [ { "profile": { "id": "creator_123", "username": "similar_creator", "display_name": "Similar Creator", "profile_url": "https://www.example.com/similar_creator", "similarity_score": 0.85 } }, { "profile": { "id": "creator_456", "username": "another_creator", "display_name": "Another Creator", "profile_url": "https://www.example.com/another_creator", "similarity_score": 0.78 } } ], "pagination": { "total_creators": 50, "limit": 10, "offset": 0 } } ``` ``` -------------------------------- ### Check account credits and usage details Source: https://docs.influencers.club/openapi.md Use your API key to check your remaining credits and total credits used. ```APIDOC ## GET /public/v1/accounts/credits/ ### Description Check your remaining API credits and total credits consumed. ### Method GET ### Endpoint /public/v1/accounts/credits/ ### Response #### Success Response - **credits_available** (integer) - remaining credits - **credits_used** (integer) - total credits consumed #### Response Example { "credits_available": 950, "credits_used": 50 } ``` -------------------------------- ### POST /public/v1/discovery/creators/similar/ Source: https://docs.influencers.club/openapi/similar-creators/public_v1_discovery_creators_similar_create Retrieves a paginated list of creator profiles that match the characteristics, content style, audience, or other specified attributes of a reference creator. This endpoint is useful for finding lookalike creators, competitors, or creators within the same niche. ```APIDOC ## POST /public/v1/discovery/creators/similar/ ### Description Retrieves a paginated list of creator profiles that match the characteristics, content style, audience, or other specified attributes of a reference creator. This endpoint is useful for finding lookalike creators, competitors, or creators within the same niche. ### Method POST ### Endpoint /public/v1/discovery/creators/similar/ ### Parameters #### Query Parameters - **url** (string) - Optional - Filter by creator's URL. - **username** (string) - Optional - Filter by creator's username. - **id** (string) - Optional - Filter by creator's unique platform identifier. - **limit** (integer) - Optional - The maximum number of creators to return. - **offset** (integer) - Optional - The number of creators to skip before returning results. ### Request Body This endpoint does not require a request body. Parameters should be passed as query parameters. ### Response #### Success Response (200) - **total** (integer, required) - The total number of creators found. - **limit** (integer, required) - The limit of creators returned in this response. - **credits_left** (string, required) - The number of credits remaining for the user. - **accounts** (array, required) - A list of creator accounts. - **accounts.user_id** (string, required) - The creator's unique platform identifier. - **accounts.profile** (object, required) - The creator's profile information. - **accounts.profile.full_name** (string, required) - The creator's full name. - **accounts.profile.username** (string, required) - The creator's username on the platform. - **accounts.profile.picture** (string, required) - URL to the creator's profile picture. This URL is temporary and expires after 24 hours. - **accounts.profile.followers** (integer, required) - The number of followers the creator has. - **accounts.profile.engagement_percent** (number, required) - The creator's engagement rate. #### Error Response (400, 401, 422) Details about error responses are not provided in the source documentation. ``` -------------------------------- ### POST /public/v1/creators/enrich/handle/raw/ Source: https://docs.influencers.club/openapi.md Retrieve raw platform data for a creator profile using their social media handle. Returns unprocessed platform-specific data directly from the source, including basic profile information, post data, media counts, and platform-native metadata. ```APIDOC ## POST /public/v1/creators/enrich/handle/raw/ ### Description Retrieve raw platform data for a creator profile using their social media handle. This endpoint provides the foundational data layer before any additional processing or enrichment. Supports Instagram, YouTube, TikTok, OnlyFans, Twitter, Snapchat, Discord, Pinterest, Facebook, and LinkedIn platforms. ### Method POST ### Endpoint /public/v1/creators/enrich/handle/raw/ ### Response #### Success Response (200) - **raw_data** (object) - Unprocessed platform-specific data directly from the source. ### Credits 0.03 credits per successful request. If no data is returned, no credits are deducted. ``` -------------------------------- ### GET /public/v1/enrichment/batch/{batch_id}/status/ Source: https://docs.influencers.club/openapi.md Check the current processing status of a batch enrichment job. Provides current state and progress indicators. ```APIDOC ## GET /public/v1/enrichment/batch/{batch_id}/status/ ### Description Check the current processing status of a batch enrichment job. This API is polling-based and does not use webhooks. ### Method GET ### Endpoint /public/v1/enrichment/batch/{batch_id}/status/ ### Parameters #### Path Parameters - **batch_id** (string) - Required - The ID of the batch enrichment job. ### Response #### Success Response (200) - **status** (string) - Current state (e.g., queued, processing, finished, failed, paused_insufficient_credits). - **progress** (object) - Optional - Progress indicators (processed vs remaining), when available. ### Credits 0 credits (status only). ``` -------------------------------- ### Download Batch Enrichment CSV (Recommended) Source: https://docs.influencers.club/openapi.md Downloads the enriched CSV dataset for a batch via a temporary presigned URL. This is recommended for large files due to its speed and reliability. ```APIDOC ## GET /public/v1/enrichment/batch/{batch_id}/download/ ### Description Download the enriched CSV dataset via a temporary presigned URL. This is the recommended endpoint for downloading CSV results. ### Method GET ### Endpoint /public/v1/enrichment/batch/{batch_id}/download/ ### Parameters #### Path Parameters - **batch_id** (string) - Required - The ID of the batch to download. ### Response #### Success Response - **download_url** (string) - temporary URL (valid for a limited time) - **expires_in** (integer) - seconds until the URL expires - **expires_at** (string) - expiration timestamp #### Response Example { "download_url": "https://example.com/path/to/your/file.csv?expires=1234567890&signature=...", "expires_in": 3600, "expires_at": "2023-10-27T10:00:00Z" } ### Error Responses - 400 Bad Request — batch not completed yet or no results file available - 404 Not Found — invalid batch ID or batch does not belong to client ``` -------------------------------- ### GET /public/v1/discovery/classifier/games/ Source: https://docs.influencers.club/openapi/dictionary/public_v1_discovery_classifier_games_list Retrieves a list of video games available on Twitch. This endpoint is useful for filtering creators based on the games they play or have streamed. It does not deduct credits. ```APIDOC ## GET /public/v1/discovery/classifier/games/ ### Description Retrieves a list of video games available on Twitch that can be used for filtering creators. Returns game identifiers and metadata to help discover Twitch streamers who play specific games or have streamed particular titles. ### Method GET ### Endpoint /public/v1/discovery/classifier/games/ ### Parameters ### Request Body ### Response #### Success Response (200) - `topic_details` (string) - required - `sub_topic_details` (array) - required #### Response Example { "topic_details": "string", "sub_topic_details": [ ] } ``` -------------------------------- ### POST /public/v1/creators/audience/overlap/ Source: https://docs.influencers.club/openapi/audience-overlap.md Compares the audience overlap between 2 to 10 creators on a specified platform. It returns detailed audience overlap percentages, unique audience figures, and overall report totals. ```APIDOC ## POST /public/v1/creators/audience/overlap/ ### Description Compares audience overlap between 2-10 creators on a given platform. Useful for evaluating creator partnerships, identifying audience duplication across campaigns, and optimizing influencer selection for maximum reach. ### Method POST ### Endpoint /public/v1/creators/audience/overlap/ ### Parameters #### Query Parameters - **platform** (string) - Required - The platform on which to compare creators. ### Request Body - **creator_ids** (array[string]) - Required - A list of creator IDs to compare. Must contain between 2 and 10 IDs. ### Response #### Success Response (200) - **overlap_data** (object) - Contains detailed overlap information for each creator pair. - **creator_id_1** (string) - The ID of the first creator. - **creator_id_2** (string) - The ID of the second creator. - **overlap_percentage** (number) - The percentage of audience overlap between the two creators. - **unique_audience_1** (integer) - The number of unique followers for creator 1 not present in creator 2's audience. - **unique_audience_2** (integer) - The number of unique followers for creator 2 not present in creator 1's audience. - **report_totals** (object) - Overall totals for the report. - **total_followers** (integer) - The sum of followers across all compared creators. - **total_unique_followers** (integer) - The total number of unique followers across all compared creators. ### Response Example { "overlap_data": [ { "creator_id_1": "creatorA", "creator_id_2": "creatorB", "overlap_percentage": 0.35, "unique_audience_1": 70000, "unique_audience_2": 65000 }, { "creator_id_1": "creatorA", "creator_id_2": "creatorC", "overlap_percentage": 0.15, "unique_audience_1": 90000, "unique_audience_2": 85000 } ], "report_totals": { "total_followers": 300000, "total_unique_followers": 250000 } } ### Credits 1 credit per request. ``` -------------------------------- ### Retrieve Account Credits Source: https://docs.influencers.club/openapi/account-credits-and-usage/account_credits_usage_retrieve.md Fetches the current available and used credits for the account. ```APIDOC ## GET /public/v1/accounts/credits/ ### Description Retrieves the account's remaining credits and total credits consumed. ### Method GET ### Endpoint /public/v1/accounts/credits/ ### Parameters #### Query Parameters None #### Request Body None ### Response #### Success Response (200) - `credits_available` (number, required) - Remaining credits. - `credits_used` (number, required) - Total credits consumed. #### Response Example { "credits_available": 1000, "credits_used": 500 } ``` -------------------------------- ### Get Batch Enrichment Status Source: https://docs.influencers.club/openapi/batch-enrichment/public_v1_enrichment_batch_status_retrieve Retrieves the current processing status of a batch enrichment job. This includes the job's state, progress indicators, and other relevant details. ```APIDOC ## GET /public/v1/enrichment/batch/{batch_id}/status/ ### Description Check the current processing status of a batch enrichment job. What you get: - Current state (e.g., queued/running/completed/failed) - Progress indicators (processed vs remaining), when available Credits - 0 credits (status only) ### Method GET ### Endpoint /public/v1/enrichment/batch/{batch_id}/status/ ### Parameters #### Path Parameters - **batch_id** (string, required) - Unique batch identifier returned when creating the enrichment batch ### Response #### Success Response (200) - **batch_id** (string, required) - Unique identifier for the batch enrichment job - **status** (string, required) - Current status of the batch job (processing, finished, failed, queued, paused_insufficient_credits) - **total_rows** (integer, required) - Total number of records submitted in the batch - **processed_rows** (integer, required) - Total number of records that have finished processing - **success_count** (integer, required) - Number of records processed successfully - **failed_count** (integer, required) - Number of records that failed or could not be processed - **started_at** (string, required) - Timestamp when the batch was created - **metadata** (object, required) - Metadata provided with the batch - **credits_used** (string, required) - Total number of credits used in the batch - **estimated_completion** (string,null) - Estimated completion timestamp based on current progress (null if unavailable) - **status_message** (string,null) - Human-readable message about the batch status (only present when paused) ``` -------------------------------- ### Create Batch Enrichment Source: https://docs.influencers.club/openapi/batch-enrichment/public_v1_enrichment_batch_create Initiates a batch enrichment job by uploading a CSV file. The job can be configured with various parameters to specify the platform, enrichment mode, and data inclusion preferences. ```APIDOC ## POST /public/v1/enrichment/batch/ ### Description Creates a batch enrichment job by uploading a CSV file. The job can be configured with various parameters to specify the platform, enrichment mode, and data inclusion preferences. ### Method POST ### Endpoint /public/v1/enrichment/batch/ ### Parameters #### Request Body (multipart/form-data): - **file** (string) - Required - CSV file containing creators to enrich (max 10MB, single column: handle or email) - **platform** (string) - Optional - Enum: "instagram", "youtube", "tiktok", "twitter", "twitch", "onlyfans" - **enrichment_mode** (string) - Required - Enum: "raw", "full", "basic" - **metadata** (object,null) - Optional - Optional metadata as JSON object (e.g., {"campaign": "Q4 Outreach"}) - **email_required** (string) - Optional - Enum: "must_have", "preferred" - **include_lookalikes** (boolean) - Optional - Include lookalike creators for handle-based full enrichment. Default: false - **include_audience_data** (boolean) - Optional - Include audience data for handle-based full enrichment. Default: true - **exclude_platforms** (string) - Optional - Enum: "instagram", "youtube", "tiktok", "twitter", "twitch", "onlyfans" - **min_followers** (integer) - Optional ### Response #### Success Response (200) - **batch_id** (string) - Required - Unique identifier for the batch enrichment job - **status** (string) - Required - Current status of the batch job (processing, finished, failed, validating) - **created_at** (string) - Required - Timestamp when the batch was created - **platform** (string,null) - Optional - Platform used for enrichment (for handle-based enrichment) - **metadata** (object,null) - Optional - Metadata provided with the batch - **og_input_number** (integer) - Required - Total number of records in the input file - **type_report** (string) - Required - Type of enrichment: ENRICH_BY_HANDLE or ENRICH_BY_EMAIL - **enrichment_mode** (string,null) - Optional - Enrichment mode: raw, full, basic - **message** (string) - Required - Human-readable message about the batch status #### Response Example { "batch_id": "b1234567-890a-1234-5678-90abcdef1234", "status": "processing", "created_at": "2023-10-27T10:00:00Z", "platform": "instagram", "metadata": {"campaign": "Q4 Outreach"}, "og_input_number": 1000, "type_report": "ENRICH_BY_HANDLE", "enrichment_mode": "full", "message": "Batch job created successfully." } ``` -------------------------------- ### GET /public/v1/discovery/classifier/yt-topics/ Source: https://docs.influencers.club/openapi/dictionary/public_v1_discovery_classifier_yt_topics_list Retrieves a hierarchical list of YouTube topic categories and their subtopics. This can be used to find creators in particular content verticals or subject areas. The response includes topic details and an array of sub-topic details. ```APIDOC ## GET /public/v1/discovery/classifier/yt-topics/ ### Description Retrieves a hierarchical list of YouTube topic categories and their subtopics. This can be used to find creators in particular content verticals or subject areas. The response includes topic details and an array of sub-topic details. ### Method GET ### Endpoint /public/v1/discovery/classifier/yt-topics/ ### Parameters #### Query Parameters None #### Request Body None ### Response #### Success Response (200) - **topic_details** (string) - Required - The main topic category. - **sub_topic_details** (array) - Required - An array of sub-topic details. #### Response Example { "topic_details": "Example Topic", "sub_topic_details": [ { "sub_topic_id": "sub1", "sub_topic_name": "Example Subtopic 1" }, { "sub_topic_id": "sub2", "sub_topic_name": "Example Subtopic 2" } ] } ``` -------------------------------- ### POST /public/v1/creators/enrich/handle/full/ Source: https://docs.influencers.club/openapi.md Perform comprehensive enrichment of a creator profile using their social media handle. Returns complete profile data including cross-platform presence, engagement analytics, follower growth metrics, content performance data, monetization indicators, niche classification, hashtags, income estimates, and optional lookalike creator recommendations. ```APIDOC ## POST /public/v1/creators/enrich/handle/full/ ### Description Perform comprehensive enrichment of a creator profile using their social media handle. Supports Instagram, YouTube, TikTok, OnlyFans, Twitter, Snapchat, Discord, Pinterest, Facebook, LinkedIn, and Twitch platforms. Optional email requirement and lookalike inclusion settings available. ### Method POST ### Endpoint /public/v1/creators/enrich/handle/full/ ### Parameters #### Query Parameters - **email** (boolean) - Optional - Whether to include email in the response. - **lookalikes** (boolean) - Optional - Whether to include lookalike creator recommendations. ### Response #### Success Response (200) - **profile_data** (object) - Complete profile data including cross-platform presence, engagement analytics, follower growth metrics, content performance data, monetization indicators, niche classification, hashtags, income estimates. - **lookalike_creators** (array) - Optional - List of recommended lookalike creators. ### Credits 1 credit per successful request. If no data is returned, no credits are deducted. ``` -------------------------------- ### POST /public/v1/creators/content/posts/ Source: https://docs.influencers.club/openapi/creator-posts.md Fetches recent posts for a creator on a given platform. Supports Instagram, TikTok, and YouTube. Returns a list of posts with metadata and engagement metrics. Uses cursor-based pagination. ```APIDOC ## POST /public/v1/creators/content/posts/ ### Description Fetches recent posts for a creator on a given platform, including metadata such as post ID, URL, caption, media URLs, timestamps, and engagement metrics. Supports Instagram, TikTok, and YouTube platforms. Uses cursor-based pagination via `next_token` for fetching additional pages of results. ### Method POST ### Endpoint /public/v1/creators/content/posts/ ### Parameters #### Query Parameters - **platform** (string) - Required - The social media platform (e.g., 'instagram', 'tiktok', 'youtube'). - **creator_id** (string) - Required - The unique identifier for the creator. - **page_size** (integer) - Optional - The number of posts to retrieve per page. Platform-specific limits apply (Instagram: 12, TikTok: max 35, YouTube: max 50). - **next_token** (string) - Optional - Token for cursor-based pagination to fetch the next page of results. ### Request Example ```json { "platform": "instagram", "creator_id": "example_creator_id", "page_size": 12, "next_token": "example_next_token" } ``` ### Response #### Success Response (200) - **posts** (array) - A list of post objects, each containing: - **post_id** (string) - The unique identifier for the post. - **url** (string) - The URL of the post. - **caption** (string) - The text caption of the post. - **media_urls** (array) - A list of URLs for the media attached to the post. - **created_at** (string) - The timestamp when the post was created. - **engagement** (object) - An object containing engagement metrics: - **likes** (integer) - **comments** (integer) - **views** (integer) - **shares** (integer) - **next_token** (string) - A token for fetching the next page of results, if available. #### Response Example ```json { "posts": [ { "post_id": "post123", "url": "https://instagram.com/p/examplepost", "caption": "Beautiful day!", "media_urls": ["https://cdn.example.com/image.jpg"], "created_at": "2023-10-27T10:00:00Z", "engagement": { "likes": 1500, "comments": 50, "views": 10000, "shares": 100 } } ], "next_token": "nextpage_token_abc" } ``` ``` -------------------------------- ### GET /public/v1/discovery/classifier/games/ Source: https://docs.influencers.club/openapi.md Retrieve a list of video games available on Twitch that can be used for filtering creators. Returns game identifiers and metadata to help discover Twitch streamers who play specific games or have streamed particular titles. ```APIDOC ## GET /public/v1/discovery/classifier/games/ ### Description Retrieve a list of video games available on Twitch that can be used for filtering creators. Returns game identifiers and metadata to help discover Twitch streamers who play specific games or have streamed particular titles. ### Method GET ### Endpoint /public/v1/discovery/classifier/games/ ### Credits 0 credits. This endpoint does not deduct credits. ``` -------------------------------- ### GET /public/v1/discovery/classifier/audience-interests/ Source: https://docs.influencers.club/openapi/dictionary/public_v1_discovery_classifier_audience_interests_list.md Returns a list of audience interest values from Instagram creator audience data. Use these values in the audience.interests filter on the Discovery API to search for Instagram creators (10k+ followers) whose audience has specific interests. ```APIDOC ## GET /public/v1/discovery/classifier/audience-interests/ ### Description Returns a list of audience interest values from Instagram creator audience data. Use these values in the audience.interests filter on the Discovery API to search for Instagram creators (10k+ followers) whose audience has specific interests. ### Method GET ### Endpoint /public/v1/discovery/classifier/audience-interests/ ### Query Parameters - **search** (string) - Optional - Search string to filter results - **offset** (integer) - Optional - Cursor offset for pagination ### Response #### Success Response (200) - **full_name** (string, required) - **cleaned** (string, required) - **username** (string, required) - The creator's username on the platform. ``` -------------------------------- ### POST /public/v1/creators/enrich/handle/full/ Source: https://docs.influencers.club/openapi/enrich-by-handle-full.md Performs comprehensive enrichment of a creator profile using their social media handle. It returns complete profile data including cross-platform presence, engagement analytics, follower growth metrics, content performance data, monetization indicators, niche classification, hashtags, income estimates, and optional lookalike creator recommendations. Supports multiple platforms and optional settings for email requirement and lookalike inclusion. ```APIDOC ## POST /public/v1/creators/enrich/handle/full/ ### Description Performs comprehensive enrichment of a creator profile using their social media handle. It returns complete profile data including cross-platform presence, engagement analytics, follower growth metrics, content performance data, monetization indicators, niche classification, hashtags, income estimates, and optional lookalike creator recommendations. Supports multiple platforms and optional settings for email requirement and lookalike inclusion. ### Method POST ### Endpoint /public/v1/creators/enrich/handle/full/ ### Parameters #### Query Parameters - **email_required** (boolean) - Optional - If true, the creator's email will be returned if available. - **include_lookalikes** (boolean) - Optional - If true, lookalike creator recommendations will be included. ### Request Example ```json { "handle": "example_handle", "platform": "instagram" } ``` ### Response #### Success Response (200) - **profile_data** (object) - Complete profile data including cross-platform presence, engagement analytics, follower growth metrics, content performance data, monetization indicators, niche classification, hashtags, income estimates. - **lookalike_creators** (array) - Optional - A list of recommended lookalike creators. #### Response Example ```json { "profile_data": { "username": "example_user", "platform": "instagram", "followers": 100000, "engagement_rate": 0.05, "content_performance": {}, "monetization_indicators": {}, "niche": "fashion", "hashtags": ["#style", "#ootd"], "income_estimate": 5000 }, "lookalike_creators": [ { "handle": "lookalike1", "platform": "instagram" } ] } ``` ``` -------------------------------- ### GET /public/v1/discovery/classifier/brands/ Source: https://docs.influencers.club/openapi.md Retrieve a comprehensive list of brand names available for filtering in creator discovery searches. Returns brand identifiers including full names, cleaned names, and usernames that can be used to find creators who have worked with specific brands or mentioned them in their content. ```APIDOC ## GET /public/v1/discovery/classifier/brands/ ### Description Retrieve a comprehensive list of brand names available for filtering in creator discovery searches. Returns brand identifiers including full names, cleaned names, and usernames that can be used to find creators who have worked with specific brands or mentioned them in their content. ### Method GET ### Endpoint /public/v1/discovery/classifier/brands/ ### Credits 0 credits. This endpoint does not deduct credits. ``` -------------------------------- ### GET /public/v1/discovery/classifier/audience-locations/ Source: https://docs.influencers.club/openapi/dictionary/public_v1_discovery_classifier_audience_locations_list Returns a list of audience location values (countries, states, cities) from Instagram creator audience data. Use these values in the audience.location filter on the Discovery API to search for Instagram creators (10k+ followers) whose audience is in specific locations. ```APIDOC ## GET /public/v1/discovery/classifier/audience-locations/ ### Description Returns a list of audience location values (countries, states, cities) from Instagram creator audience data. Use these values in the audience.location filter on the Discovery API to search for Instagram creators (10k+ followers) whose audience is in specific locations. ### Method GET ### Endpoint /public/v1/discovery/classifier/audience-locations/ ### Query Parameters - **search** (string) - Optional - Search string to filter results - **offset** (integer) - Optional - Cursor offset for pagination ### Response #### Success Response (200) - **full_name** (string, required) - **cleaned** (string, required) - **username** (string, required) - The creator's username on the platform. ```