---
title: "Find Related Social Media Profiles"
method: POST
path: "/api/v1/profiles/related"
---

# Find Related Social Media Profiles

`POST /api/v1/profiles/related`

## Request

- Base URL: `https://viraloutliers.com`
- URL: `https://viraloutliers.com/api/v1/profiles/related`
- Auth: HTTP bearer

Discover new creators on TikTok, Instagram or YouTube from one seed: a creator handle (walks who they follow on TikTok, who they collaborate with, tag or mention on Instagram), a hashtag, or a search phrase. Every account surfaced is screened live with one provider call (recent posts: how many reached 5k+ views, posting activity, newest post) and judged for topic relevance from its bio and captions, then returned ranked with recommended = qualified and on-topic. Accounts already in the database come back flagged known with their profileId. Nothing is crawled or added automatically: call crawl_profile for the ones you want. Priced up to 25 credits per call: 5 base plus 1 per account actually screened, the rest refunded (nothing found = fully refunded). Pass topic to say what related means for your use case. Not for looking up a known creator (use search_profiles).

Cost: 25 credits per call.

## Request body

- object
  - `platform` string, required: "tiktok" | "instagram" | "youtube".
  - `handle` string: Seed creator. TikTok: the accounts they follow. Instagram: collaborators, tagged accounts and mentions in their recent posts. Not available on YouTube. Exactly one of handle, query, hashtag.
  - `query` string: Search phrase; the creators behind the top results become candidates.
  - `hashtag` string: Hashtag without the #; creators posting under it become candidates.
  - `topic` string: What "related" means for the relevance judge (e.g. "home workouts for women"). Defaults to the seed itself.
  - `limit` number: How many candidates to screen and return. Default 10, max 20.

## Response `200`

Success

- object

## Other responses

- `401`: Invalid or revoked API key (or, on free skills, no key sent); code key_suspended means the key was suspended when its account was claimed by the email owner and can be reactivated in Settings
- `402`: Payment required. Without an API key (billable skills only) the code is payment_required and error.payment.checkoutUrl (or, when no link is configured, error.payment.pageUrl at https://viraloutliers.com/api-access) buys a key without an account; with a key it is insufficient_credits and error.payment points at create_topup_link.
- `429`: Rate limited

---

[API](https://skmtc.dev/viraloutliers/apis/viral-outliers-agent-api.md) · [All operations](https://skmtc.dev/viraloutliers/apis/viral-outliers-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/viraloutliers/apis/viral-outliers-agent-api/revisions/0099977bd629?raw)