# الحصول على نتائج مراجعات Tripadvisor حسب id

**API:** Data API

**Endpoint:** `GET /v1/beta/dataforseo/business_data/tripadvisor/reviews/task_get/{id}`

**Tags:** DataForSEO

يسترجع مراجعات Tripadvisor المصطفّة لعقار واحد حسب `id`. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في `tasks[0].result`، والنتيجة في `tasks[0].status_code` — ولا يزال الطلب المرفوض يعيد HTTP 200. ⚠️ يتغيّر الحجم مع depth المحدّد عند الإرسال، ولا يمكن تضييقه عند الجلب.

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

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

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

## Related links

- [UUID](<https://en.wikipedia.org/wiki/Universally_unique_identifier>)

## Base URL

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

## Authentication

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

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `id` | path | yes | string | <em>معرّف المهمة</em><br><strong>معرّف مهمة فريد في نظامنا بصيغة UUID</strong><br>يمكنك استخدامه خلال <strong>30 يومًا</strong> لطلب نتائج المهمة في أي وقت |

## Responses

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

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

**application/json**

Schema: object | null

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

### 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_BusinessDataTripadvisorReviewsTaskGetResponseInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskGetResponseInfo`

```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_BusinessDataTripadvisorReviewsTaskGetTaskInfo"
              }
            ]
          },
          "description": "<em>مصفوفة المهام</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskGetResultInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskGetResultInfo`

```json
{
  "type": "object",
  "properties": {
    "url_path": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>مسار URL المستلم في مصفوفة POST</em>"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "نوع العنصر"
    },
    "se_domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>نطاق محرك البحث في مصفوفة POST</em>"
    },
    "check_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>عنوان URL مباشر لنتائج محرك البحث</em><br>يمكنك استخدامه للتأكد من أننا قدّمنا نتائج دقيقة"
    },
    "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>"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>عنوان عنصر «reviews» في SERP</em><br>اسم المنشأة المحلية التي تُجمع المراجعات لها"
    },
    "location": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>موقع المنشأة المحلية</em><br>عنوان المنشأة المحلية التي تُجمع المراجعات لها"
    },
    "reviews_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>العدد الإجمالي للمراجعات</em>",
      "format": "int64"
    },
    "rating": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo"
        }
      ],
      "description": "<em>تقييم المنشأة المحلية المقابلة</em><br>معدّل الشعبية المستند إلى المراجعات والمعروض في SERP"
    },
    "rating_distribution": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "Int64"
      },
      "description": "<em>توزيع التقييم حسب الأصوات</em><br>توزيع الأصوات عبر التقييم في النطاق من 1 إلى 5"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>عدد عناصر المراجعات في مصفوفة النتائج</em><br>يمكنك الحصول على مزيد من النتائج باستخدام المعامل <code>depth</code> عند تعيين مهمة",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_TripadvisorReviewSearch"
          }
        ]
      },
      "description": "<em>المراجعات التي تم العثور عليها</em><br>يمكنك الحصول على مزيد من النتائج باستخدام المعامل <code>depth</code> عند تعيين مهمة"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "رمز اللغة في مصفوفة POST"
    }
  }
}
```

### Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskGetTaskInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskGetTaskInfo`

```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_BusinessDataTripadvisorReviewsTaskGetResultInfo"
              }
            ]
          },
          "description": "<em>مصفوفة نتائج</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BusinessDataUserProfileInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataUserProfileInfo`

```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "url": {
      "type": [
        "string",
        "null"
      ]
    },
    "image_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "location": {
      "type": [
        "string",
        "null"
      ]
    },
    "reviews_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>إجمالي عدد المراجعات التي أرسلها المراجع</em>",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_ImageUrlInfo

`#/components/schemas/Response36Afe1097B20_ImageUrlInfo`

```json
{
  "type": "object",
  "properties": {
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>عنوان URL للصورة المستخدمة في المراجعة</em>"
    }
  }
}
```

### Response36Afe1097B20_RatingInfo

`#/components/schemas/Response36Afe1097B20_RatingInfo`

```json
{
  "properties": {
    "rating_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "نوع التقييم\nهنا يمكنك العثور على العناصر التالية: Max5، Percents، CustomMax"
    },
    "value": {
      "type": [
        "number",
        "null"
      ],
      "description": "قيمة التقييم",
      "format": "double"
    },
    "votes_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "مقدار الملاحظات",
      "format": "int64"
    },
    "rating_max": {
      "type": [
        "integer",
        "null"
      ],
      "description": "الحد الأقصى لقيمة rating_type"
    }
  }
}
```

### Response36Afe1097B20_ReviewResponseItemInfo

`#/components/schemas/Response36Afe1097B20_ReviewResponseItemInfo`

```json
{
  "type": "object",
  "properties": {
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "عنوان الرد"
    },
    "text": {
      "type": [
        "string",
        "null"
      ],
      "description": "محتوى الرد"
    },
    "timestamp": {
      "type": [
        "string",
        "null"
      ],
      "description": "وقت النشر"
    }
  }
}
```

### Response36Afe1097B20_TripadvisorReviewSearch

`#/components/schemas/Response36Afe1097B20_TripadvisorReviewSearch`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "نوع العنصر"
    },
    "rank_group": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>الموضع ضمن مجموعة عناصر لها قيم <code>type</code> متطابقة</em><br>تُستبعد مواضع العناصر ذات قيم <code>type</code> المختلفة من <code>rank_group</code>"
    },
    "rank_absolute": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>الرتبة المطلقة بين جميع المراجعات المدرجة</em><br>الموضع المطلق بين جميع المراجعات في القائمة"
    },
    "position": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>محاذاة المراجعة في SERP</em><br>يمكن أن تأخذ القيم التالية: <code>right</code>"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>عنوان URL للمراجعة</em>"
    },
    "rating": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo"
        }
      ],
      "description": "<em>درجة التقييم المقدَّمة من المراجع</em>"
    },
    "date_of_visit": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>تاريخ زيارة المراجع للمنشأة المحلية</em><br>بتنسيق UTC: \"yyyy-mm-dd hh-mm-ss +00:00\"<br>مثال:<br><code>2019-11-15 12:57:46 +00:00</code>"
    },
    "timestamp": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>تاريخ ووقت نشر المراجعة</em><br>بتنسيق UTC: \"yyyy-mm-dd hh-mm-ss +00:00\"<br>مثال:<br><code>2019-11-15 12:57:46 +00:00</code>"
    },
    "review_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>معرّف المراجعة</em>"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>عنوان المراجعة</em>"
    },
    "review_text": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>محتوى المراجعة</em>"
    },
    "language": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>لغة نص المراجعة</em>"
    },
    "original_language": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>لغة نص المراجعة غير المترجم</em>"
    },
    "review_images": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_ImageUrlInfo"
          }
        ]
      },
      "description": "<em>تحتوي على عناوين URL للصور المستخدمة في المراجعة</em>"
    },
    "user_profile": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataUserProfileInfo"
        }
      ],
      "description": "<em>معلومات من الملف الشخصي للمراجع</em>"
    },
    "responses": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_ReviewResponseItemInfo"
          }
        ]
      },
      "description": "<em>تحتوي على معلومات حول رد المالك</em>"
    },
    "review_highlights": {
      "type": [
        "object",
        "null"
      ],
      "description": "<em>أبرز نقاط المراجعة</em><br>تحتوي على معايير وتقييمات المراجعة المميّزة"
    }
  }
}
```
