# YouTube Comments المتقدم المباشر

**API:** Data API

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

**Tags:** DataForSEO

يعيد تعليقات فيديو YouTube واحد على YouTube بشكل متزامن. يعيد `keyword` و`type` و`se_domain` و`location_code` و`language_code` و`check_url` و`datetime` و`spell` و`refinement_chips` و`item_types` و`items_count` و`items`. `advanced` هو الخيار الافتراضي؛ خذ `regular` عندما تكون القائمة المرتّبة هي كل المهمة، و`html` فقط للتحقق مما أسقطه المحلّل. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في `tasks[0].result`، والنتيجة في `tasks[0].status_code` — ولا يزال الطلب المرفوض يعيد HTTP 200.

### مرجع التسعير

- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.004 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة 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>معرّف الفيديو</em><br><strong>حقل مطلوب</strong><br>يمكنك العثور على معرّف الفيديو في عنوان URL أو عنصر 'youtube_video' في نتيجة YouTube Organic<br>مثال:<br><code>vQXvyV0zIP4</code>"
          },
          "location_name": {
            "type": "string",
            "description": "<em>الاسم الكامل لموقع محرك البحث</em><br><strong>حقل مطلوب إذا لم تحدد</strong> <code>location_code</code><br><strong>إذا استخدمت هذا الحقل، فلا حاجة لتحديد <code>location_code</code></strong><br>يمكنك الحصول على قائمة مواقع محرك البحث المتاحة مع <code>location_name</code> الخاص بها عبر إرسال طلب منفصل إلى <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>مثال:<br><code class=\"long-string\">United States</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>رمز موقع محرك البحث</em><br><strong>حقل مطلوب إذا لم تحدد</strong> <code>location_name</code>_<br><strong>إذا استخدمت هذا الحقل، فلا حاجة لتحديد <code>location_name</code></strong><br>يمكنك الحصول على قائمة مواقع محركات البحث المتاحة مع <code>location_code</code> الخاص بها عبر إرسال طلب منفصل إلى <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>مثال:<br><code class=\"long-string\">2840</code>n"
          },
          "language_name": {
            "type": "string",
            "description": "<em>الاسم الكامل للغة محرك البحث</em><br><strong>حقل مطلوب إذا لم تحدد</strong> <code>language_code</code><br><strong>إذا استخدمت هذا الحقل، فلا حاجة لتحديد <code>language_code</code></strong><br>يمكنك الحصول على قائمة لغات محرك البحث المتاحة مع <code>language_name</code> الخاص بها عبر إرسال طلب منفصل إلى <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><br>مثال:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>رمز لغة محرك البحث</em><br><strong>حقل مطلوب إذا لم تحدد</strong> <code>language_name</code><br><strong>إذا استخدمت هذا الحقل، فلا حاجة لتحديد <code>language_name</code></strong><br>يمكنك الحصول على قائمة لغات محرك البحث المتاحة مع <code>language_code</code> الخاص بها عبر إرسال طلب منفصل إلى <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><em><br></em>مثال:<em><br></em><code class=\"long-string\">en</code>n"
          },
          "device": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>نوع الجهاز</em><br>حقل اختياري<br>القيمة الوحيدة: <code>desktop</code>"
          },
          "os": {
            "type": [
              "string",
              "null"
            ]
          },
          "depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>عمق التحليل</em><br>حقل اختياري<br>عدد النتائج في SERP<br>القيمة الافتراضية: <code>20</code><br>الحد الأقصى: <code>200</code><br><strong>ملاحظة:</strong> ستُحتسب على حسابك رسوم عن كل SERP يحتوي على ما يصل إلى 20 نتيجة؛<br>وبالتالي، قد يؤدي تعيين عمق أعلى من <code>20</code> إلى رسوم إضافية إذا أعاد محرك البحث أكثر من 20 نتيجة؛<br>إذا كان العمق المحدد أعلى من عدد النتائج في الاستجابة، فسيُعاد الفرق تلقائيًا إلى رصيد حسابك"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>معرّف مهمة يحدده المستخدم</em><br>حقل اختياري<br><em>الحد الأقصى للأحرف هو 255</em><br>يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة<br>ستجد قيمة <code>tag</code> المحددة في كائن <code>data</code> ضمن الاستجابة"
          }
        },
        "example": [
          {
            "language_code": "en",
            "location_code": 2840,
            "video_id": "vQXvyV0zIP4"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_code": "en",
      "location_code": 2840,
      "video_id": "vQXvyV0zIP4"
    }
  ]
}
```

## Responses

### 200 — عملية ناجحة

Headers:
- `X-Request-Id` (string) — معرّف الطلب المراد تضمينه عند التواصل مع دعم Felo.

**application/json**

Schema: object | null

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

### 400 — تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

### 401 — مطلوب مفتاح API صالح من Felo.

### 402 — لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

### 403 — الحساب غير مصرّح له بهذه العملية.

### 429 — تم بلوغ حد الطلبات أو حد الإنفاق.

### 502 — تعذّر على الخدمة إكمال الطلب.

### 503 — خدمة API أو الفوترة غير متاحة مؤقتًا.

### 504 — انتهت مهلة الخدمة أثناء معالجة الطلب.

### default — استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "الإصدار الحالي من API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "رمز الحالة العام\nيمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "رسالة معلوماتية عامة\nيمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "إجمالي وقت التنفيذ، بالثواني"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "إجمالي تكلفة المهام، بالدولار الأمريكي",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد المهام في مصفوفة tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "معرّف المهمة\nمعرّف مهمة فريد في نظامنا بصيغة UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "رمز حالة المهمة\nينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000\nيمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "الرسالة المعلوماتية للمهمة\nيمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "وقت التنفيذ، بالثواني"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "إجمالي تكلفة المهام، بالدولار الأمريكي",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد العناصر في مصفوفة result",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "مسار URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "يحتوي على المعاملات نفسها التي حددتها في طلب 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>مصفوفة المهام</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SerpYoutubeVideoCommentsLiveAdvancedResultInfo

`#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoCommentsLiveAdvancedResultInfo`

