{"endpoint":{"id":"treg.youtube.video.comments","provider":"treg","provider_display":"treg","name":"youtube.video.comments — routed: best of 2 providers, own keys first","summary":"Comments on a YouTube video by id or URL — provider-native comment rows in `comments`","method":"POST","path":"/youtube.video.comments","scope":"","tier":"core","kind":"routed","domain":"routed","call_template":"treg call treg.youtube.video.comments --method POST --data '{\"video_id\":\"…\"}'","cost":{"type":"per_success","value":0.001,"currency":"USD","per":1,"unit":"call","source":"inferred","confidence":"documented","checked":null,"note":"the children's range $0.001–$0.00188 per hit; you pay exactly the child that served, 0% markup","usd":0.001},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":200,"means":"output.comments == []"},"status":null,"status_note":null,"superseded_by":null,"verified":null,"docs_url":"","has_example":false,"input":{"bodyType":"json","body":{"video_id":{"type":"str","required":false,"note":"identity key (part of video_id)"},"url":{"type":"url","required":false,"note":"identity key (part of url)"}},"note":"Send everything you know about the subject — treg derives the rest (full_name ⇄ first+last), matches each provider on the variants it accepts ({video_id} | {url}) and sends each provider only the fields it wants. On a miss treg keeps trying providers, cheapest first, within X-Treg-Route-Max-Cost (default $1 per call; misses on per-success providers are free). Options ride as headers, never in the body: X-Treg-Route-Waterfall: 0 (stop at the first miss), X-Treg-Route-Max-Cost: <usd>, X-Treg-Route-Prefer / X-Treg-Route-Exclude: <provider>. The response is {output, raw, _treg: {served_by, tried}}; X-Treg-Served-By names the child."},"test_request":{"body":{"video_id":"…"}},"routed_children":["scrapecreators.youtube.video.comments","tikhub.youtube.video.comments"],"capability":"youtube.video.comments","capability_description":"List a video's comments","platform":"youtube","platform_label":"YouTube","observed":{"samples":32,"decided":32,"ok_rate":0.9375,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},"provider":{"service":"treg","display_name":"treg"},"siblings":[{"id":"brightdata.x.youtube-comments","provider":"brightdata","provider_display":"Bright Data","name":"YouTube video comments by video URL","summary":"Youtube - Comments","method":"POST","path":"/datasets/v3/scrape","scope":"any_account","tier":"extended","kind":"data","domain":"video","call_template":"treg call brightdata.x.youtube-comments --method POST --query dataset_id=gd_lk9q0ew71spt1mxywf --data '{\"input\":[{\"url\":\"https://example.com/\"}]}'","cost":{"type":"per_result","value":0.0015,"currency":"USD","per":1,"unit":"record","source":"docs","source_url":"https://brightdata.com/pricing","checked":"2026-07-28","confidence":"documented","note":"$1.50 per 1000 records delivered, pay-per-success — the general Web Scraper API rate documented for this product family; some datasets carry different published rates, confirm on brightdata.com/pricing before volume use","usd":0.0015},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"docs_url":"https://docs.brightdata.com/datasets/scrapers/youtube/quickstart","has_example":false,"input":{"queryParams":{"dataset_id":{"type":"string","required":true,"note":"pinned to the documented 'Youtube - Comments' dataset","example":"gd_lk9q0ew71spt1mxywf"},"format":{"type":"string","required":false,"note":"json (default) | ndjson | csv"}},"body":{"input":{"type":"array","required":true,"note":"one object per target — a YouTube video URL to fetch its comments","example":[{"url":"https://example.com/"}]}},"bodyType":"json","note":"same generic runner as brightdata.web.scrape.structured with dataset_id fixed to this dataset (see that entry and brightdata.instagram.user.profile in the core file for the pattern). >1 minute falls back to HTTP 202 + snapshot_id — use brightdata.web.scrape.job.start for anything beyond a handful of URLs. Exact required body fields were not individually re-confirmed per dataset here; verify against the dataset's own quickstart page before high-volume use."},"test_request":null,"observed":null},{"id":"justoneapi.x.youtube-get-video-comment-v1","provider":"justoneapi","provider_display":"Just One API","name":"YouTube video comments by video id","summary":"Retrieve first-level comments for a YouTube video with sorting, locale options, and cursor pagination.","method":"GET","path":"/api/youtube/get-video-comment/v1","scope":"","tier":"extended","kind":"data","domain":"video","call_template":"treg call justoneapi.x.youtube-get-video-comment-v1 --query videoId=dQw4w9WgXcQ --query cursor=0 --query languageCode=zh-CN --query countryCode=US --query sortBy=newest","cost":{"type":"per_success","value":0.1,"currency":"CNY","per":1,"unit":"call","source":"rate_card_api","source_url":"https://www.justoneapi.com/","checked":"2026-07-28","confidence":"documented","note":"billed only on success (code 0); errors free","usd":0.01476},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","docs_url":"https://docs.justoneapi.com/en/api/youtube/video-comment-list-v1","has_example":true,"input":{"queryParams":{"videoId":{"type":"string","required":true,"note":"The unique identifier for a YouTube video."},"cursor":{"type":"string","required":false,"note":"Pagination cursor returned by the previous response.","example":""},"languageCode":{"type":"string","required":false,"note":"Language preference for response data.","example":"zh-CN"},"countryCode":{"type":"string","required":false,"note":"Region code for response data.","example":"US"},"sortBy":{"type":"string","required":false,"enum":["top","newest"],"note":"Sort order for the comment list. Available Values: - `top`: Top comments - `newest`: Newest comments One of: top, newest.","example":"newest"}}},"test_request":{"queryParams":{"videoId":"dQw4w9WgXcQ","cursor":"0","languageCode":"zh-CN","countryCode":"US","sortBy":"newest"}},"observed":null},{"id":"scrapecreators.youtube.video.comments","provider":"scrapecreators","provider_display":"ScrapeCreators","name":"YouTube video comments by URL — replies, likes, authors","summary":"Fetches comments and replies from a YouTube video, including each comment's text, author details, like count, reply count, and publish date.","method":"GET","path":"/v1/youtube/video/comments","scope":"any_account","tier":"core","kind":"data","domain":"video","call_template":"treg call scrapecreators.youtube.video.comments --query 'url=https://www.youtube.com/watch?v=dQw4w9WgXcQ'","cost":{"type":"per_call","value":1,"currency":"credit","per":1,"unit":"call","source":"rate_card_api","source_url":"https://docs.scrapecreators.com/openapi.json","checked":"2026-07-28","confidence":"verified","usd":0.00188},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","docs_url":"https://docs.scrapecreators.com/youtube/video/comments","has_example":true,"input":{"queryParams":{"url":{"type":"string","required":true,"note":"YouTube video URL","example":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"},"order":{"type":"string","required":false,"note":"Order of comments","example":"top"}}},"test_request":{"queryParams":{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}},"observed":null},{"id":"tikhub.youtube.video.comments","provider":"tikhub","provider_display":"TikHub","name":"YouTube video comments by video id","summary":"Comments on a YouTube video","method":"GET","path":"/api/v1/youtube/web_v2/get_video_comments","scope":"any_account","tier":"core","kind":"data","domain":"video","call_template":"treg call tikhub.youtube.video.comments --query video_id=dQw4w9WgXcQ --query language_code=en-US","cost":{"type":"per_success","value":0.001,"currency":"USD","per":1,"unit":"call","source":"rate_card_api","source_url":"https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info","checked":"2026-07-28","confidence":"verified","usd":0.001},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","docs_url":"https://docs.tikhub.io/","has_example":true,"input":{"queryParams":{"video_id":{"type":"string","required":true,"example":"dQw4w9WgXcQ"},"language_code":{"type":"string","required":false,"note":"default zh-CN","example":"en-US"},"country_code":{"type":"string","required":false,"note":"default US"},"sort_by":{"type":"string","required":false,"note":"top (default) | newest"},"continuation_token":{"type":"string","required":false,"note":"pagination token from the previous response"},"need_format":{"type":"boolean","required":false}}},"test_request":{"queryParams":{"video_id":"dQw4w9WgXcQ","language_code":"en-US"}},"observed":{"samples":122,"decided":116,"ok_rate":1.0,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":1.0,"hit_samples":113}},{"id":"youtube.youtube.video.comments","provider":"youtube","provider_display":"YouTube","name":"List comments on a YouTube video by video id","summary":"List the comments on a YouTube video (any public video, not just your own)","method":"GET","path":"/youtube/v3/commentThreads","scope":"any_account","tier":"core","kind":"data","domain":"video","call_template":"treg call youtube.youtube.video.comments --query part=snippet --query videoId=dQw4w9WgXcQ --query maxResults=2","cost":{"type":"free","value":0,"currency":"USD","unit":"call","note":"included with the connected account; 1 quota unit","usd":0.0},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","docs_url":"https://developers.google.com/youtube/v3/docs/commentThreads/list","has_example":true,"input":{"queryParams":{"part":{"type":"string","required":true,"example":"snippet,replies"},"videoId":{"type":"string","required":true,"example":"dQw4w9WgXcQ"},"order":{"type":"string","required":false,"note":"time (default) | relevance","example":"relevance"},"maxResults":{"type":"integer","required":false,"note":"1–100, default 20","example":20},"pageToken":{"type":"string","required":false},"textFormat":{"type":"string","required":false,"note":"html (default) | plainText","example":"plainText"}},"note":"returns top-level threads; each carries up to 5 replies — fetch the rest via comments.list with parentId. Videos with comments disabled answer 403 commentsDisabled"},"test_request":{"queryParams":{"part":"snippet","videoId":"dQw4w9WgXcQ","maxResults":2}},"observed":null}],"related_capabilities":[{"endpoint_id":"treg.youtube.channel.profile","capability":"youtube.channel.profile","does":"A channel's profile & lifetime stats"},{"endpoint_id":"treg.youtube.channel.videos","capability":"youtube.channel.videos","does":"List a channel's videos"},{"endpoint_id":"treg.youtube.search.videos","capability":"youtube.search.videos","does":"Search videos by keyword"},{"endpoint_id":"treg.youtube.video.detail","capability":"youtube.video.detail","does":"Get a video's metadata & stats"}],"routing":{"contract":{"identity":[["video_id"],["url"]],"output":{"comments":{"type":"list","required":true},"next_cursor":{"type":"str"}},"miss":"comments == []","derive":{}},"plan":[{"endpoint_id":"tikhub.youtube.video.comments","accepts":[["video_id"]],"usd":0.001,"hit_rate":1.0,"usd_per_hit":0.001,"works":1.0},{"endpoint_id":"scrapecreators.youtube.video.comments","accepts":[["url"]],"usd":0.00188}],"also":[{"endpoint_id":"brightdata.x.youtube-comments","usd":0.0015},{"endpoint_id":"justoneapi.x.youtube-get-video-comment-v1","usd":0.01476},{"endpoint_id":"youtube.youtube.video.comments","usd":0.0}],"headers":{"X-Treg-Route-Waterfall":"on by default: a miss tries the next provider; 0 = stop at the first miss","X-Treg-Route-Max-Cost":"USD ceiling for the whole call (default 1.00)","X-Treg-Route-Prefer":"provider[,…]","X-Treg-Route-Exclude":"provider[,…]","X-Treg-Route-Strict-Filters":"1 = never call a provider that cannot apply a filter you sent (answers 422, nothing charged); off by default — the answer names what was ignored in X-Treg-Ignored-Filters"}},"call_template":"treg call treg.youtube.video.comments --method POST --data '{\"video_id\":\"…\"}'","example_response":null,"hints":["treg call treg.youtube.video.comments --method POST --data '{\"video_id\":\"…\"}'   # run it — key injected server-side","treg catalog get brightdata.x.youtube-comments   # the same job from brightdata"]}