v0.2.0-beta

OpenAPI 3.1.0

Постановка завдань органічної видачі YouTube

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/serp/youtube/organic/task_post

Постановка завдань органічної видачі YouTube

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

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

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

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

Тіло

application/json

Тип: array (object | null)[]
- block_depth
  Тип: integer | null
  
  глибина парсингу необов'язкове поле кількість блоків результатів у SERP значення за замовчуванням: 20 максимальне значення: 700 Примітка: оплата стягується за кожен SERP, що містить до 20 блоків результатів; тому встановлення глибини блоків понад 20 може призвести до додаткових витрат, якщо пошукова система повертає більше 20 результатів; якщо вказана глибина блоків перевищує кількість результатів у відповіді, різницю буде автоматично повернено на баланс вашого облікового запису
- device
  Тип: string | null
  
  тип пристрою необов'язкове поле повертати результати для певного типу пристрою доступні значення: desktop, mobile
- keyword
  Тип: string
  
  ключове слово обов'язкове поле у полі keyword можна вказати до 700 символів усі %## буде декодовано (символ «+» декодується в пробіл) якщо в keyword потрібен символ «%», укажіть його як «%25»; якщо в keyword потрібен символ «+», укажіть його як «%2B»; докладніше про правила й обмеження полів keyword і keywords в API DataForSEO читайте в цій статті Help Center
- language_code
  Тип: string | null
  
  код мови пошукової системи обов'язкове поле, якщо не вказано language_name якщо використовуєте це поле, language_name вказувати не потрібно список доступних мов пошукової системи з їхнім language_code можна отримати окремим запитом до https://api.dataforseo.com/v3/serp/youtube/languages приклад: en
- language_name
  Тип: string | null
  
  повна назва мови пошукової системи обов'язкове поле, якщо не вказано language_code якщо використовуєте це поле, language_code вказувати не потрібно список доступних мов пошукової системи з їхньою language_name можна отримати окремим запитом до https://api.dataforseo.com/v3/serp/youtube/languages приклад: English
- location_code
  Тип: integer | null
  
  код місцезнаходження пошукової системи обов'язкове поле, якщо не вказано location_name якщо використовуєте це поле, location_name вказувати не потрібно список доступних місцезнаходжень пошукових систем з їхнім location_code можна отримати окремим запитом до https://api.dataforseo.com/v3/serp/youtube/locations приклад: 2840
- location_name
  Тип: string | null
  
  повна назва місцезнаходження пошукової системи обов'язкове поле, якщо не вказано location_code якщо використовуєте це поле, location_code вказувати не потрібно список доступних місцезнаходжень пошукової системи з їхньою location_name можна отримати окремим запитом до https://api.dataforseo.com/v3/serp/youtube/locations приклад: United States
- os
  Тип: string | null
  
  операційна система пристрою необов'язкове поле якщо в полі device указано desktop, виберіть одне з таких значень: windows, macos значення за замовчуванням: windows якщо в полі device указано mobile, виберіть одне з таких значень: android, ios значення за замовчуванням: android
- 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 буде закодовано в URL; зокрема, символ # буде закодовано як %23 докладніше — у нашому довідковому центрі
- postback_data
  Тип: string | null
  
  тип даних postback_url обов'язкове поле, якщо вказано postback_url відповідає типу даних, які буде надіслано на ваш сервер можливе значення: advanced
- 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 буде закодовано в URL; зокрема, символ # буде закодовано як %23 докладніше — у нашому довідковому центрі
- priority
  Тип: integer | null
  
  пріоритет завдання необов'язкове поле може приймати такі значення: 1 — звичайний пріоритет виконання (встановлюється за замовчуванням) 2 — високий пріоритет виконання За завдання з високим пріоритетом виконання стягується додаткова плата. Вартість можна розрахувати на сторінці Pricing.
- search_param
  Тип: string | null
  
  додаткові параметри пошукового запиту необов'язкове поле приклад: sp=EgIQAg%253D%253D
- tag
  Тип: string | null
  
  користувацький ідентифікатор завдання необов'язкове поле обмеження — 255 символів цей параметр дозволяє ідентифікувати завдання та зіставити його з результатом указане значення tag можна знайти в об'єкті data відповіді

Відповіді

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

Тип: object | null · Response36Afe1097B20_SerpYoutubeOrganicTaskPostTaskInfo
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/serp/youtube/organic/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/organic/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "audi"
  }
]'

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

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

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

Постановка завдань органічної видачі YouTube

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

DataForSEO

Постановка завдань органічної видачі YouTube

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