YouTube SponsorBlock Segments Scraper

What it returns

41 fields from the published dataset schema. Export as JSON, CSV or Excel, or read the dataset through the Apify API.

• recordType
• videoId
• category
• actionType
• startTime
• endTime
• durationSeconds
• votes
• videoTitle
• videoUrl
• segmentId
• categoryName
• actionName
• videoDurationSeconds
• locked
• views
• timeSubmitted
• hidden
• shadowHidden
• submitterId
• submitterName
• submitterSegmentCount
• description
• channelName
• channelUrl
• channelId
• thumbnailUrl
• youtubeDurationSeconds
• videoViewCount
• publishedAt

Not in the schema among the core YouTube fields: duration, transcript. The field matrix shows which other tools return them.

How it differs from the other YouTube Actors

Among the 17 catalogue Actors for YouTube with a published schema, only this one returns endTime, votes, locked, timeSubmitted, shadowHidden, submitterId, actions.

Pick another Actor if you need

Input

Example input

Built from the input form's published example values and defaults.

{
  "videoUrls": [
    "https://www.youtube.com/watch?v=7wtfhZwyrcc"
  ],
  "categories": [
    "sponsor",
    "intro"
  ],
  "actionTypes": [],
  "source": "visible",
  "minVotes": 0,
  "includeHiddenSegments": false,
  "includeDescriptions": true,
  "includeSubmitterInfo": true,
  "includeYouTubeMetadata": true,
  "includeSummary": false,
  "maxSegmentsPerVideo": 0,
  "concurrency": 4
}

Run it from code or an AI agent

The same run through the Apify API, with the example input. You need an Apify API token; the run is billed to your account at the Store price.

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
    "videoUrls": [
        "https://www.youtube.com/watch?v=7wtfhZwyrcc"
    ],
    "categories": [
        "sponsor",
        "intro"
    ],
    "actionTypes": [],
    "source": "visible",
    "minVotes": 0,
    "includeHiddenSegments": False,
    "includeDescriptions": True,
    "includeSubmitterInfo": True,
    "includeYouTubeMetadata": True,
    "includeSummary": False,
    "maxSegmentsPerVideo": 0,
    "concurrency": 4
}

run = client.actor("dataspryva/youtube-sponsorblock-segments-scraper").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "videoUrls": [
        "https://www.youtube.com/watch?v=7wtfhZwyrcc"
    ],
    "categories": [
        "sponsor",
        "intro"
    ],
    "actionTypes": [],
    "source": "visible",
    "minVotes": 0,
    "includeHiddenSegments": false,
    "includeDescriptions": true,
    "includeSubmitterInfo": true,
    "includeYouTubeMetadata": true,
    "includeSummary": false,
    "maxSegmentsPerVideo": 0,
    "concurrency": 4
};

const run = await client.actor("dataspryva/youtube-sponsorblock-segments-scraper").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

curl -X POST "https://api.apify.com/v2/actors/dataspryva~youtube-sponsorblock-segments-scraper/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"videoUrls":["https://www.youtube.com/watch?v=7wtfhZwyrcc"],"categories":["sponsor","intro"],"actionTypes":[],"source":"visible","minVotes":0,"includeHiddenSegments":false,"includeDescriptions":true,"includeSubmitterInfo":true,"includeYouTubeMetadata":true,"includeSummary":false,"maxSegmentsPerVideo":0,"concurrency":4}'

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=dataspryva/youtube-sponsorblock-segments-scraper",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

What a run costs

The result rate falls on higher Apify plans. Each figure is the published per-result rate times the number of results.

• Every run also has a start event, charged per GB of memory (minimum one): $0.10 on Free, $0.03 on Business. At its default memory of 4 GB a run starts at $0.40 on Free. Fewer, larger runs keep this small.
• The Free plan includes $5 of monthly usage (Apify pricing, checked 2026-11-11); at the Free rate that covers at most about 5,050 results, less start events and platform usage.
• Worked example: 10,000 results in one run on the Free plan cost $10.30 ($9.90 for results + $0.40 start), plus Apify platform usage (compute), billed separately by Apify.
• Pay per event. Platform usage (compute) is billed by Apify on top of the event prices. Compare other tools in the cost estimator.

Where it fits among YouTube routes

It ranks 10 of 17 catalogue Actors for YouTube on the published formula (fields, price, reliability, freshness). Its line is highlighted on the map.

What people use it for

SponsorBlock records describe community-reported segments within YouTube videos, including category, action, start and end times, duration and votes, with optional video metadata. Analyses of sponsor reads, intros, filler or highlights need these within-video timestamps, whereas the catalogue's search, hashtag and channel tools describe videos as whole records.

Supply videoUrls with YouTube video links or video IDs, adding multiple entries for a batch.

• Build a review queue of sponsor segments using videoUrl, category, startTime and endTime.
• Compare community support for reported segments using votes, locked and category.
• Use optional summary rows to compare segmentCount, totalSegmentSeconds and categories across videos.
• Extract video timestamps
• Analyze segment categories

Tips

• Set categories to the SponsorBlock categories relevant to your analysis, or leave it empty to include every category.
• Use maxSegmentsPerVideo to cap segments after filtering and sorting by start time.

Other catalogue Actors for YouTube

Similar Actors

Questions people ask

Sources

• YouTube SponsorBlock Segments Scraper on Apify Store
• Published build with input and output schema (JSON)
• YouTube Data API v3 documentation