Creator tracking and analytics API

What to build with it

Choose a creator and a deliberate tracking cadence.
Wait for the initial collection before reading reports, snapshots and detected signals.
Pause or stop tracking when you no longer need recurring observations.

Provider reference: Virlo documentation. Authentication uses a provider-issued Bearer token, stored on your server.

Endpoints and inputs

8 documented operations. Query and path fields are listed separately from JSON request-body fields.

POST/v1/tracking/creators

No path or query parameters are declared in the captured schema.

JSON body fields

url: string · optional
handle: string · optional
platform: string · required · values: tiktok, youtube, instagram
scrape_cadence: string · optional · values: six_hours, twelve_hours, daily, every_other_day, weekly, bi_weekly, monthly
collection_depth: string · optional · values: standard, deep, full

Documented response fields

data: object · required
data.id: string · required
data.status: string · required
data.message: string · required
data.finalized: boolean · optional
data.pending_jobs: array · optional
data.pending_jobs[].type: string · required · values: viral_analysis, audience_demographics, audience_geography, tracking_report, data_intelligence
data.pending_jobs[].status: string · required · values: pending, processing
data.pending_jobs[].job_id: string · optional
data.pending_jobs[].poll_url: string · optional
data.pending_jobs[].result_path: string · optional
data.pending_jobs[].webhook_event: string · optional
data.pending_jobs[].started_at: string · optional
data.pending_jobs[].retry_after_seconds: number · optional

Documented HTTP responses: 202, 400, 401, 402, 409, 429. Handle each non-success response explicitly; do not silently convert a failed lookup to an empty result.

GET/v1/tracking/creators

Path and query parameters

page: number (query) · optional
limit: number (query) · optional
platform: string (query) · optional · values: tiktok, youtube, instagram
search: string (query) · optional

Documented response fields

data: array · required
data[].id: string · required
data[].platform: string · required · values: tiktok, youtube, instagram
data[].platform_handle: string · required
data[].profile_url: string | null · optional
data[].display_name: string | null · optional
data[].avatar_url: string | null · optional
data[].bio: string | null · optional
data[].is_verified: boolean | null · optional
data[].status: string · required · values: active, paused, deleted
data[].scrape_cadence: string · required · values: six_hours, twelve_hours, daily, every_other_day, weekly, bi_weekly, monthly
data[].enrichment_status: string · required · values: pending, processing, completed, failed
data[].finalized: boolean · optional
data[].pending_jobs: array · optional
data[].pending_jobs[].type: string · required · values: viral_analysis, audience_demographics, audience_geography, tracking_report, data_intelligence
data[].pending_jobs[].status: string · required · values: pending, processing
data[].pending_jobs[].job_id: string · optional
data[].pending_jobs[].poll_url: string · optional
data[].pending_jobs[].result_path: string · optional
data[].pending_jobs[].webhook_event: string · optional
data[].pending_jobs[].started_at: string · optional
data[].pending_jobs[].retry_after_seconds: number · optional
data[].latest_followers: number | null · optional
data[].latest_following: number | null · optional
data[].latest_total_likes: number | null · optional
data[].latest_total_views: number | null · optional
data[].latest_total_videos: number | null · optional
data[].last_scraped_at: string | null · optional
data[].growth_rate: number | null · optional
data[].followers_gained: number | null · optional
data[].next_scrape_at: string | null · optional
data[].category: string | null · optional
data[].content_tags: array · optional
data[].profile_metadata: object | null · optional
data[].created_at: string · required
data[].updated_at: string · required
pagination: object · required
pagination.page: number · required
pagination.limit: number · required
pagination.total: number · required
pagination.total_pages: number · required
pagination.has_next_page: boolean · required
pagination.has_prev_page: boolean · required

Documented HTTP responses: 200, 401, 429. Handle each non-success response explicitly; do not silently convert a failed lookup to an empty result.

GET/v1/tracking/creators/{id}

Path and query parameters

id: string (path) · required

Documented response fields

