Scanning

You can trigger new YouTube scans, for any niche. Allowing for tailored competitor research, in real-time.

Starting a YouTube Scan

You can trigger a new YouTube scan by calling the /scan endpoint.

To successfully trigger a scan you need to have an active subscription with available credits.

Searching the results

Once a scan is complete, you can search for the results by calling the /channels endpoint or the /outliers endpoint with the referenceId property set to the desired scan id.

curl -X GET "https://public-api.tubelab.net/v1/channels?referenceId=8794a2ba-b4ca-40ca-9585-ca3fc501e31d" \
-H "Authorization: Api-Key <token>"

curl -X GET "https://public-api.tubelab.net/v1/outliers?referenceId=8794a2ba-b4ca-40ca-9585-ca3fc501e31d" \
-H "Authorization: Api-Key <token>"

Webhooks

You can get notified when a scan status changes by creating a webhook.

Once you've set your webhook, you will receive a payload when the scan status changes:

// body payload
{
  "type": "ProcessStatus",
  "time": "2025-09-20T14:36:52.211Z",
  "data": {
    "id": "8794a2ba-b4ca-40ca-9585-ca3fc501e31d",
    "status": "Running",
    "endedAt": null,
    "updatedAt": "2025-09-20T14:36:52.186Z"
  }
}

Scan Modes and Pricing

There's two available modes that will stop the scan when one of the thresholds is reached.

Scans are queued and processed in order, so the expected time is an estimate and can vary.