Add Creators to a Watchlist

Adds creators to one of your watchlists. Pass profileIds (from search_profiles or any search result) and/or handles as {platform, handle} pairs; up to 25 per call. Creators must already be tracked (crawl_profile first if not; unresolved ones come back in notFound). Already-present creators are reported, not duplicated. Free to call. Each added creator counts against your followed-profiles allowance, which comes from a subscription or is earned from API spend; an over-limit call explains what unlocks more.

Cost: free.

post/api/v1/watchlists/profiles

Request

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

Request body

watchlistIdstring required

Target watchlist id.

profileIdsstring[]

Internal profile ids to add.

handlesstring

Handle pairs to resolve and add, e.g. [{"platform":"tiktok","handle":"x"}]. profileIds + handles ≤ 25 per call.

Response

Success

object required

Changes

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