Satellite

Batch creator lookup

Submit up to 25 creators for parallel lookup. Returns a batch_id with per-creator job IDs. Poll aggregate status via GET /v1/satellite/creators/batch/:batch_id, or individual jobs via GET /v1/satellite/creator/status/:job_id. Pricing: $0.50 per creator that starts a lookup, plus the audience surcharge per creator when audience flags are set. A creator answered from the 6-hour cache comes back completed and is free, as on the single lookup. A creator whose lookup fails (for example a handle with no public posts) is refunded; its failed status reports credits_refunded.

post/v1/satellite/creators/batch

Request

  • Base URL: https://api.virlo.ai
  • URL: https://api.virlo.ai/v1/satellite/creators/batch
  • Auth: HTTP bearer

Request body

includestring

Comma-separated list of optional fields to include: "videos", "outliers"

cross_linksboolean

Enable cross-platform link discovery for all creators in the batch.

max_videosnumber

Number of videos to fetch per creator

outlier_thresholdnumber

Outlier detection threshold multiplier

audience_demographicsboolean

Include inferred audience demographics for every creator in the batch. Cache-first; misses dispatch async snapshot jobs and add an extra $0.50 surcharge per creator on top of the $0.50-per-creator batch cost. Cache hits are free. Off by default.

audience_geographyboolean

Include inferred audience geography for every creator in the batch. Same caching and $0.50-per-creator surcharge behavior as audience_demographics; cache hits are free. Off by default.

freshness_daysnumber

Maximum age (in days) of an acceptable cached audience snapshot. Only used when audience flags are set.

Example request

{
  "creators": [
    {
      "platform": "tiktok",
      "username": "creator_handle"
    }
  ],
  "include": "videos,outliers",
  "cross_links": true,
  "max_videos": 20,
  "outlier_threshold": 2,
  "freshness_days": 30
}

Response

Batch submitted

Changes

No recorded changes to this operation across all 1 revision of this API.