# الحصول على نتائج مراجعات Trustpilot في بيانات الأعمال حسب المعرّف

**API:** Data API

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

**Tags:** DataForSEO

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

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

- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 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_BusinessDataTrustpilotReviewsTaskGetResponseInfo"
    }
  ]
}
```

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

`#/components/schemas/Response36Afe1097B20_BusinessDataTrustpilotReviewsTaskGetResponseInfo`

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

### Response36Afe1097B20_BusinessDataTrustpilotReviewsTaskGetResultInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataTrustpilotReviewsTaskGetResultInfo`

```json
{
  "type": "object",
  "properties": {
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>نطاق الكيان التجاري</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» على Trustpilot</em><br>اسم الكيان التجاري الذي تُجمع المراجعات له"
    },
    "location": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>موقع الكيان التجاري كما هو محدد على Trustpilot</em><br>عنوان الكيان التجاري الذي تُجمع المراجعات له"
    },
    "reviews_count": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>العدد الإجمالي للمراجعات</em>",
      "format": "int64"
    },
    "rating": {
      "type": [
        "object",
        "null"
      ],
      "description": "<em>تقييم الكيان التجاري المقابل</em><br>معدّل الشعبية المستند إلى المراجعات والمعروض في SERP"
    },
    "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_TrustpilotReviewSearch"
          }
        ]
      },
      "description": "<em>المراجعات التي تم العثور عليها</em><br>يمكنك الحصول على مزيد من النتائج باستخدام المعامل <code>depth</code> عند تعيين مهمة"
    }
  }
}
```

### Response36Afe1097B20_BusinessDataTrustpilotReviewsTaskGetTaskInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataTrustpilotReviewsTaskGetTaskInfo`

```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_BusinessDataTrustpilotReviewsTaskGetResultInfo"
              }
            ]
          },
          "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_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_TrustpilotReviewSearch

`#/components/schemas/Response36Afe1097B20_TrustpilotReviewSearch`

```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>"
    },
    "verified": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "<em>يشير إلى ما إذا كانت المراجعة تحمل علامة \"موثّق\"</em>"
    },
    "language": {
      "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>2019-11-15 12:57:46 +00:00</code>"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>عنوان المراجعة</em>"
    },
    "review_text": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>محتوى المراجعة</em>"
    },
    "review_images": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "<em>الصور التي أرسلها المراجع</em><br>تعرض عناوين URL للصور التي قدّمها مؤلف المراجعة؛<br><strong>يرجى ملاحظة</strong> أن Trustpilot لا يسمح بإضافة صور إلى المراجعات، لذا ستكون المعلمة <code>review_images</code> دائمًا مساوية لـ<code>null</code>"
    },
    "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>"
    }
  }
}
```