```json
{
  "type": "object",
  "properties": {
    "video_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>معرّف الفيديو المستلم في مصفوفة POST</em>"
    },
    "se_domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>نطاق محرك البحث في مصفوفة POST</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>رمز الموقع في مصفوفة POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>رمز اللغة في مصفوفة POST</em>"
    },
    "check_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>عنوان URL مباشر لنتائج محرك البحث<br></em>يمكنك استخدامه للتأكد من أننا قدّمنا نتائج دقيقة"
    },
    "datetime": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>التاريخ والوقت اللذان استُلمت فيهما النتيجة</em><br>بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>مثال:<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>التصحيح التلقائي لمحرك البحث</em><br>إذا قدّم محرك البحث نتائج لكلمة مفتاحية صُحّحت، فسنحدد الكلمة المفتاحية التي صحّحها محرك البحث ونوع التصحيح التلقائي"
    },
    "item_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>أنواع نتائج البحث في SERP</em><br>تحتوي على أنواع نتائج البحث (<code>items</code>) الموجودة في SERP.<br>العنصر الممكن:<br><code>youtube_comment</code>"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>عنوان الفيديو</em>"
    },
    "comments_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>عدد التعليقات على الفيديو</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>عدد النتائج المعادة في المصفوفة <strong><code>items</code></strong></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_YoutubeComment"
          }
        ]
      },
      "description": "<em>عناصر نتائج البحث الموجودة في 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>مصفوفة نتائج</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SpellInfo

`#/components/schemas/Response36Afe1097B20_SpellInfo`

```json
{
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "الكلمة المفتاحية التي تم الحصول عليها نتيجة التصحيح التلقائي لمحرك البحث\n ستُقدَّم النتائج للكلمة المفتاحية المصححة"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "نوع التصحيح التلقائي\n القيم الممكنة:\n did_you_mean, showing_results_for, no_results_found_for, including_results_for\n ملاحظة: يدعم Yahoo وYandex نوع التصحيح التلقائي التالي فقط:\n including_results_for"
    }
  }
}
```

### Response36Afe1097B20_YoutubeComment

`#/components/schemas/Response36Afe1097B20_YoutubeComment`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "نوع العنصر"
    },
    "rank_group": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>ترتيب المجموعة في SERP</em><br>الموضع ضمن مجموعة عناصر ذات قيم <code>type</code> متطابقة<br>تُستبعد مواضع العناصر ذات قيم <code>type</code> مختلفة من <code>rank_group</code>"
    },
    "rank_absolute": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em> الرتبة المطلقة في SERP للنطاق المستهدف</em><br>الموضع المطلق بين جميع العناصر في SERP"
    },
    "author_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>اسم مؤلف التعليق</em>"
    },
    "author_thumbnail": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>عنوان URL للصفحة التي يُستضاف فيها شعار قناة المؤلف</em>"
    },
    "author_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>عنوان URL لقناة المؤلف</em>"
    },
    "text": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>نص التعليق</em>"
    },
    "publication_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>تاريخ النشر المعروض</em>"
    },
    "timestamp": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>تاريخ ووقت نشر النتيجة</em><br>بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>مثال:<br><code>2022-11-15 12:57:46 +00:00</code>"
    },
    "likes_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>عدد الإعجابات على التعليق</em>",
      "format": "int64"
    },
    "reply_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>عدد الردود على التعليق</em>",
      "format": "int64"
    }
  }
}
```
