Create a Watchlist

Creates an empty watchlist (a named set of creators) and returns its watchlistId. Fill it with add_watchlist_profiles, then pass the id to search_outliers as watchlistId to scope any search to exactly those accounts. Watchlists created here appear in the owner's web app too. Free to call. Watchlists count against a workspace allowance that comes from a subscription or is earned from API spend (every API key holder starts with 1); an over-limit call explains what unlocks more.

Cost: free.

post/api/v1/watchlists

Request

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

Request body

namestring required

Display name, 1-80 characters (e.g. "Fitness competitors").

notesstring

Optional free-text notes, up to 500 characters.

Response

Success

object required

Changes

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