List Your Creator Watchlists and Their Ids API

Returns every watchlist on the account (both agent-created and web-app-created) with its watchlistId, name, notes, profile count and last-updated time. Free to call. Use it to recall an id for search_outliers, add_watchlist_profiles or get_watchlist.

See every watchlist on the account in one free call, with the id an agent needs to search it, the name, how many creators it holds and when it was last changed. It covers lists built in the web app as well as lists an agent created through the API, so the agent can reuse whatever the owner has already curated.

How to call it

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

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

import requests

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

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

Pricing

This skill is free and never spends credits.

Agent workflows

• Session start: list_watchlists → match the user's request ("my fitness list") to an id → search_outliers with watchlistId.

Frequently asked questions