Get the Creators in a Watchlist API

Returns a single watchlist by watchlistId with every member profile: profileId, handle, platform and follower count. Free to call. Use it to review or explain a list before searching it, or to pick profileIds for remove_watchlist_profiles.

Fetch one watchlist with all of its member creators, each with the internal profileId, handle, platform and follower count. Free to call. It is how an agent shows the owner what a list contains, checks whether a creator is already in it, or picks ids to remove.

How to call it

GET /api/v1/watchlists/{watchlistId}. Authenticate with your API key. Same call in three languages:

curl -X GET "https://viraloutliers.com/api/v1/watchlists/EXAMPLE_ID" \
  -H "Authorization: Bearer so_live_YOUR_KEY"

import requests

r = requests.get(
"https://viraloutliers.com/api/v1/watchlists/EXAMPLE_ID",
    headers={"Authorization": "Bearer so_live_YOUR_KEY"},
)
print(r.json())

const res = await fetch("https://viraloutliers.com/api/v1/watchlists/EXAMPLE_ID", {
  method: "GET",
  headers: { "Authorization": "Bearer so_live_YOUR_KEY" },
});
const data = await res.json();
console.log(data);

Parameters

Pricing

This skill is free and never spends credits.

Agent workflows

• Review: get_watchlist → summarize members to the user → remove_watchlist_profiles for the ones to drop.

Frequently asked questions