Search Social Media Profiles

Search tracked social media profiles by handle or name, filtered by platform. Returns profile metadata, follower counts and average performance stats. Use it to resolve a handle to a profile id before fetching stats or posts, or to discover creators in the database. Results may include deactivated profiles (is_active=false), e.g. an account that was renamed or went private, retained with frozen stats; filter on is_active if you only want live accounts. Note a creator who changed handles can appear as two rows (old deactivated + new active).

Cost: 1 credit per 25 profiles returned.

post/api/v1/search/profiles

Request

  • Base URL: https://viraloutliers.com
  • URL: https://viraloutliers.com/api/v1/search/profiles
  • Auth: HTTP bearer

Request body

querystring

Handle or name fragment.

platformsstring[]

"tiktok" | "instagram" | "youtube".

categoryIdstring

Niche filter: a category id from list_categories (covers its subtree). Without a query this returns the niche's top profiles by followers.

pagenumber

Page number, 1-based. A search serves its first 1,000 profiles; a page past that is refused at no charge, so narrow the filters instead.

pageSizenumber

Results per page, 1 to 100 (default 25). Billed per 25 profiles returned: 25 costs 1 credit, 100 costs 4.

Response

Success

object required

Changes

No recorded changes to this operation across all 1 revision of this API.