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.
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);| Name | Type | Description |
|---|---|---|
watchlistId* | string | Watchlist id. |
profileIds* | string[] | Internal profile ids to remove. |
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.
This skill is free and never spends credits.
Call remove_watchlist_profiles with the watchlistId and the creator's profileId (from get_watchlist). It is free and returns the updated member count.
Also available as an MCP tool.
Related topics: watchlist maintenance · unfollow creator · list pruning