# Komentar YouTube Lanjutan Langsung

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/serp/youtube/video_comments/live/advanced`

**Tags:** DataForSEO

Mengembalikan komentar pada satu video YouTube, secara sinkron. Mengembalikan `keyword`, `type`, `se_domain`, `location_code`, `language_code`, `check_url`, `datetime`, `spell`, `refinement_chips`, `item_types`, `items_count`, dan `items`. `advanced` adalah pilihan default; ambil `regular` bila hanya daftar peringkat yang penting dan `html` hanya untuk memeriksa apa yang dibuang parser. Dibungkus dalam envelope DataForSEO: data di `tasks[0].result`, hasil di `tasks[0].status_code` - permintaan yang ditolak tetap mengembalikan HTTP 200.

### Referensi harga

- Metering: Biaya respons yang dilaporkan.
- Estimasi referensi per permintaan: USD 0.004.
- Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

## Related links

- [YouTube Organic](<https://docs.dataforseo.com/v3/serp/youtube/organic/live/advanced/>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "video_id": {
            "type": "string",
            "description": "<em>ID video</em><br><strong>field wajib</strong><br>Anda dapat menemukan ID video di URL atau item 'youtube_video' pada hasil YouTube Organic<br>contoh:<br><code>vQXvyV0zIP4</code>"
          },
          "location_name": {
            "type": "string",
            "description": "<em>nama lengkap lokasi mesin pencari</em><br><strong>field wajib jika Anda tidak menentukan</strong> <code>location_code</code><br><strong>jika Anda menggunakan field ini, Anda tidak perlu menentukan <code>location_code</code></strong><br>Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta <code>location_name</code>-nya dengan membuat permintaan terpisah ke <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>contoh:<br><code class=\"long-string\">United States</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>kode lokasi mesin pencari</em><br><strong>field wajib jika Anda tidak menentukan</strong> <code>location_name</code><br><strong>jika Anda menggunakan field ini, Anda tidak perlu menentukan <code>location_name</code></strong><br>Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta <code>location_code</code>-nya dengan membuat permintaan terpisah ke <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>contoh:<br><code class=\"long-string\">2840</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>nama lengkap bahasa mesin pencari</em><br><strong>field wajib jika Anda tidak menentukan</strong> <code>language_code</code><br><strong>jika Anda menggunakan field ini, Anda tidak perlu menentukan <code>language_code</code></strong><br>Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta <code>language_name</code>-nya dengan membuat permintaan terpisah ke <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><br>contoh:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>kode bahasa mesin pencari</em><br><strong>field wajib jika Anda tidak menentukan</strong> <code>language_name</code><br><strong>jika Anda menggunakan field ini, Anda tidak perlu menentukan <code>language_name</code></strong><br>Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta <code>language_code</code>-nya dengan membuat permintaan terpisah ke <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><em><br></em>contoh:<em><br></em><code class=\"long-string\">en</code>"
          },
          "device": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>jenis perangkat</em><br>field opsional<br>hanya nilai: <code>desktop</code>"
          },
          "os": {
            "type": [
              "string",
              "null"
            ]
          },
          "depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>kedalaman parsing</em><br>field opsional<br>jumlah hasil di SERP<br>nilai default: <code>20</code><br>nilai maksimum: <code>200</code><br><strong>Catatan:</strong> akun Anda akan ditagih untuk setiap SERP yang berisi hingga 20 hasil;<br>dengan demikian, menetapkan kedalaman di atas <code>20</code> dapat mengakibatkan biaya tambahan jika mesin pencari mengembalikan lebih dari 20 hasil;<br>jika kedalaman yang ditentukan lebih tinggi dari jumlah hasil dalam respons, selisihnya akan dikembalikan secara otomatis ke saldo akun Anda"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>pengenal tugas yang ditentukan pengguna</em><br>field opsional<br><em>batas karakter adalah 255</em><br>Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil<br>Anda akan menemukan nilai <code>tag</code> yang ditentukan di objek <code>data</code> pada respons"
          }
        },
        "example": [
          {
            "language_code": "en",
            "location_code": 2840,
            "video_id": "vQXvyV0zIP4"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_code": "en",
      "location_code": 2840,
      "video_id": "vQXvyV0zIP4"
    }
  ]
}
```

## Responses

### 200 — Operasi berhasil

