# รับผลรีวิว Tripadvisor (Business Data) ตาม 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 ที่ตั้งไว้ตอนส่งงาน และไม่สามารถจำกัดให้แคบลงได้ที่นี่

### ข้อมูลอ้างอิงราคา

- การวัดปริมาณ: ต้นทุนการตอบกลับที่รายงาน
- ประมาณการคำขออ้างอิง: USD 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": "ค่าใช้จ่ายรวมของงาน, USD",
      "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": "ค่าใช้จ่ายรวมของงาน, USD",
      "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>คุณใช้ URL นี้เพื่อตรวจสอบว่าเราให้ผลลัพธ์ที่แม่นยำ"
    },
    "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>ID ของรีวิว</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>มีเกณฑ์การรีวิวและคะแนนประเมินที่ถูกไฮไลต์"
    }
  }
}
```
