Satellite

Poll sound lookup status

Returns the current status of a sound lookup job. Poll until finalized is true (status "completed" or "failed"). Results expire after 24 hours, but are also persisted as a durable satellite run — once status reaches "completed" you can re-read the result for free via GET /v1/satellite/runs/:run_id (the run_id is echoed inside the completed result envelope).

get/v1/satellite/sounds/status/{job_id}

Request

Base URL: https://api.virlo.ai
URL: https://api.virlo.ai/v1/satellite/sounds/status/{job_id}
Auth: HTTP bearer

Path parameters

job_idstring required

The job ID returned from the sound lookup endpoint

Response

Job status retrieved. Shape varies by status: processing, completed (with full result), or failed (with error).

Example response

{
  "data": {
    "result": {
      "request": {
        "music_id": "7570679470014532374",
        "platform": "tiktok",
        "max_videos": 50
      },
      "sound": {
        "platform": "tiktok",
        "owner": {
          "handle": "aubreygraham",
          "nickname": "Drake"
        }
      },
      "credits_refunded": 50,
      "stats": {
        "velocity": {
          "videos_per_week": [
            {
              "iso_week": "2026-W18"
            }
          ]
        }
      },
      "trends": {
        "trends": [
          {
            "time_windows": [
              {
                "start_date": "2026-04-12",
                "end_date": "2026-05-03"
              }
            ]
          }
        ]
      }
    },
    "finalized": true
  }
}

Changes

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