FetchFox
Get started

YouTube comments viewer API

Read available public YouTube comments and export the current batch as CSV or JSON.

Try with free creditsRead as Markdown

Make a request

GET /youtube/comments accepts query parameters. POST /youtube/comments accepts the same inputs as JSON. Send your project key in the x-access-key header; keep it on your server.

Credits: 1 credit per 50 returned comments, minimum 1 including verified empty results. Balance pre-check: 1 per 20 requested comments.

curl request example
curl
curl --fail-with-body --get 'https://api.fetchfox.net/youtube/comments' \
  -H 'x-access-key: YOUR_KEY' \
  --data-urlencode 'url=https://www.youtube.com/watch?v=VIDEO_ID' \
  --data-urlencode 'limit=20'
JavaScript request example
JavaScript
// Run on your server with FETCHFOX_API_KEY set.
const url = new URL('https://api.fetchfox.net/youtube/comments');
url.searchParams.set('url', 'https://www.youtube.com/watch?v=VIDEO_ID');
url.searchParams.set('limit', '20');
const response = await fetch(url, {
  headers: { 'x-access-key': process.env.FETCHFOX_API_KEY },
  signal: AbortSignal.timeout(130000)
});
if (!response.ok) throw new Error('HTTP ' + response.status);
const result = await response.json();
if (!result.success) throw new Error('Request unsuccessful');
console.log(result.data);
Python request example
Python
import json, os
from urllib.parse import urlencode
from urllib.request import Request, urlopen

query = urlencode({"url":"https://www.youtube.com/watch?v=VIDEO_ID","limit":20})
request = Request('https://api.fetchfox.net/youtube/comments?' + query,
    headers={'x-access-key': os.environ['FETCHFOX_API_KEY']})
with urlopen(request, timeout=130) as response:
    result = json.load(response)
if not result.get('success'):
    raise RuntimeError('Request unsuccessful')
print(result['data'])

Replace placeholder source IDs with real public URLs. See limits and retries before automating calls.

Inputs and limits

Requests up to 20 comments for 1 credit on success. Coverage can be partial; hidden comments and all replies are not included. YouTube does not provide a continuation cursor in this endpoint.

REST and MCP accept limits from 1 to 100, default 20. Browser viewers request 20. Each new request is billed separately; downloading a current browser result does not make another request.

Interpret source fields

data.comments returns available text and author fields. Numeric IDs stay strings; do not coerce them to spreadsheet numbers. Unknown likes, reply counts and dates stay null. Collection status describes the available sample, not complete coverage.

YouTube keeps source relativeTime and leaves exact date null when it cannot establish a timestamp. A source ID can also be null; IDs and dates are never invented.

Continue building