v0.2.0-beta

OpenAPI 3.1.0

Створення завдань Google Extended Reviews

Felo API Support

MIT

Сервер

https://openapi.felo.ai

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

Shell Curl

DataForSEO

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

DataForSEO Операції

post/v1/beta/dataforseo/business_data/google/extended_reviews/task_post

Створення завдань Google Extended Reviews

Ставить у чергу повну історію відгуків Google для бізнесу — за межами першої сторінки, яку повертає стандартний ендпоінт, — і повертає id завдання. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. Отримуйте через get_dataforseo_business_google_extended_reviews_fetch; коротша версія — post_dataforseo_business_google_reviews_submit.

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

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

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

Тіло

application/json

Тип: array (object | null)[]
- cid
  Тип: string
  
  унікальний ідентифікатор бізнес-сутності, визначений Google
  обов'язкове поле, якщо не вказано keyword або place_id
  приклад:
  194604053573767737
  Докладніше про ідентифікатор — у цій статті Help Center
  
  Примітка: якщо використовувати це поле, за завдання, пов'язані з Google Reviews API, з облікового запису буде списано подвійний стандартний тариф
- depth
  Тип: integer | null
  
  глибина парсингу
  необов'язкове поле
  кількість відгуків у SERP
  наполегливо радимо задавати глибину парсингу кратною двадцяти, оскільки наші системи обробляють двадцять відгуків поспіль
  значення за замовчуванням: 20
  максимальне значення: 1000
  
  З облікового запису стягується плата за кожен SERP, що містить до 20 результатів;
  Встановлення глибини понад 20 може призвести до додаткових списань, якщо пошукова система поверне більше 20 результатів;
  Вартість можна розрахувати на сторінці Pricing.
- keyword
  Тип: string
  
  ключове слово
  обов'язкове поле, якщо не вказано cid або place_id
  вказане ключове слово має позначати назву місцевого закладу;
  у полі keyword можна вказати до 700 символів;
  усі %## буде декодовано (символ ‘+’ буде декодовано в пробіл)
  якщо в keyword потрібно використати символ “%”, вкажіть його як “%25”;
  
  якщо це поле містить такі параметри, як ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘related:’, ‘site:’, вартість завдання множиться на 5
  Примітка: запити з параметром ‘cache:’ не підтримуються і повертають помилку валідації
  
  Докладніше про правила й обмеження полів keyword і keywords в API DataForSEO — у цій статті Help Center
  
  Примітка: якщо використовувати це поле, за завдання, пов'язані з Google Reviews API, з облікового запису буде списано потрійний стандартний тариф
- language_code
  Тип: string
  
  код мови пошукової системи
  обов'язкове поле, якщо не вказано language_name
  якщо використовується це поле, language_name вказувати не потрібно
  список доступних мов з їхніми language_code можна отримати окремим запитом до https://api.dataforseo.com/v3/business_data/google/languages
  приклад:
  en
- language_name
  Тип: string
  
  повна назва мови пошукової системи
  обов'язкове поле, якщо не вказано language_code
  якщо використовується це поле, language_code вказувати не потрібно
  список доступних мов із language_name можна отримати окремим запитом до https://api.dataforseo.com/v3/business_data/google/languages
  приклад:
  English
- location_code
  Тип: integer
  
  код місцеположення пошукової системи
  обов'язкове поле, якщо не вказано location_name або location_coordinate
  якщо використовується це поле, location_name або location_coordinate вказувати не потрібно
  список доступних місцеположень із location_code можна отримати окремим запитом до https://api.dataforseo.com/v3/business_data/google/locations
  приклад:
  2840
- location_coordinate
  Тип: string
  
  GPS-координати місцеположення
  обов'язкове поле, якщо не вказано location_name або location_code
  якщо використовується це поле, location_name або location_code вказувати не потрібно
  параметр location_coordinate вказується у форматі "широта,довгота,радіус"
  максимальна кількість десяткових знаків для "широти" і "довготи": 7
  мінімальне значення для "радіуса": 199.9
  приклад:
  53.476225,-2.243572,200
- location_name
  Тип: string
  
  повна назва місцезнаходження пошукової системи
  обов'язкове поле, якщо не вказано location_code або location_coordinate
  якщо використовуєте це поле, location_code або location_coordinate вказувати не потрібно
  список доступних місцезнаходжень з їхнім location_name можна отримати окремим запитом доhttps://api.dataforseo.com/v3/business_data/google/locations
  приклад:
  London,England,United Kingdom
- pingback_url
  Тип: string | null
  
  URL сповіщення про завершення завдання
  необов'язкове поле
  коли завдання буде виконано, ми надішлемо GET-запит на вказаний вами URL
  рядок «$id» можна використовувати як змінну $id, а «$tag» — як urlencoded-змінну $tag. Перед надсиланням запиту ми підставимо потрібні значення.
  приклад:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Примітка: спеціальні символи в pingback_url буде urlencoded;
  зокрема, символ # кодується як %23
  
  Докладніше див. в Help Center
- place_id
  Тип: string
  
  ідентифікатор бізнес-сутності в Google Maps
  обов'язкове поле, якщо не вказано keyword або cid
  приклад:
  GhIJQWDl0CIeQUARxks3icF8U8A
  Докладніше про ідентифікатор — у цій статті Help Center
  
  Примітка: якщо використовувати це поле, за завдання, пов'язані з Google Reviews API, з облікового запису буде списано подвійний стандартний тариф
- postback_url
  Тип: string | null
  
  URL для надсилання результатів завдання
  необов'язкове поле
  коли завдання буде виконано, ми надішлемо POST-запит з результатами, стиснутими у форматі gzip, на вказаний вами postback_url
  рядок «$id» можна використовувати як змінну $id, а «$tag» — як urlencoded-змінну $tag. Перед надсиланням запиту ми підставимо потрібні значення.
  приклад:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Примітка: спеціальні символи в postback_url буде urlencoded;
  зокрема, символ # кодується як %23
  
  Докладніше див. в Help Center
- priority
  Тип: integer | null
  
  пріоритет завдання
  необов'язкове поле
  може приймати такі значення:
  1 — звичайний пріоритет виконання (встановлюється за замовчуванням)
  2 — високий пріоритет виконання. За завдання з високим пріоритетом стягується додаткова плата.
  Вартість можна розрахувати на сторінці тарифів.
- tag
  Тип: string | null
  
  визначений користувачем ідентифікатор завдання
  необов'язкове поле
  обмеження — 255 символів
  цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
  вказане значення tag ви знайдете в об'єкті data відповіді

Відповіді

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

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

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

data
Тип: object | null

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

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

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

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

шлях URL

result
Тип: object | null

масив результатів
у цьому випадку значення буде null

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

post/v1/beta/dataforseo/business_data/google/extended_reviews/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/extended_reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "London,England,United Kingdom",
    "language_name": "english",
    "cid": "17626775537598922320"
  }
]'

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

{
  "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": null
    }
  ]
}

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

Створення завдань Google Extended Reviews

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

DataForSEO

Створення завдань Google Extended Reviews

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