v0.2.0-beta

OpenAPI 3.1.0

Отримання результатів відгуків Tripadvisor за id

Felo API Support

MIT

Сервер

https://openapi.felo.ai

Клієнтські бібліотеки

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Операції

get/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_get/{id}

Отримання результатів відгуків Tripadvisor за id

За id отримує з черги відгуки Tripadvisor для одного об'єкта. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. ⚠️ Розмір залежить від глибини, заданої під час надсилання, і тут його не можна зменшити.

Довідкові ціни

Тарифікація: вартість відповіді за даними постачальника.
Довідкова оцінка запиту: USD 0.012.
Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Параметри шляху

id
Тип: string
обов'язкове

ідентифікатор завдання
унікальний ідентифікатор завдання в нашій системі у форматі UUID
протягом 30 днів ви зможете будь-коли запросити за ним результати завдання

Відповіді

200
Тип: object | null · Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskGetResponseInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

status_code
Тип: integer | null

загальний код стану. Повний список кодів відповіді можна знайти тут.

status_message
Тип: string | null

загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.

tasks
Тип: array (object | null)[] | null

масив завдань

Тип: object | null · Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskGetTaskInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

data
Тип: object | null

містить ті самі параметри, які ви вказали в POST-запиті

propertyName
Тип: object | null
id
Тип: string | null

ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID

path
Тип: array (string | null)[] | null

шлях URL

result
Тип: array (object | null)[] | null

масив результатів

check_url
Тип: string | null

прямий URL до результатів пошукової системи
за його допомогою можна переконатися, що ми надали точні результати

datetime
Тип: string | null

дата й час отримання результату
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-11-15 12:57:46 +00:00

items
Тип: array (object | null)[] | null

знайдені відгуки
більше результатів можна отримати за допомогою параметра depth під час постановки завдання

date_of_visit
Тип: string | null

дата відвідування закладу рецензентом
у форматі UTC: "yyyy-mm-dd hh-mm-ss +00:00"
приклад:
2019-11-15 12:57:46 +00:00

language
Тип: string | null

мова тексту відгуку

original_language
Тип: string | null

мова неперекладеного тексту відгуку

position
Тип: string | null

вирівнювання відгуку в SERP
може набувати таких значень: right

rank_absolute
Тип: integer | null

абсолютний рейтинг серед усіх відгуків у списку
абсолютна позиція серед усіх відгуків у списку

rank_group
Тип: integer | null

позиція в групі елементів з однаковими значеннями type
позиції елементів з іншими значеннями type виключаються з rank_group

rating
Тип: object | null · Response36Afe1097B20_RatingInfo

рейтинг, наданий рецензентом

rating_max
Тип: integer | null

максимальне значення для rating_type

rating_type
Тип: string | null

тип рейтингу тут можна знайти такі елементи: Max5, Percents, CustomMax

value
Тип: number | null Формат: double

значення рейтингу

votes_count
Тип: integer | null Формат: int64

кількість відгуків

responses
Тип: array (object | null)[] | null

містить інформацію про відповідь власника

text
Тип: string | null

вміст відповіді

timestamp
Тип: string | null

час публікації

title
Тип: string | null

заголовок відповіді

review_highlights
Тип: object | null

ключові моменти відгуку
містить виділені критерії та оцінки відгуку

review_id
Тип: string | null

ID відгуку

review_images
Тип: array (object | null)[] | null

містить URL зображень, використаних у відгуку

url
Тип: string | null

URL зображення, використаного у відгуку

review_text
Тип: string | null

вміст відгуку

timestamp
Тип: string | null

дата й час публікації відгуку
у форматі UTC: "yyyy-mm-dd hh-mm-ss +00:00"
приклад:
2019-11-15 12:57:46 +00:00

title
Тип: string | null

заголовок відгуку

type
Тип: string | null

тип елемента

url
Тип: string | null

URL відгуку

user_profile
Тип: object | null · Response36Afe1097B20_BusinessDataUserProfileInfo

