YouTube videos, channels, and comments — 10 modes

YouTube videos, channels, and comments — 10 modes.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://hirescrape.com/api/tools/youtube

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "mode": "video",
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "description": "YouTube videos, channels, and comments \u2014 10 modes.",
          "properties": {
            "all_tabs": {
              "description": "Scrape all tabs on the destination page.",
              "type": "boolean"
            },
            "country": {
              "description": "Country code (e.g. US, GB).",
              "type": "string"
            },
            "duration": {
              "description": "Duration filter (Under 4 minutes / 4-20 minutes / Over 20 minutes).",
              "type": "string"
            },
            "end_date": {
              "description": "End date (YYYY-MM-DD).",
              "type": "string"
            },
            "features": {
              "description": "Feature filter (4K / HD / Creative Commons / Subtitles).",
              "type": "string"
            },
            "hashtag": {
              "description": "Hashtag (without #).",
              "type": "string"
            },
            "keyword": {
              "description": "Search keyword.",
              "type": "string"
            },
            "keyword_search": {
              "description": "Keyword for filtered video search.",
              "type": "string"
            },
            "limit": {
              "default": 20,
              "description": "Max items to collect (applies to paginated modes).",
              "maximum": 500,
              "minimum": 1,
              "type": "integer"
            },
            "mode": {
              "default": "video",
              "description": "Which endpoint to call. Options: video, videos_by_explore, videos_by_hashtag, videos_by_keyword, videos_by_podcast_url, videos_by_search_filters, videos_by_url, channel, channels_by_keyword, comments.",
              "enum": [
                "video",
                "videos_by_explore",
                "videos_by_hashtag",
                "videos_by_keyword",
                "videos_by_podcast_url",
                "videos_by_search_filters",
                "videos_by_url",
                "channel",
                "channels_by_keyword",
                "comments"
              ],
              "type": "string"
            },
            "num_of_posts": {
              "description": "Max records to collect (0 = provider default).",
              "type": "integer"
            },
            "order_by": {
              "description": "Sort order for discovered videos (Latest / Oldest / Popular).",
              "type": "string"
            },
            "sort_by": {
              "description": "Sort key (depends on endpoint).",
              "type": "string"
            },
            "start_date": {
              "description": "Start date (YYYY-MM-DD).",
              "type": "string"
            },
            "time_period": {
              "description": "Lookback window (e.g. '1 day ago', '1 month ago', '1 year ago').",
              "type": "string"
            },
            "transcription_language": {
              "description": "BCP-47 language code for transcript (e.g. en, es). Empty = auto.",
              "type": "string"
            },
            "type": {
              "description": "Content type (all or shorts).",
              "type": "string"
            },
            "upload_date": {
              "description": "Upload recency filter (Today / Week / Month / Year).",
              "type": "string"
            },
            "url": {
              "description": "Full URL of the target object.",
              "type": "string"
            }
          },
          "required": [
            "mode"
          ],
          "title": "YouTube Scraper",
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "duration": {
              "description": "Run duration in seconds.",
              "type": "integer"
            },
            "items": {
              "description": "Scraped items. Shape varies per tool \u2014 see each tool's outputSample for a concrete example.",
              "items": {
                "type": "object"
              },
              "type": "array"
            },
            "payment": {
              "description": "Settlement summary (protocol, amount, currency).",
              "type": "object"
            },
            "runId": {
              "description": "Run ID for debugging/audit.",
              "type": "string"
            }
          },
          "required": [
            "items"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON