# Influencers Club — Orthogonal API > Pay-per-use API on Orthogonal. Each call is billed to your Orthogonal balance. > Base API: `https://api.orthogonal.com/v1/run` · [llms.txt](https://orthogonal.com/llms.txt) · [browse all APIs](https://orthogonal.com/discover) Creator discovery, enrichment, and audience analytics across Instagram, YouTube, TikTok, Twitter, Twitch, and more. Search creators with advanced filters, enrich profiles by handle or email, find similar creators, compare audience overlap, and fetch content posts with engagement data. **Verified:** yes ## Access **Run API:** `POST https://api.orthogonal.com/v1/run` **Auth:** `Authorization: Bearer $ORTHOGONAL_API_KEY` Get an API key at https://orthogonal.com/dashboard/settings/api-keys Every call goes through the unified Run API: send the API `slug`, the endpoint `path`, and the `query`/`body` parameters. The response is `{ "success": true, "price": "", "data": { ... } }`. ## Endpoints ### Creator Posts Fetch recent posts for a creator. Returns post metadata including ID, URL, caption, media URLs, timestamps, and engagement metrics (likes, comments, views, shares). Supports Instagram, TikTok, and YouTube with cursor-based pagination. 0.03 upstream credits per request. `POST /public/v1/creators/content/posts/` **Estimated cost:** $0.02 | Field | Type | Required | Description | |-------|------|----------|-------------| | `platform` | string | Yes | Platform: instagram, tiktok, youtube | | `handle` | string | Yes | Creator identifier: username, profile URL, or YouTube channel ID | | `count` | integer | No | Posts per page (IG: fixed 12, TikTok: max 35, YouTube: max 50) | | `pagination_token` | string | No | Cursor for next page of results | ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/creators/content/posts/","body":{"platform":"","handle":"","count":"","pagination_token":""}}' ``` ### Dictionary: Twitch Games Get list of Twitch games for filtering streamers by games played. `GET /public/v1/discovery/classifier/games/` **Cost:** Free _No parameters required._ ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/classifier/games/","method":"GET"}' ``` ### Connected Socials Discover all verified social accounts connected to a creator. Supports 10 seed platforms: Instagram, YouTube, TikTok, Twitter, Snapchat, Discord, Pinterest, Facebook, LinkedIn, and Twitch. Returns connected accounts with platform, username, and follower count. 0.5 upstream credits per request. `POST /public/v1/creators/socials/` **Estimated cost:** $0.33 | Field | Type | Required | Description | |-------|------|----------|-------------| | `platform` | string | Yes | Seed platform: instagram, youtube, tiktok, twitter, snapchat, discord, pinterest, facebook, linkedin, twitch | | `handle` | string | Yes | Creator identifier: username, profile URL, or YouTube channel ID | ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/creators/socials/","body":{"platform":"","handle":""}}' ``` ### Enrich by Handle (Raw) Retrieve raw platform data for a creator by handle. Returns unprocessed data including profile info, post data, media counts, and platform-native metadata. Supports Instagram, YouTube, TikTok, Twitter, Snapchat, Discord, Pinterest, Facebook, and LinkedIn. 0.03 upstream credits per request. `POST /public/v1/creators/enrich/handle/raw/` **Estimated cost:** $0.02 | Field | Type | Required | Description | |-------|------|----------|-------------| | `handle` | string | Yes | Creator identifier: username, profile URL, or YouTube channel ID | | `platform` | string | Yes | Platform: instagram, youtube, tiktok, twitter, snapchat, discord, pinterest, facebook, linkedin, twitch | ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/creators/enrich/handle/raw/","body":{"handle":"","platform":""}}' ``` ### Enrich by Handle (Full) Comprehensive creator enrichment by social media handle. Returns cross-platform presence, engagement analytics, follower growth, content performance, monetization indicators, niche classification, hashtags, income estimates, and optional lookalikes. Supports 10 platforms. 1 upstream credit per request. `POST /public/v1/creators/enrich/handle/full/` **Estimated cost:** $0.66 | Field | Type | Required | Description | |-------|------|----------|-------------| | `handle` | string | Yes | Creator identifier: username, profile URL, or YouTube channel ID | | `platform` | string | Yes | Platform: instagram, youtube, tiktok, twitter, snapchat, discord, pinterest, facebook, linkedin, twitch | | `email_required` | string | No | Email requirement: must_have or preferred | | `include_lookalikes` | boolean | No | Include lookalike creator recommendations | | `include_audience_data` | boolean | No | Include audience demographic data | ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/creators/enrich/handle/full/","body":{"handle":"","platform":"","email_required":"","include_lookalikes":"","include_audience_data":""}}' ``` ### Audience Overlap Compare audience overlap between 2-10 creators on a given platform. Returns per-creator overlap and unique audience percentages, plus total followers and unique followers. 1 upstream credit per request. `POST /public/v1/creators/audience/overlap/` **Estimated cost:** $0.66 | Field | Type | Required | Description | |-------|------|----------|-------------| | `platform` | string | Yes | Platform: e.g. instagram | | `creators` | array | Yes | Array of 2-10 creator handles to compare | ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/creators/audience/overlap/","body":{"platform":"","creators":""}}' ``` ### Dictionary: Audience Brand Names Get audience brand names (Nike, Apple, Starbucks, etc.) for filtering Instagram creators (10k+ followers) whose audience follows specific brands. `GET /public/v1/discovery/classifier/audience-brand-names/` **Cost:** Free _No parameters required._ ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/classifier/audience-brand-names/","method":"GET"}' ``` ### Dictionary: Audience Brand Categories Get audience brand categories (Sports, Fashion, Technology, etc.) for filtering Instagram creators (10k+ followers) by audience brand affinity. `GET /public/v1/discovery/classifier/audience-brand-categories/` **Cost:** Free _No parameters required._ ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/classifier/audience-brand-categories/","method":"GET"}' ``` ### Enrich by Email Basic creator enrichment by email address. Returns essential profile info including social media presence, contact details, and platform account identifiers across Instagram, YouTube, TikTok, Twitter, and Twitch. 0.05 upstream credits per request. `POST /public/v1/creators/enrich/email/` **Estimated cost:** $0.033 | Field | Type | Required | Description | |-------|------|----------|-------------| | `email` | string | Yes | The creator email address to enrich | ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/creators/enrich/email/","body":{"email":""}}' ``` ### Dictionary: Languages Get supported languages with abbreviations for filtering creators by profile or content language. `GET /public/v1/discovery/classifier/languages/` **Cost:** Free _No parameters required._ ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/classifier/languages/","method":"GET"}' ``` ### Post Details Retrieve detailed post information: metadata, comments, transcript, or audio. Supports Instagram (data/comments/transcript/audio), TikTok (data/comments/transcript/audio), and YouTube (data/comments/transcript). 0.03 upstream credits per request. `POST /public/v1/creators/content/details/` **Estimated cost:** $0.02 | Field | Type | Required | Description | |-------|------|----------|-------------| | `platform` | string | Yes | Platform: instagram, tiktok, youtube | | `content_type` | string | Yes | Type of content: data, comments, transcript, or audio | | `post_id` | string | Yes | Post ID (e.g. 3702042988674165349_1541770582) | | `pagination_token` | string | No | Pagination token for comments | ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/creators/content/details/","body":{"platform":"","content_type":"","post_id":"","pagination_token":""}}' ``` ### Similar Creators Find creators similar to a reference creator by URL, username, or ID. Supports Instagram, YouTube, TikTok, and Twitch. Returns paginated list of lookalike creators with profile info and engagement. 0.01 upstream credits per creator returned. `POST /public/v1/discovery/creators/similar/` **Estimated cost:** $0.03 | Field | Type | Required | Description | |-------|------|----------|-------------| | `platform` | string | Yes | Platform: instagram, youtube, tiktok, twitch | | `filter_key` | string | Yes | Identifier type: url, username, or id | | `filter_value` | string | Yes | The creator identifier value (URL, username, or ID) | | `paging` | object | Yes | Pagination: {skip: number, limit: number, page: number} | | `filters` | object | No | Optional platform-specific filters to refine similarity matching | ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/creators/similar/","body":{"platform":"","filter_key":"","filter_value":"","paging":"","filters":""}}' ``` ### Dictionary: YouTube Topics Get hierarchical YouTube topic categories and subtopics for discovering YouTube creators by content niche. `GET /public/v1/discovery/classifier/yt-topics/` **Cost:** Free _No parameters required._ ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/classifier/yt-topics/","method":"GET"}' ``` ### Dictionary: Brands Get comprehensive list of brand names for filtering in creator discovery searches. `GET /public/v1/discovery/classifier/brands/` **Cost:** Free _No parameters required._ ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/classifier/brands/","method":"GET"}' ``` ### Creator Discovery Search and discover creators across multiple platforms using advanced filtering (location, gender, language, followers, engagement, audience demographics, brand deals, and more). Supports Instagram, YouTube, TikTok, Twitch, and Twitter. Returns paginated list of creator profiles with analytics. 0.01 upstream credits per creator returned. `POST /public/v1/discovery/` **Estimated cost:** $0.03 | Field | Type | Required | Description | |-------|------|----------|-------------| | `platform` | string | Yes | Platform to search: instagram, youtube, tiktok, twitch, twitter | | `paging` | object | No | Pagination: {limit: number, page: number} | | `sort` | object | No | Sort: {sort_by: relevancy, sort_order: asc\|desc} | | `filters` | object | No | Platform-specific filters: location, gender, profile_language, ai_search, keywords_in_bio, hashtags, number_of_followers ({min, max}), engagement_percent ({min, max}), average_likes, average_comments, audience (location, gender, language, age, interests, brands), and more | ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/","body":{"platform":"","paging":"","sort":"","filters":""}}' ``` ### Dictionary: Audience Interests Get audience interest values for filtering Instagram creators (10k+ followers) by audience interests. `GET /public/v1/discovery/classifier/audience-interests/` **Cost:** Free _No parameters required._ ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/classifier/audience-interests/","method":"GET"}' ``` ### Dictionary: Audience Locations Get audience location values (countries, states, cities) for filtering Instagram creators (10k+ followers) by audience geography. `GET /public/v1/discovery/classifier/audience-locations/` **Cost:** Free _No parameters required._ ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/classifier/audience-locations/","method":"GET"}' ``` ### Dictionary: Twitch Locations Get Twitch location identifiers for filtering creators by geographic location. `GET /public/v1/discovery/classifier/locations/twitch/` **Cost:** Free _No parameters required._ ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/classifier/locations/twitch/","method":"GET"}' ``` ### Dictionary: YouTube Locations Get YouTube location identifiers for filtering creators by geographic location. `GET /public/v1/discovery/classifier/locations/youtube/` **Cost:** Free _No parameters required._ ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/classifier/locations/youtube/","method":"GET"}' ``` ### Dictionary: Instagram Locations Get Instagram location identifiers for filtering creators by geographic location. `GET /public/v1/discovery/classifier/locations/instagram/` **Cost:** Free _No parameters required._ ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/classifier/locations/instagram/","method":"GET"}' ``` ### Dictionary: Twitter Locations Get Twitter location identifiers for filtering creators by geographic location. `GET /public/v1/discovery/classifier/locations/twitter/` **Cost:** Free _No parameters required._ ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/classifier/locations/twitter/","method":"GET"}' ``` ### Dictionary: TikTok Locations Get TikTok location identifiers for filtering creators by geographic location. `GET /public/v1/discovery/classifier/locations/tiktok/` **Cost:** Free _No parameters required._ ```bash curl -X POST 'https://api.orthogonal.com/v1/run' \ -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"api":"influencers-club","path":"/public/v1/discovery/classifier/locations/tiktok/","method":"GET"}' ``` --- Full details and an interactive quickstart: https://orthogonal.com/discover/influencers-club