Skip to main content

Comments

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READscrape-creators.scrape_creators_youtube_get_v1_youtube_video_comments
  • Contract tier: legacy
  • Risk: read
  • Catalog version: scrape-creators-2026.07.12.1
  • Descriptor hash: 4182a8ac628226529bc92b618188685d389fd72d14584a3c657f1e67f1453d95

Use this when you need ScrapeCreators YouTube data from GET /v1/youtube/video/comments for Comments. Fetches comments and replies from a YouTube video, including each comment's text content, author details, like count, reply count, and publish date. Supports ordering by top or newest, and paginating with continuationToken. Limited to approximately 1,000 top comments or 7,000 newest comments. Returns the ScrapeCreators response in the standard MCP envelope with ok/data/error/meta. This is read-only. Requires the portal grant header and a ScrapeCreators BYOK API key.

Request Body​

{
  "jsonrpc": "2.0",
  "id": "scrape-creators-scrape-creators-youtube-get-v1-youtube-video-comments-example",
  "method": "tools/call",
  "params": {
    "name": "scrape-creators.scrape_creators_youtube_get_v1_youtube_video_comments",
    "arguments": {
      "url": "",
      "body": "",
      "order": "top",
      "params": "",
      "compact": "",
      "max_items": "",
      "include_raw": false,
      "path_params": "",
      "cache_ttl_seconds": "",
      "confirm_high_cost": false
    }
  }
}

Arguments Schema​

{
  "type": "object",
  "properties": {
    "url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Url",
      "default": null,
      "description": "YouTube video URL"
    },
    "body": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "null"
        }
      ],
      "title": "Body",
      "default": null,
      "description": "JSON request body for provider endpoints that accept one."
    },
    "order": {
      "enum": [
        "top",
        "newest"
      ],
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Order",
      "default": null,
      "description": "Order of comments"
    },
    "params": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "title": "Params",
      "default": null,
      "description": "Optional advanced query parameter object. Prefer the documented top-level parameters when available."
    },
    "compact": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Compact",
      "default": null,
      "description": "When true, trims large list payloads before returning them to the agent."
    },
    "max_items": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Items",
      "default": null,
      "description": "Maximum number of list items to return when compacting provider responses."
    },
    "include_raw": {
      "type": "boolean",
      "title": "Include Raw",
      "default": false,
      "description": "When true, returns both compact normalized data and the raw provider payload; this can be large."
    },
    "path_params": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "title": "Path Params",
      "default": null,
      "description": "Path template values for endpoints that expose path placeholders."
    },
    "cache_ttl_seconds": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cache Ttl Seconds",
      "default": null,
      "description": "Optional cache lifetime for idempotent GET requests."
    },
    "confirm_high_cost": {
      "type": "boolean",
      "title": "Confirm High Cost",
      "default": false,
      "description": "Set true only when intentionally running a high-credit or write-intent request."
    },
    "continuationToken": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Continuationtoken",
      "default": null,
      "description": "Continuation token to get more comments. Get 'continuationToken' from previous response."
    }
  },
  "additionalProperties": false
}

Output Schema​

{
  "type": "object",
  "required": [
    "ok",
    "data",
    "error",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the local or provider operation completed successfully."
    },
    "data": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Bounded operation result when ok is true."
    },
    "meta": {
      "type": "object",
      "description": "Safe request, pagination, cache, and timing metadata.",
      "additionalProperties": true
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "description": "Safe structured error when ok is false."
    }
  },
  "description": "Scrape Creators MCP normalized response envelope.",
  "additionalProperties": false
}

Code Examples​

curl -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "scrape-creators-scrape-creators-youtube-get-v1-youtube-video-comments-example",
  "method": "tools/call",
  "params": {
    "name": "scrape-creators.scrape_creators_youtube_get_v1_youtube_video_comments",
    "arguments": {
      "url": "",
      "body": "",
      "order": "top",
      "params": "",
      "compact": "",
      "max_items": "",
      "include_raw": false,
      "path_params": "",
      "cache_ttl_seconds": "",
      "confirm_high_cost": false
    }
  }
}'

Example Responses​

{
  "ok": true,
  "message": "Tool scrape-creators.scrape_creators_youtube_get_v1_youtube_video_comments executed successfully.",
  "note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}