data: object · required
data.id: string · required
data.platform: string · required · values: tiktok, youtube, instagram
data.platform_handle: string · required
data.profile_url: string | null · optional
data.display_name: string | null · optional
data.avatar_url: string | null · optional
data.bio: string | null · optional
data.is_verified: boolean | null · optional
data.status: string · required · values: active, paused, deleted
data.scrape_cadence: string · required · values: six_hours, twelve_hours, daily, every_other_day, weekly, bi_weekly, monthly
data.enrichment_status: string · required · values: pending, processing, completed, failed
data.finalized: boolean · optional
data.pending_jobs: array · optional
data.pending_jobs[].type: string · required · values: viral_analysis, audience_demographics, audience_geography, tracking_report, data_intelligence
data.pending_jobs[].status: string · required · values: pending, processing
data.pending_jobs[].job_id: string · optional
data.pending_jobs[].poll_url: string · optional
data.pending_jobs[].result_path: string · optional
data.pending_jobs[].webhook_event: string · optional
data.pending_jobs[].started_at: string · optional
data.pending_jobs[].retry_after_seconds: number · optional
data.latest_followers: number | null · optional
data.latest_following: number | null · optional
data.latest_total_likes: number | null · optional
data.latest_total_views: number | null · optional
data.latest_total_videos: number | null · optional
data.last_scraped_at: string | null · optional
data.growth_rate: number | null · optional
data.followers_gained: number | null · optional
data.next_scrape_at: string | null · optional
data.category: string | null · optional
data.content_tags: array · optional
data.profile_metadata: object | null · optional
data.created_at: string · required
data.updated_at: string · required

Documented HTTP responses: 200, 401, 404, 429. Handle each non-success response explicitly; do not silently convert a failed lookup to an empty result.

PATCH/v1/tracking/creators/{id}

Path and query parameters

id: string (path) · required

JSON body fields

status: string · optional · values: active, paused
scrape_cadence: string · optional · values: six_hours, twelve_hours, daily, every_other_day, weekly, bi_weekly, monthly

Documented response fields

data: object · required
data.id: string · required
data.platform: string · required · values: tiktok, youtube, instagram
data.platform_handle: string · required
data.profile_url: string | null · optional
data.display_name: string | null · optional
data.avatar_url: string | null · optional
data.bio: string | null · optional
data.is_verified: boolean | null · optional
data.status: string · required · values: active, paused, deleted
data.scrape_cadence: string · required · values: six_hours, twelve_hours, daily, every_other_day, weekly, bi_weekly, monthly
data.enrichment_status: string · required · values: pending, processing, completed, failed
data.finalized: boolean · optional
data.pending_jobs: array · optional
data.pending_jobs[].type: string · required · values: viral_analysis, audience_demographics, audience_geography, tracking_report, data_intelligence
data.pending_jobs[].status: string · required · values: pending, processing
data.pending_jobs[].job_id: string · optional
data.pending_jobs[].poll_url: string · optional
data.pending_jobs[].result_path: string · optional
data.pending_jobs[].webhook_event: string · optional
data.pending_jobs[].started_at: string · optional
data.pending_jobs[].retry_after_seconds: number · optional
data.latest_followers: number | null · optional
data.latest_following: number | null · optional
data.latest_total_likes: number | null · optional
data.latest_total_views: number | null · optional
data.latest_total_videos: number | null · optional
data.last_scraped_at: string | null · optional
data.growth_rate: number | null · optional
data.followers_gained: number | null · optional
data.next_scrape_at: string | null · optional
data.category: string | null · optional
data.content_tags: array · optional
data.profile_metadata: object | null · optional
data.created_at: string · required
data.updated_at: string · required

Documented HTTP responses: 200, 400, 401, 404, 429. Handle each non-success response explicitly; do not silently convert a failed lookup to an empty result.

DELETE/v1/tracking/creators/{id}

Path and query parameters

id: string (path) · required

The captured schema does not enumerate structured response fields for this operation. Check its current provider reference.

Documented HTTP responses: 204, 401, 404, 429. Handle each non-success response explicitly; do not silently convert a failed lookup to an empty result.

GET/v1/tracking/creators/{id}/report

Path and query parameters

id: string (path) · required

Documented response fields

data: object · required
data.account: object · required
data.account.id: string · required
data.account.platform: string · required · values: tiktok, youtube, instagram
data.account.platform_handle: string · required
data.account.profile_url: string | null · optional
data.account.display_name: string | null · optional
data.account.avatar_url: string | null · optional
data.account.bio: string | null · optional
data.account.is_verified: boolean | null · optional
data.account.status: string · required · values: active, paused, deleted
data.account.scrape_cadence: string · required · values: six_hours, twelve_hours, daily, every_other_day, weekly, bi_weekly, monthly
data.account.enrichment_status: string · required · values: pending, processing, completed, failed
data.account.finalized: boolean · optional
data.account.pending_jobs: array · optional
data.account.latest_followers: number | null · optional
data.account.latest_following: number | null · optional
data.account.latest_total_likes: number | null · optional
data.account.latest_total_views: number | null · optional
data.account.latest_total_videos: number | null · optional
data.account.last_scraped_at: string | null · optional
data.account.growth_rate: number | null · optional
data.account.followers_gained: number | null · optional
data.account.next_scrape_at: string | null · optional
data.account.category: string | null · optional
data.account.content_tags: array · optional
data.account.profile_metadata: object | null · optional
data.account.created_at: string · required
data.account.updated_at: string · required
data.report: object | null · optional
data.report.id: string · required
data.report.tracking_account_id: string · required
data.report.analysis: object | null · optional
data.report.collection_data: object | null · optional
data.report.created_at: string · required