інформація з профілю рецензента

image_url
Тип: string | null
location
Тип: string | null
name
Тип: string | null
reviews_count
Тип: integer | null Формат: int64

загальна кількість відгуків, надісланих автором відгуку

url
Тип: string | null
items_count
Тип: integer | null Формат: int64

кількість елементів відгуків у масиві результатів
більше результатів можна отримати за допомогою параметра depth під час постановки завдання

language_code
Тип: string | null

код мови в масиві POST

location
Тип: string | null

місцезнаходження місцевого закладу
адреса місцевого закладу, для якого збираються відгуки

rating
Тип: object | null · Response36Afe1097B20_RatingInfo

рейтинг відповідного місцевого закладу
показник популярності на основі відгуків, що відображається в SERP

rating_max
Тип: integer | null

максимальне значення для rating_type

rating_type
Тип: string | null

тип рейтингу тут можна знайти такі елементи: Max5, Percents, CustomMax

value
Тип: number | null Формат: double

значення рейтингу

votes_count
Тип: integer | null Формат: int64

кількість відгуків

rating_distribution
Тип: object | null

розподіл оцінок за голосами
розподіл голосів за рейтингом у діапазоні від 1 до 5

propertyName
Тип: integer | null Формат: Int64
reviews_count
Тип: integer | null Формат: int64

загальна кількість відгуків

se_domain
Тип: string | null

домен пошукової системи в масиві POST

title
Тип: string | null

заголовок елемента 'reviews' у SERP
назва місцевого закладу, для якого збираються відгуки

type
Тип: string | null

тип елемента

url_path
Тип: string | null

шлях URL, отриманий у масиві POST

result_count
Тип: integer | null Формат: int64

кількість елементів у масиві result

status_code
Тип: integer | null

код стану завдання формується DataForSEO, може перебувати в діапазоні 10000-60000 Повний список кодів відповіді можна знайти тут.

status_message
Тип: string | null

інформаційне повідомлення завдання Повний список загальних інформаційних повідомлень можна знайти тут.

time
Тип: string | null

час виконання, секунди

tasks_count
Тип: integer | null Формат: int64

кількість завдань у масиві tasks

tasks_error
Тип: integer | null Формат: int64

кількість завдань у масиві tasks, повернутих з помилкою

time
Тип: string | null

загальний час виконання, секунди

version
Тип: string | null

поточна версія API
application/json
400

Не вдалося обробити запит. Перевірте параметри запиту.
401

Потрібен дійсний API-ключ Felo.
402

Запит неможливо виконати: умови білінгу не виконано.
403

Обліковий запис не має дозволу на цю операцію.
429

Досягнуто ліміту запитів або витрат.
502

Служба не змогла виконати запит.
503

API або служба білінгу тимчасово недоступні.
504

Час очікування обробки запиту вичерпано.
default

Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

application/json

get/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Показати схему

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "url_path": null,
          "type": null,
          "se_domain": null,
          "check_url": null,
          "datetime": null,
          "title": null,
          "location": null,
          "reviews_count": null,
          "rating": {
            "rating_type": null,
            "value": null,
            "votes_count": null,
            "rating_max": null
          },
          "rating_distribution": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "url": null,
              "rating": "[Max Depth Exceeded]",
              "date_of_visit": null,
              "timestamp": null,
              "review_id": null,
              "title": null,
              "review_text": null,
              "language": null,
              "original_language": null,
              "review_images": [
                "[Max Depth Exceeded]"
              ],
              "user_profile": "[Max Depth Exceeded]",
              "responses": [
                "[Max Depth Exceeded]"
              ],
              "review_highlights": null
            }
          ],
          "language_code": null
        }
      ]
    }
  ]
}

Успішна операція

Отримання результатів відгуків Tripadvisor за id

АвтентифікаціяRequired

DataForSEO

Отримання результатів відгуків Tripadvisor за id

Довідкові ціни