Remove Creators from a Watchlist API

Removes the given profileIds from a watchlist and returns how many were removed plus the new profile count. Free to call. Use get_watchlist to find the profileIds.

Prune a watchlist by removing creators by profile id. Free to call, returns the number removed and the updated count, so an agent can keep a competitor set current as accounts become irrelevant.

Free

How to call it

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

cURL

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

Python (requests)

import requests

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

JavaScript (fetch)

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

Parameters

NameTypeDescription
watchlistId*stringWatchlist id.
profileIds*string[]Internal profile ids to remove.

What it does

Deletes the listed members from the watchlist (ids that are not members are ignored) and returns removed and profileCount. Get the ids from get_watchlist.

Pricing

This skill is free and never spends credits.

Agent workflows

  • Prune: get_watchlist → identify stale accounts → remove_watchlist_profiles.

Frequently asked questions

How do I take a creator off a watchlist?

Call remove_watchlist_profiles with the watchlistId and the creator's profileId (from get_watchlist). It is free and returns the updated member count.