Viral Outliers

List the Profiles You Are Monitoring and Their Refresh Cost API

Returns every profile you are currently monitoring, with its handle, platform, follower count, refresh cadence, next scheduled crawl time, when it was last checked for updates, and any paused reason (e.g. paused for insufficient credits). Free to call. Use it to audit what is being refreshed and what it is costing, or to grab a profileId for untrack_profile.

See everything you are currently monitoring in one free call: each profile's handle and platform, follower count, refresh cadence, next scheduled crawl time, when it was last checked, and any paused reason. It is the dashboard behind track_profile, the view an agent uses to audit what is being refreshed and what it is costing.

FreeRead-only

How to call it

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

cURL

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

Python (requests)

import requests

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

JavaScript (fetch)

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

What it does

It returns every profile under active monitoring with the details that matter for managing them: platform and handle, follower count, refresh cadence (daily, every 3 days or weekly), the next scheduled crawl time, the last time it was checked for updates, and a pausedReason where applicable (for example, paused for insufficient credits).

It is free and read-only. Each monitored profile costs 10 credits per scheduled refresh, so the cadence column doubles as a cost view: multiply by the refresh frequency to see roughly what each profile spends per month.

When to use it

Use it to audit recurring spend and to grab a profileId for untrack_profile: list what is being refreshed, surface cadences and next-due times to the user, and cancel the accounts that are no longer worth refreshing. It is the first half of every budget-control loop.

It is also how you diagnose gaps: if a monitored profile is not producing new posts, the pausedReason tells you whether monitoring stalled on an empty balance (it resumes automatically after a top-up) rather than leaving you guessing why updates stopped.

Pricing

This skill is free and never spends credits.

Agent workflows

  • Monitoring audit: list_tracked_profiles → surface cadences and next-due times to the user → untrack the ones no longer needed.

Frequently asked questions

How do I see which profiles I am monitoring and what they cost?

Call list_tracked_profiles. It returns each monitored profile with its cadence, next scheduled refresh time and paused status (free), so an agent can audit recurring spend and decide what to keep or untrack.

How do I know if monitoring was paused because I ran out of credits?

The list shows a pausedReason for each profile. When a scheduled crawl cannot be charged the row is flagged paused for insufficient credits; it resumes automatically once you top up, so no re-tracking is needed.

How do I estimate what my monitored profiles cost per month?

Each scheduled refresh costs 10 credits, so multiply by the cadence shown for each profile: weekly is roughly 40 credits a month, every 3 days roughly 100, and daily roughly 300. Summing across the list gives a running estimate of recurring monitoring spend before you decide what to untrack.

Also available as an MCP tool.

Related topics: monitored profiles dashboard · scheduled crawl status · recurring API spend · monitoring cost audit