> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hasdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube Comments Scraper API

The YouTube Comments Scraper API returns the comments of a YouTube video or short, with pagination.

> [!NOTE]
>
> HasData is an independent service and is not affiliated with, endorsed by, or sponsored by YouTube. YouTube is a trademark of its respective owner. This API works with publicly available data only.

## Get Your API Key

Sign in at [hasdata.com](https://app.hasdata.com/sign-in), go to your account settings, and copy your API key.
All requests must include your key in the `x-api-key` header.

## Request Cost and API Credits

Each request to the YouTube Comments Scraper API consumes **API Credits** from your account balance.

* **Cost per request:** 10 API Credits
* Credits are deducted only for successful requests.
* Your total available credits depend on your active plan.

> [!TIP]
>
> You can use your credits across all HasData APIs. The same credit balance is shared platform-wide.

> [!WARNING]
>
> **Unused credits do not roll over.** Any remaining credits expire at the end of the current billing period.

To monitor your credit usage and remaining balance, sign in to your account dashboard at [app.hasdata.com](https://app.hasdata.com/sign-in).

## Make Your First Request

```bash cURL theme={null}
curl --request GET -G \
  --url 'https://api.hasdata.com/scrape/youtube/comments' \
  --data-urlencode 'v=dQw4w9WgXcQ' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>'
```

```javascript Node.js theme={null}
const axios = require('axios').default;

const options = {
  method: 'GET',
  url: 'https://api.hasdata.com/scrape/youtube/comments',
  params: {v: 'dQw4w9WgXcQ'},
  headers: {'Content-Type': 'application/json', 'x-api-key': '<your-api-key>'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```python Python theme={null}
import requests

url = "https://api.hasdata.com/scrape/youtube/comments"

querystring = {"v":"dQw4w9WgXcQ"}

headers = {
    "Content-Type": "application/json",
    "x-api-key": "<your-api-key>"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```php PHP theme={null}
<?php

$params = [
    "v" => "dQw4w9WgXcQ",
];

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hasdata.com/scrape/youtube/comments?" . http_build_query($params),
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <your-api-key>",
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
```

```java Java theme={null}
OkHttpClient client = new OkHttpClient();

HttpUrl url = HttpUrl.parse("https://api.hasdata.com/scrape/youtube/comments")
  .newBuilder()
  .addQueryParameter("v", "dQw4w9WgXcQ")
  .build();

Request request = new Request.Builder()
  .url(url)
  .get()
  .addHeader("Content-Type", "application/json")
  .addHeader("x-api-key", "<your-api-key>")
  .build();

Response response = client.newCall(request).execute();
```

```csharp C# theme={null}
using System.Net.Http;
using System.Web;

var client = new HttpClient();

var query = HttpUtility.ParseQueryString(string.Empty);
query["v"] = "dQw4w9WgXcQ";

var url = $"https://api.hasdata.com/scrape/youtube/comments?{query}";

var request = new HttpRequestMessage(new HttpMethod("GET"), url);
request.Headers.Add("x-api-key", "<your-api-key>");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
```

```ruby Ruby theme={null}
require 'net/http'
require 'uri'

uri = URI("https://api.hasdata.com/scrape/youtube/comments")
params = {
  "v" => "dQw4w9WgXcQ",
}
uri.query = URI.encode_www_form(params)

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Content-Type"] = 'application/json'
request["x-api-key"] = '<your-api-key>'

response = http.request(request)
puts response.read_body
```

```rust Rust theme={null}
use reqwest::blocking::Client;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let res = client
        .get("https://api.hasdata.com/scrape/youtube/comments")
        .query(&[("v", "dQw4w9WgXcQ")])
        .header("Content-Type", "application/json")
        .header("x-api-key", "<your-api-key>")
        .send()?
        .text()?;
    println!("{}", res);
    Ok(())
}
```

```go Go theme={null}
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	params := url.Values{}
	params.Set("v", "dQw4w9WgXcQ")

	u := "https://api.hasdata.com/scrape/youtube/comments?" + params.Encode()

	req, _ := http.NewRequest("GET", u, nil)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("x-api-key", "<your-api-key>")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}
```

## API Parameters

| Parameter | Default Value | Required | Description |
| - | - | - | - |
| `v` | dQw4w9WgXcQ | No | 11-character YouTube video ID — the value of the `v=` query parameter in a watch URL (e.g. `dQw4w9WgXcQ` for `https://www.youtube.com/watch?v=dQw4w9WgXcQ`). Required for the first page; omit it on continuation requests that pass `nextPageToken`. |
| `gl` | - | No | The two-letter country code for the country you want to limit the search to. |
| `hl` | - | No | The two-letter language code for the language you want to use for the search. |
| `deviceType` | - | No | Device type for the request. |
| `nextPageToken` | - | No | Token to fetch the next page of comments. Pass the `nextPageToken` from a previous response; omit it for the first page. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.