100 free credits. No credit card required
YouTube Channel Lives API
Scrape YouTube Channel Lives data with one API call. Fetches live streams and past streams from a YouTube channel's Live tab (title, URL, thumbnail, view count, publish time, duration) plus a `continuationToken` when more results are available. Pass `handle` or `channelId` for the first page; forward `continuationToken` for subsequent pages. DATES: this tab publishes no exact timestamp, only a relative label ("Streamed 3 weeks ago"), so by default every row is joined to the per-video lookup for its exact publish second, at no extra credit (one lookup per page). Send `exact_dates=false` to keep the label-derived estimate instead, marked by `post.ext.published_precision`. The tab also publishes no like or comment counts. Send `include=engagement` and every row is joined, in the same call, to the per-video lookup: likes, comments, the exact publish time and the channel id land on each row (1 credit per distinct stream filled, at most 5 per page); `include=channel` adds the channel's subscriber count (1 credit). TITLES: the free per-video lookup swaps YouTube's English machine-translated listing title for the creator's own; a title not swapped carries `post.ext.title_maybe_translated: true` (`exact_dates=false` skips the lookup).
Last updated October 2026Maintained by the SocialCrawl team
Returns the live and past streams on a channel's Live tab, each with title, URL, thumbnail, view count, publish time, and duration.
Use it to track a channel's streaming output; channel/videos returns regular uploads and leaves the Live tab out.
Searching 68 platforms in parallel
·
TikTok·
Instagram·YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·
Apple Music·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·
Utility·
Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchYouTube API
What can you do with the Channel Lives API?
The Channel Lives endpoint gives you structured YouTube data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/youtube/channel/lives?handle=IShowSpeed"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/youtube/channel/lives",
params={
'handle': 'IShowSpeed',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/youtube/channel/lives?handle=IShowSpeed",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| channelId | No | YouTube channel ID. |
| handle | No | YouTube channel handle (with or without @). |
| continuationToken | No | Continuation token from a previous response: fetches the next page. |
| include | No | Set to `engagement`, `channel`, or both (`engagement,channel`) to fill more of every row in this one call. `engagement` fills `post.engagement.views`, `.likes` and `.comments`, `post.content.duration_seconds`, `post.ext.channel_id` and `post.author.display_name` where the row lacks them, and replaces a date derived from a label such as "4 months ago" with the exact publish time (removing `post.ext.published_precision`). The engagement join costs 1 credit per distinct stream it filled, never more than 5 per page, and streams that could not be filled are refunded. `channel` adds the channel's subscriber count (`post.ext.author_followers`, YouTube's own figure, rounded to three significant figures above 1,000) plus its avatar: every row is the same channel, so it is one lookup, 1 credit, refunded if it could not be read. Each join adds 0.2 to 0.7 seconds on a fresh page (one lookup per 50 ids, never more than 8 seconds). Read `data.hydration` for the rows, lookups, credits held and kept, and the time. |
| exact_dates | No | Exact publish dates are on by default and free. A row whose date the upstream derived from a relative label such as "4 months ago" (measured up to four months off) is joined to the per-video lookup for its exact publish second, at no extra credit: one lookup per page (two on a page past 50 rows, side by side), adding about 0.2 to 0.7 seconds (never more than 3). The same lookup swaps the listing title, often YouTube's English machine translation, for the creator's own, and `computed.language` follows it; a title not swapped carries `post.ext.title_maybe_translated: true`. Set to `false` to skip the lookup: rows then carry the supplier's date estimate (a day-granular or coarser label truncated to midnight UTC), marked by `post.ext.published_precision` and `post.ext.published_label`, and the listing title, marked by `post.ext.title_maybe_translated`. A row the lookup could not resolve keeps those values and markers, and `_warnings` carries `exact_dates_partial` (some rows) or `exact_dates_unavailable` (none); on `channel/videos`, whose dates are already exact, the warnings are `original_titles_partial` and `original_titles_unavailable`. (true | false) |
| since | No | Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off each page. This list is not in date order, so the walk does not stop at the date: keep following `next_cursor`, and each page costs what a page costs even when every row on it is filtered out. A row with no date is kept. `published_after`, `start_date`, `from_date`, `publish_time` (`yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`) and `max_age_days` are accepted and applied as `since`. |
| until | No | Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept. `published_before`, `end_date` and `to_date` are accepted and applied as `until`. |
Example Response
What does the YouTube Channel Lives API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "youtube",
"endpoint": "/v1/youtube/channel/lives",
"data": {
"items": [
{
"post": {
"id": "o1_FvfJD8fg",
"url": "https://www.youtube.com/watch?v=o1_FvfJD8fg",
"content": {
"text": "I GOT A JOB AT KFC!",
"media_urls": null,
"thumbnail_url": "https://i.ytimg.com/vi/o1_FvfJD8fg/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUABovOX_wMOCPje5dUGGODqBCDgqAE=&rs=AOn4CLC9xeVhNw4Ai-w9Lj56gaWSyBqeHw&usqp=CBU",
"duration_seconds": 11033
},
"author": {
"username": "user_6a16c3",
"display_name": null,
"avatar_url": null,
"verified": null
},
"engagement": {
"views": 5100000,
"likes": null,
"comments": null,
"shares": null,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2026-09-27T18:48:39.000Z",
"ext": {
"content_type": "live",
"channel_id": null
}
},
"computed": {
"engagement_rate": null,
"language": null,
"content_category": "other",
"estimated_reach": 6120000
}
},
{
"post": {
"id": "GfCnZ8cAYvQ",
"url": "https://www.youtube.com/watch?v=GfCnZ8cAYvQ",
"content": {
"text": "JOIN THIS STREAM, WIN AN IPHONE 18!",
"media_urls": null,
"thumbnail_url": "https://i.ytimg.com/vi/GfCnZ8cAYvQ/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUABovOX_wMOCMzextUGGODqBCDgqAE=&rs=AOn4CLBr6IKi8id-0s0QTgK6COVFT96D8g&usqp=CBU",
"duration_seconds": 13826
},
"author": {
"username": "user_6a16c3",
"display_name": null,
"avatar_url": null,
"verified": null
},
"engagement": {
"views": 5300000,
"likes": null,
"comments": null,
"shares": null,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2026-09-21T22:04:12.000Z",
"ext": {
"content_type": "live",
"channel_id": null
}
},
"computed": {
"engagement_rate": null,
"language": null,
"content_category": "other",
"estimated_reach": 6360000
}
}
],
"next_cursor": "4qmFsgKdCxIYVUNXc0RGY0loWTJEQmkzR0I1dXlrR1hBGoALOGdhY0NCcVpDSEtXQ0RxVENBb2tObUl4TURBd1lXSXRNREF3TUMweU1UTmpMVGd4TmprdFpEUm1OVFEzWldabE56RTRFdWdIUVdaelYydHNObEJRTm5VMmEyTjBOMHRHZDFoVGVqRnpTMlprYTNOdU9WVmpVVFZWVkRkQ1dqSTFTSEJZZHpoWFRFZ3lVbEpzVVU1V1FXWjBlVlJyUTA1TlREQmhlR0ZsTjJwalpqaFNORTFYWTIxWGJtdHpURUU0U1d0WGRqVm5SbUpRYW5CR1NtY3RPRkp1WDAxdVZFcG1ZME5DYUhodVFqbHFNSGxOYzJWbVNsSnpVMTlJV210eGRXMWpRa1J0UlRkVWVTMVFOMFZPVVRaYWIxRnVaV2RQTjNkaWIzcDRibUpyVkRCamJXTlhjRWhPVlZkdFIwaDRZbk50U1U4MlUxaGxORGg1V1hKZk4zRkpiRnAxU3pCaWFIUkxWREpyYzJvek9VNHdMVEIzYWtKaVJIcEtMV2hrWWpkSk5uTlhkWFJMY0RRMVJtUlNkR0ZuU2poeldtNDRkV3Q2ZW1vMU5EVkpMV296U1VKNFNGSXpPREZSY0dnd05tNXpXVkpXVjBoVExURjNUbWhYTlZKNVJYWjBRWEJxVEVGVlQzbDRiRUpvTXpabmJYYzNiR0V5Vmt4MlNIRXpSRGRSTTJWNWRXY3lWblJKVjFsNlIyVnBkek5ZUmt0a1UwbG5XV2RIUjAxb1MyZzJiVEZFTjJsTFNrczJYMUZQUkRFeVNqUmhjbGxoVkhZMlF6VTNhSHAxYnpGclpXaE1RVXgzU2pBMVNuTlpORGw0VVdkTWRsaHBkVVJDUzNKVmJFMDBOeTFuZHpkVVVVWjFlRk5VV1hGSVVqbHlORlZzTkVSeGIzVkhYM001Umxad1ZVaHdXR0pQY1VWWU9ITXRNeTFLVlUwME5UbE5OSGM0TjFSTWJYWlJSM0UzU0VSMGVVczFlbk5wT0RNelVUZzVUVWt4Ym5oa2NrWnZVMlZFVVdoSU1ETXliVFJWVEZocVVuVm5OVUpTVDNKSldtUm5TRTF0WmxWRE1rSm9ZbmN3U2tsWVRrRkliR3QxWTFCV2EwUjBWMUl3U2pCbVlYVlJkMko0YkUxNlZHTnNaa28yUm1ScFZGTmxWRGxMYzNreGNrZG1VVzluVGxSRlJVTmFWRUZrUW5kYWJrd3RhV3MyWkhWeWRtOUhZVlJrVGxOU2VXdzRaMUEzY0haVmQxOUdOWEppYlROVFNWaEJhREl0YlVnd1pGTlpVRjlMUm14bGVVTm9jSFJCZFZRM1FrZFRZMG8zWXpReWIxUlZWM2g0UTIxMmR6ZENSbGRoYXkxek1HTTVZM2xIVWpORmJsVkhUV1pmVTJwVWNtVTJhMFI2Y0cxTVRrSkJYMkp6Y1ZkRmVWWkZia280UzBOVVdqSm5WazlKV0U5bVZWSjVlR0pxVlhwWmFuSk1iVEpZYjBoMGJrTXhUemhRTTBkQmJFY3hZbEJhY2tGalVrZFNSVmxOUlhwdmRreEpWbkZPYjBvd1kwNW1TRk50WmxGTWFqY3phbHA2TUdwQ2FXZzFielYyYTBGTExVOUpWbk5RVTI5WVVUWkVWVzVIVEhoSGRYaFlNVEJwTFV4WlNHdFdNa2RYTXpSZk5saGZZVk0xVDFvNVIwbFBhemhqVVZaelJHNW9WVkJ1U2t0d1IxOVdValZHYkZWS1QzUlFiMDlLYm1WWU16TjFlVEphZWpZeVYxaEtOMGhrTWw4NGNrUnplVGN3UmxGbmRtTnZTM3BKTW1WU1VpMHhjMk5sYmxWSmVrSnZkbE5GZG14SGRWWmFOekJGYzFWelQwSm1WbmQxUlJnTQ%3D%3D",
"total": null,
"dropped": 0
},
"credits_used": 1,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": "sc.eyJ2IjoyLCJjIjoiNHFtRnNnS2RDeElZVlVOWGMwUkdZMGxvV1RKRVFta3pSMEkxZFhsclIxaEJHb0FMT0dkaFkwTkNjVnBEU0V0WFEwUnhWRU5CYjJ0T2JVbDRUVVJCZDFsWFNYUk5SRUYzVFVNd2VVMVVUbXBNVkdkNFRtcHJkRnBFVW0xT1ZGRXpXbGRhYkU1NlJUUkZkV2RJVVZkYWVsWXlkSE5PYkVKUlRtNVZNbUV5VGpCT01IUkhaREZvVkdWcVJucFRNbHByWVROT2RVOVdWbXBWVkZaV1ZrUmtRMWRxU1RGVFNFSlpaSHBvV0ZSRlozbFZiRXB6VlZVMVYxRlhXakJsVmxKeVVUQTFUbFJFUW1obFIwWnNUakp3YWxwcWFGTk9SVEZZV1RJeFdHSnRkSHBVUlVVMFUxZDBXR1JxVm01U2JVcFJZVzVDUjFOdFkzUlBSa3AxV0RBeGRWWkZjRzFaTUU1RFlVaG9kVkZxYkhGTlNHeE9ZekpXYlZOc1NucFZNVGxKVjIxMGVHUlhNV3BSYTFKMFVsUmtWV1ZUTVZGT01GWlBWVlJhWVdJeFJuVmFWMlJRVGpOa2FXSXpjRFJpYlVweVZrUkNhbUpYVGxoalJXaFBWbFprZEZJd2FEUlpiazUwVTFVNE1sVXhhR3hPUkdnMVYxaEtaazR6UmtwaVJuQXhVM3BDYVdGSVVreFdSRXB5WXpKdmVrOVZOSGRNVkVJellXdEthVkpJY0V0TVYyaHJXV3BrU2s1dVRsaGtXRkpNWTBSUk1WSnRVbE5rUjBadVUycG9lbGR0TkRSa1YzUTJaVzF2TVU1RVZrcE1WMjk2VTFWS05GTkdTWHBQUkVaU1kwZG5kMDV0TlhwWFZrcFhWakJvVkV4VVJqTlViV2hZVGxaS05WSllXakJSV0VKeFZFVkdWbFF6YkRSaVJVcHZUWHBhYm1KWVl6TmlSMFY1Vm10NE1sTklSWHBTUkdSU1RUSldOV1JYWTNsV2JsSktWakZzTmxJeVZuQmtlazVaVW10MGExVXdiRzVYVjJSSVVqQXhiMU15WnpKaVZFWkZUakpzVEZOcmN6SllNVVpRVWtSRmVWTnFVbWhqYkd4b1ZraFpNbEY2VlROaFNIQXhZbnBHY2xwWGFFMVJWWGd6VTJwQk1WTnVUbHBPUkd3MFZWZGtUV1JzYUhCa1ZWSkRVek5LVm1KRk1EQk9lVEZ1Wkhwa1ZWVlZXakZsUms1VlYxaEdTVlZxYkhsT1JsWnpUa1ZTZUdJelZraFlNMDAxVW14YWQxWlZhSGRYUjBwUVkxVldXVTlJVFhSTmVURkxWbFV3TUU1VWJFNU9TR00wVGpGU1RXSllXbEpTTTBVelUwVlNNR1ZWY3pGbGJrNXdUMFJOZWxWVVp6VlVWV3Q0WW01b2EyTnJXblpWTWxaRlZWZG9TVTFFVFhsaVZGSldWRVpvY1ZWdVZtNU9WVXBUVkROS1NsZHRVbTVUUlRGMFdteFdSRTFyU205WmJtTjNVMnRzV1ZSclJrbGlSM1F4V1RGQ1YyRXdVakJXTVVsM1UycENiVmxZVmxKa01rbzBZa1V4TmxaSFRuTmFhMjh5VW0xU2NGWkdUbXhXUkd4TVl6TnJlR05yWkcxVlZ6bHVWR3hTUmxKVlRtRldSVVpyVVc1a1lXSnJkM1JoVjNNeVdraFdlV1J0T1VoWlZsSnJWR3hPVTJWWGR6UmFNVUV6WTBoYVZtUXhPVWRPV0VwcFlsUk9WRk5XYUVKaFJFbDBZbFZuZDFwR1RscFZSamxNVW0xNGJHVlZUbTlqU0ZKQ1pGWlJNMUZyWkZSWk1HOHpXWHBSZVdJeFVsWldNMmcwVVRJeE1tUjZaRU5TYkdSb1lYa3hlazFIVFRWWk0yeElWV3BPUm1Kc1ZraFVWMXBtVlRKd1ZXTnRWVEpoTUZJMlkwY3hUVlJyU2tKWU1rcDZZMVprUm1WV1drWmlhMjgwVXpCT1ZWZHFTbTVXYXpsS1YwVTViVlpXU2pWbFIwcHhWbGh3V21GdVNrMWlWRXBaWWpCb01HSnJUWGhVZW1oUlRUQmtRbUpGWTNoWmJFSmhZMnRHYWxWclpGTlNWbXhPVWxod2RtUnJlRXBXYmtaUFlqQnZkMWt3TlcxVFJrNTBXbXhHVFdGcVkzcGhiSEEyVFVkd1EyRlhaekZpZWxZeVlUQkdURXhWT1VwV2JrNVJWVEk1V1ZWVVdrVldWelZJVkVob1NHUllhRmxOVkVKd1RGVjRXbE5IZEZkTmEyUllUWHBTWms1c2FHWlpWazB4VkRGdk5WSXdiRkJoZW1ocVZWWmFlbEpITlc5V1ZrSjFVMnQwZDFJeE9WZFZhbFpIWWtaV1MxUXpVbEZpTURsTFltMVdXVTE2VGpGbFZFcGhaV3BaZVZZeGFFdE9NR2hyVFd3NE5HTnJVbnBsVkdOM1VteEdibVJ0VG5aVE0zQktUVzFXVTFWcE1IaGpNazVzWW14V1NtVnJTblprYkU1R1pHMTRTR1JXV21GT2VrSkdZekZXZWxRd1NtMVdibVF4VWxKblRRJTNEJTNEIiwiZSI6InlvdXR1YmUvY2hhbm5lbC9saXZlcyIsInAiOiJjb250aW51YXRpb25Ub2tlbiJ9",
"has_more": true,
"page_size": 30
},
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T07:30:06.979Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
API Details
How does the YouTube Channel Lives API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
Developer First
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 68 platforms covering 10B+ monthly active users.
One schema, every platform
Query 68 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()[ .JSON ]
{
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow do I list a YouTube channel's live streams?
Send a GET to /v1/youtube/channel/lives with a handle or channelId. The response lists live and past streams with title, URL, thumbnail, view count, publish time, and duration. The Live tab publishes no like or comment counts, so add include=engagement and those, the channel and the exact publish time are filled in the same call.
Does it include finished broadcasts or only live ones?
Both. The endpoint mirrors a channel's Live tab, so you get current live streams and the archive of past broadcasts in one feed.
Do I pass a handle or a channel ID?
Either. Provide handle (with or without @) or channelId for the first page. Exactly one of the two is required.
How do I page through all streams?
Each response carries a continuationToken when more results exist. Forward it on the next request and repeat until the token is empty to collect the full archive.
How much does the lives endpoint cost?
It costs 1 to 7 credits per request: the page price, plus whatever an include join filled, and every new account starts with 100 free credits to try it.
Ask AI about SocialCrawl
Ready to scrape YouTube Channel Lives data?
Get your API key and start pulling YouTube data in under 60 seconds.