Menu

Documentation

YouTube API

Retrieve subscriber counts, video counts and total views of a YouTube channel, simply by handle or channel ID.

Channel statistics
https://api.flowdata.one/v1/youtube/stats/{identifier}

OpenAPI file for this area

Quick start

FlowData key
This API belongs to FlowData and uses its own keys (fd_...), which you create in the dashboard under API keys. FlowSuite keys (pk_..., at_...) keep working, but we recommend a FlowData key.
Data freshness
A fetched channel is reused for up to 24 hours (cached: true). After that, the next request fetches new values through the YouTube Data API.

Overview

The YouTube API returns channel statistics for a handle (@name) or a channel ID (UC...):

  • Subscriber count
  • Number of videos
  • Total channel views
  • Channel title, description and thumbnail

Channel statistics

GET
/v1/youtube/stats/{identifier}

Get channel statistics

Retrieves the statistics of a YouTube channel. Every successful response is billed, including cached: true; 404 for a channel that was not found is free.

Bearer fd_… 1.50 EUR per 1,000 successful requests

Path parameters

Name Type Description
identifier string
Required
Handle (for example @YouTube) or channel ID (for example UCBR8-60-B28hp2BmDPdntcQ)
curl -X GET "https://api.flowdata.one/v1/youtube/stats/@YouTube" \
  -H "Authorization: Bearer fd_YOUR_KEY" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_YOUR_KEY')
    ->get('https://api.flowdata.one/v1/youtube/stats/@YouTube');

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/youtube/stats/@YouTube', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer fd_YOUR_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer fd_YOUR_KEY',
    'Accept': 'application/json',
}

response = requests.get(
    'https://api.flowdata.one/v1/youtube/stats/@YouTube',
    headers=headers,
)

data = response.json()
{
    "success": true,
    "cached": true,
    "data": {
        "channel_id": "UCBR8-60-B28hp2BmDPdntcQ",
        "handle": "@YouTube",
        "title": "YouTube",
        "description": "YouTube's official channel...",
        "subscriber_count": 40000000,
        "video_count": 500,
        "view_count": 3000000000,
        "thumbnail_url": "https://...",
        "last_synced_at": "2026-01-12T10:00:00Z"
    }
}

One key is all it takes to start.

Create a key and call the API. Client info is free; everything else is billed per successful request.

Create an API key Documentation

FlowData is aimed exclusively at businesses and self-employed professionals.