{"endpoint":{"id":"treg.youtube.video.comments","provider":"treg","provider_display":"treg","name":"youtube.video.comments — routed: best of 3 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":"video","call_template":"treg call treg.youtube.video.comments --method POST --data '{\"video_id\":\"…\"}'","cost":{"type":"per_success","value":0.0009,"currency":"USD","per":1,"unit":"call","source":"inferred","confidence":"documented","checked":null,"varies":true,"note":"NOT free: misses are billed too. the children's range $0.0009–$0.00188 per hit, 0% markup; you pay the child that served AND every child tried before it that bills a miss (1 of 3 do), up to X-Treg-Route-Max-Cost (default $1 a call). X-Treg-Route-Exclude them, or X-Treg-Route-Waterfall: 0, to pay for one provider only","usd":0.0009},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":200,"means":"output.comments == []"},"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":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":["crawl4ai.youtube.video.comments","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":13874,"decided":13757,"ok_rate":0.9735,"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","scope":"any_account","kind":"data","cost":{"type":"per_result","value":0.0015,"currency":"USD","per":1,"unit":"record","usd":0.0015},"platform_eligible":false,"status":null,"status_note":null,"superseded_by":null,"verified":null,"params":["dataset_id","format","input"],"observed":null},{"id":"crawl4ai.youtube.video.comments","provider":"crawl4ai","provider_display":"Crawl4AI","name":"Comments of a YouTube video","scope":"any_account","kind":"data","cost":{"type":"per_success","value":0.9,"currency":"credit","per":1,"unit":"call","usd":0.0009},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-10-11","params":["limit","video"],"observed":{"samples":12948,"decided":12933,"ok_rate":1.0,"p50_ms":1374,"p95_ms":4842,"last_ok_days":0,"hit_rate":0.8098,"hit_samples":12933}},{"id":"justoneapi.x.youtube-get-video-comment-v1","provider":"justoneapi","provider_display":"Just One API","name":"YouTube video comments by video id","scope":"","kind":"data","cost":{"type":"per_success","value":0.1,"currency":"CNY","per":1,"unit":"call","usd":0.01476},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","params":["videoId","cursor","languageCode","countryCode","sortBy"],"observed":null},{"id":"scrapecreators.youtube.video.comments","provider":"scrapecreators","provider_display":"ScrapeCreators","name":"YouTube video comments by URL — replies, likes, authors","scope":"any_account","kind":"data","cost":{"type":"per_call","value":1,"currency":"credit","per":1,"unit":"call","usd":0.00188},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","params":["url","order"],"observed":null,"reviews":{"teams":0}},{"id":"tikhub.youtube.video.comments","provider":"tikhub","provider_display":"TikHub","name":"YouTube video comments by video id","scope":"any_account","kind":"data","cost":{"type":"per_success","value":0.001,"currency":"USD","per":1,"unit":"call","usd":0.001},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","params":["video_id","language_code","country_code","sort_by","continuation_token","need_format"],"observed":null,"reviews":{"teams":0}},{"id":"youtube.youtube.video.comments","provider":"youtube","provider_display":"YouTube","name":"List comments on a YouTube video by video id","scope":"any_account","kind":"data","cost":{"type":"free","value":0,"currency":"USD","unit":"call","usd":0.0},"platform_eligible":true,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-07-28","params":["part","videoId","order","maxResults","pageToken","textFormat"],"observed":null}],"observed_pending":true,"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":"crawl4ai.youtube.video.comments","accepts":[["video_id"]],"usd":0.0009,"hit_rate":0.8098,"usd_per_hit":0.0009,"works":1.0},{"endpoint_id":"tikhub.youtube.video.comments","accepts":[["video_id"]],"usd":0.001},{"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"]}