Documented HTTP responses: 200, 401, 404, 429. Handle each non-success response explicitly; do not silently convert a failed lookup to an empty result.

GET/v1/tracking/creators/{id}/snapshots

Path and query parameters

id: string (path) · required
start_date: string (query) · optional
end_date: string (query) · optional
limit: number (query) · optional · default: 30

Documented response fields

data: array · required
data[].id: string · required
data[].tracking_account_id: string · required
data[].followers: number | null · optional
data[].following: number | null · optional
data[].subscribers: number | null · optional
data[].total_likes: number | null · optional
data[].total_videos: number | null · optional
data[].total_views: number | null · optional
data[].collected_post_count: number · required
data[].snapshot_at: string · required
data[].delta_followers: number | null · optional
data[].delta_following: number | null · optional
data[].delta_total_videos: number | null · optional
data[].delta_total_views: number | null · optional
data[].delta_total_likes: number | null · optional
data[].engagement_rate: number | null · optional
data[].delta_engagement_rate: number | null · optional

Documented HTTP responses: 200, 401, 404, 429. Handle each non-success response explicitly; do not silently convert a failed lookup to an empty result.

GET/v1/tracking/creators/{id}/signals

Path and query parameters

id: string (path) · required
start_date: string (query) · optional
end_date: string (query) · optional
limit: number (query) · optional · default: 30

Documented response fields

data: array · required
data[].id: string · required
data[].type: string · required · values: outlier_video, follower_spike, follower_decline, new_subject, creator_unreachable
data[].severity: string · required · values: info, notable, critical
data[].title: string · required
data[].payload: object · required
data[].created_at: string · required
data[].read: boolean · required

Documented HTTP responses: 200, 401, 404, 429. Handle each non-success response explicitly; do not silently convert a failed lookup to an empty result.

Before you integrate

Tracking can continue incurring charges on a schedule. A detected signal is not proof of fraud, audience authenticity or a causal change.

Check the provider's current price, allowed use and retention terms before sending requests. An optional field can be absent; the schema alone does not establish its completeness or accuracy.

Give this task to your coding agent

creator-tracking-api agent prompt

Help me implement creator tracking and analytics api using the documented Virlo API.

Reference: https://allthemapis.com/social-media-apis/creator-tracking-api
Provider documentation: https://dev.virlo.ai/docs/tracking
Base URL: https://api.virlo.ai
Starting operation: POST /v1/tracking/creators

Read the current provider docs and confirm the required inputs before writing code. Load VIRLO_API_KEY from a server-side environment variable and use Bearer authentication. Do not put the key in client code, logs, analytics, or the chat.

Ask me for any missing video URL, creator handle, research intent, or job ID. Do not invent a result. Ask for approval before starting billable lookups, recurring jobs, or destructive changes. For jobs, keep the returned ID and poll with the documented delay instead of starting the job twice. Handle pagination, rate limits, partial results, and missing fields explicitly.

Build the smallest integration for this task:
1. Choose a creator and a deliberate tracking cadence.
2. Wait for the initial collection before reading reports, snapshots and detected signals.
3. Pause or stop tracking when you no longer need recurring observations.

Return the code, the environment variables I need, and a short explanation of what was actually retrieved versus inferred. Do not execute paid requests until I approve.

Sources and review dates

Virlo's public documentation and OpenAPI schema reviewed October 27, 2026. Endpoint paths and field names below refer to that provider's API. This is an integration reference, not a measured performance ranking.

Corrections: email faizank@docsalot.dev with an official source.

What to build with it

Endpoints and inputs

JSON body fields

Documented response fields

Path and query parameters

Documented response fields

Path and query parameters

Documented response fields

Path and query parameters

JSON body fields

Documented response fields

Path and query parameters

Path and query parameters

Documented response fields

Path and query parameters

Documented response fields

Path and query parameters

Documented response fields

Before you integrate

Give this task to your coding agent

Sources and review dates

Explore social media APIs

Get the next API benchmark.