Headers:
- `X-Request-Id` (string) — Pengenal permintaan yang harus disertakan saat menghubungi dukungan Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoCommentsLiveAdvancedResponseInfo"
    }
  ]
}
```

### 400 — Permintaan tidak dapat diproses. Periksa parameter permintaan.

### 401 — Kunci API Felo yang valid diperlukan.

### 402 — Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

### 403 — Akun tidak diizinkan melakukan operasi ini.

### 429 — Batas permintaan atau batas pengeluaran telah tercapai.

### 502 — Layanan tidak dapat menyelesaikan permintaan.

### 503 — API atau layanan penagihan untuk sementara tidak tersedia.

### 504 — Layanan kehabisan waktu saat memproses permintaan.

### default — Respons error; respons passthrough upstream dapat menggunakan format penyedia

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "versi API saat ini"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "total waktu eksekusi, detik"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "total biaya tugas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "jumlah tugas dalam array tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "jumlah tugas dalam array tasks yang dikembalikan dengan error",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "waktu eksekusi, detik"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "total biaya tugas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "jumlah elemen dalam array hasil",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "Jalur URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST"
    }
  }
}
```

### Response36Afe1097B20_SerpYoutubeVideoCommentsLiveAdvancedResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoCommentsLiveAdvancedResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoCommentsLiveAdvancedTaskInfo"
              }
            ]
          },
          "description": "<em>array tugas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SerpYoutubeVideoCommentsLiveAdvancedResultInfo

`#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoCommentsLiveAdvancedResultInfo`

```json
{
  "type": "object",
  "properties": {
    "video_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>ID video yang diterima dalam array POST</em>"
    },
    "se_domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>domain mesin pencari dalam array POST</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>kode lokasi dalam array POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>kode bahasa dalam array POST</em>"
    },
    "check_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL langsung ke hasil mesin penelusuran<br></em>Anda dapat menggunakannya untuk memastikan bahwa kami memberikan hasil yang akurat"
    },
    "datetime": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>tanggal dan waktu saat hasil diterima</em><br>dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>misalnya:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "spell": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_SpellInfo"
        }
      ],
      "description": "<em>koreksi otomatis mesin pencari</em><br>jika mesin pencari memberikan hasil untuk kata kunci yang telah dikoreksi, kami akan menentukan kata kunci yang dikoreksi oleh mesin pencari dan jenis koreksi otomatisnya"
    },
    "item_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>jenis hasil penelusuran di SERP</em><br>berisi jenis hasil penelusuran (<code>items</code>) yang ditemukan di SERP.<br>item yang mungkin:<br><code>youtube_comment</code>"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>judul video</em>"
    },
    "comments_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah komentar pada video</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah hasil yang dikembalikan dalam array <strong><code>items</code></strong></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_YoutubeComment"
          }
        ]
      },
      "description": "<em>elemen hasil pencarian yang ditemukan di SERP</em>"
    }
  }
}
```

### Response36Afe1097B20_SerpYoutubeVideoCommentsLiveAdvancedTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoCommentsLiveAdvancedTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoCommentsLiveAdvancedResultInfo"
              }
            ]
          },
          "description": "<em>array hasil</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SpellInfo

`#/components/schemas/Response36Afe1097B20_SpellInfo`

```json
{
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "kata kunci yang diperoleh sebagai hasil koreksi otomatis mesin penelusuran\n hasil akan diberikan untuk kata kunci yang dikoreksi"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "jenis koreksi otomatis\n nilai yang mungkin:\n did_you_mean, showing_results_for, no_results_found_for, including_results_for\n catatan: Yahoo dan Yandex hanya mendukung jenis koreksi otomatis berikut:\n including_results_for"
    }
  }
}
```

### Response36Afe1097B20_YoutubeComment

`#/components/schemas/Response36Afe1097B20_YoutubeComment`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "jenis elemen"
    },
    "rank_group": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>peringkat grup di SERP</em><br>posisi dalam grup elemen dengan nilai <code>type</code> yang sama<br>posisi elemen dengan nilai <code>type</code> berbeda dihilangkan dari <code>rank_group</code>"
    },
    "rank_absolute": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em> peringkat absolut di SERP untuk domain target</em><br>posisi absolut di antara semua elemen di SERP"
    },
    "author_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>nama penulis komentar</em>"
    },
    "author_thumbnail": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL halaman tempat logo kanal penulis dihosting</em>"
    },
    "author_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL kanal penulis</em>"
    },
    "text": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>teks komentar</em>"
    },
    "publication_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>tanggal publikasi yang ditampilkan</em>"
    },
    "timestamp": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>tanggal dan waktu saat hasil diterbitkan</em><br>dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>contoh:<br><code>2022-11-15 12:57:46 +00:00</code>"
    },
    "likes_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah suka pada komentar</em>",
      "format": "int64"
    },
    "reply_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah balasan pada komentar</em>",
      "format": "int64"
    }
  }
}
```
