# Influencers Club — Orthogonal API

> Pay-per-use API on Orthogonal. Each call is billed to your Orthogonal balance.
> Base API: `https://api.orth.sh/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.orth.sh/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": "<usd>", "data": { ... } }`.

## Endpoints

### 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.orth.sh/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":"<string>","filter_key":"<string>","filter_value":"<string>","paging":"<object>","filters":"<object>"}}'
```

### 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.orth.sh/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"}'
```

### 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.orth.sh/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.orth.sh/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"}'
```

### 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.orth.sh/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"}'
```

### 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.orth.sh/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":"<string>","platform":"<string>","email_required":"<string>","include_lookalikes":"<boolean>","include_audience_data":"<boolean>"}}'
```

### 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.orth.sh/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.orth.sh/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"}'
```

### 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.orth.sh/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":"<string>","platform":"<string>"}}'
```

### 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.orth.sh/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":"<string>","creators":"<array>"}}'
```

### 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.orth.sh/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"influencers-club","path":"/public/v1/discovery/","body":{"platform":"<string>","paging":"<object>","sort":"<object>","filters":"<object>"}}'
```

### 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.orth.sh/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"influencers-club","path":"/public/v1/creators/socials/","body":{"platform":"<string>","handle":"<string>"}}'
```

### 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.orth.sh/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":"<string>"}}'
```

### 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.orth.sh/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":"<string>","handle":"<string>","count":"<integer>","pagination_token":"<string>"}}'
```

### 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.orth.sh/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":"<string>","content_type":"<string>","post_id":"<string>","pagination_token":"<string>"}}'
```

### 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.orth.sh/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.orth.sh/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"}'
```

### 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.orth.sh/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: 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.orth.sh/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: 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.orth.sh/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: 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.orth.sh/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: 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.orth.sh/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