# YouTube channel stats API for your agent

YouTube channel stats API for an agent: it sends a channel handle, ID or URL to a catalog endpoint and reads subscriber count, total views and video count back. Several providers sell the call, so the agent tries the cheapest first. You pay per call, and a failed call costs nothing.

## What this does

A channel's public numbers show how big it is and how long it has been at it. Your agent sends a handle, an ID or a URL and reads back the subscribers, the total views, the number of videos and the date the channel started. That is the base data for a creator list or a competitor check.

Three providers return channel data, and they take different inputs. One accepts a channel ID, a handle or a full URL. One wants the channel URL with the handle. One wants the channel ID. If you start from handles, pick the one that accepts them, or resolve the ID in a first call.

You give: a channel handle, ID or URL. Example: https://www.youtube.com/@examplechannel.

## What differs between providers

- Scrape Creators API (scrapecreators-youtube-channel): accepts a channel ID, a handle or a full URL and returns subscribers, total videos and views, join date, tags and linked social accounts.
- Bright Data (brightdata-youtube-channel): takes a channel URL and returns name, handle, description, subscribers, total views, video count, creation date, links and top videos.
- TikHub (tikhub-api-youtube-web-get-channel-info): takes a channel ID and returns the channel's information.

## Before you start

- Know what you hold. A handle, an ID and a URL are not interchangeable on every provider, and the endpoint page lists the one it takes.
- Subscriber counts are rounded by YouTube. Do not compare two channels on a difference of a few hundred subscribers.
- Pair it with the video list. The channel call gives the totals, and the videos call gives what each upload earned.

## Prompt

Use looot to get the stats of the YouTube channel https://www.youtube.com/@examplechannel: subscribers, total views, video count, join date and linked social accounts. 1. Set up https://looot.ai/skill.md. 2. Search the catalog for each step and check its price before you call. 3. Run the cheapest endpoint that fits. 4. Show the results as a table and the total cost.

## Steps and providers

- Fetch the channel: scrapecreators, brightdata, tikhub. 1 call per channel.

## What comes back

- Subscriber count
- Total views and video count
- Join date
- Description and tags
- Linked social accounts

## The request and what comes back

Each run is one POST to /v1/runs with an endpoint id and an input. These are illustrative calls with generic values. The run's result holds the provider's own fields.

- Scrape Creators API: {"endpointId":"scrapecreators-youtube-channel","input":{"handle":"@examplechannel"},"wait":30}
- Bright Data: {"endpointId":"brightdata-youtube-channel","input":{"input":[{"url":"https://www.youtube.com/@examplechannel"}]},"wait":30}

## Can I compare channels?

Yes. Fetch each channel and line up subscribers, total views and video count. Divide views by videos for a rough average per upload, and divide subscribers by the channel's age for growth since the join date.

## How do I get YouTube channel stats with an API?

Send the channel handle, ID or URL to a channel endpoint. Your agent reads the subscribers, total views, video count and join date as JSON.

## Can I get a channel's videos too?

Yes, through the video-list endpoints of the same providers. The channel call gives the totals. The video list gives each upload with its views and date.

## Do I need the channel ID?

Not always. One provider accepts a handle or a URL. Another needs the ID, and a lookup call turns a URL into an ID.

## Does it show the links in the channel's About tab?

Yes, on the providers that return linked social accounts or links. The notes above say which. Use them to build a creator list with contact paths.

## How much does one channel cost?

You pay per call, and the price depends on the provider your agent picks. This page reads the cheapest live price from the catalog and shows no number when the catalog is unreachable.

## Do I pay when a youtube channel stats call fails?

No. A call that fails at the provider costs nothing, and your agent can retry it or send it to another provider.

## Do I need an account with each youtube channel stats provider?

No. One looot key reaches every provider in the catalog. You top up once, and each call is billed at the price shown before it runs.

## How do I call youtube channel stats from code?

Send a POST to /v1/runs with the endpoint id, the input and a new idempotency key, and your looot token in the Authorization header. With wait set to 30, the answer comes back in the response when the run ends within 30 seconds. Otherwise poll GET /v1/runs/<runId>.

## Can I run youtube channel stats on a schedule?

That needs scheduled runs, not available yet. Run it by hand whenever you want fresh results.

## Do I pay while my agent is idle?

No. looot bills per call, and nothing runs while your agent is idle.

## Related pages

- /use-cases/youtube-transcript-api
- /use-cases/youtube-video-search-api
- /use-cases/find-creators-by-keyword

## Last reviewed

2026-10-04. The cost per 1,000 channel runs is read live from the catalog on the web page.
