v0.2.0-beta

OpenAPI 3.1.0

Налаштування завдань Google App List

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/app_data/google/app_list/task_post

Налаштування завдань Google App List

Ставить у чергу одну з власних кураторських добірок Google Play — безкоштовні, найприбутковіші, популярні — вибрану через app_collection, і повертає id завдання. depth обмежує глибину читання чарту. Асинхронно: під час надсилання повертається id завдання в tasks[0].id, а інструмент отримання повертає результат, коли він готовий. Отримайте результат за допомогою get_dataforseo_app_google_app_list_fetch. Це подання чарту; для пошуку за ключовим словом використовуйте post_dataforseo_app_google_app_searches_submit.

Довідкова інформація про ціну

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

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

Тіло

application/json

Тип: array (object | null)[]
- age_rating
  Тип: string | null
  
  фільтрація результатів за віковим рейтингом
  необов'язкове поле
  це поле дозволяє фільтрувати результати за віковим рейтингом;
  можливі типи фільтрації:
  ages_up_to_5 — повертати застосунки, схвалені для дітей до 5 років;
  ages_6_8 — повертати застосунки, схвалені для дітей від 6 до 8 років;
  ages_9_12 — повертати застосунки, схвалені для дітей від 9 до 12 років;
  за замовчуванням API повертає застосунки для всіх вікових груп;
  Примітка: цей фільтр працює лише разом із параметром "category": "family"
- app_category
  Тип: string | null
  
  категорія застосунку в Google Play
  необов'язкове поле
  можна фільтрувати результати за категорією застосунку;
  приклад:
  family;
  повний список доступних категорій можна отримати, зробивши окремий запит до https://api.dataforseo.com/v3/app_data/google/categories
  Примітка: app_category не можна використовувати, якщо параметр app_collection має значення featured
- app_collection
  Тип: string
  
  колекція застосунків
  обов'язкове поле
  колекція застосунків у Google Play, з якої збиратимуться застосунки;
  можна вказати такі значення:
  featured, topselling_paid, topselling_free, topselling_new_free, topselling_new_paid, topgrossing, movers_shakers
  Примітка: якщо вибрано featured, параметр app_category використовувати не можна
- depth
  Тип: integer | null
  
  глибина парсингу
  необов'язкове поле
  кількість застосунків, що повертаються у відповіді API;
  ми наполегливо рекомендуємо задавати глибину парсингу кратною 100, оскільки наша система обробляє по 100 результатів підряд;
  значення за замовчуванням: 100;
  максимальне значення: 200;
  З кожного SERP, що містить до 100 результатів, з вашого облікового запису стягується плата;
  Установлення глибини понад 100 може призвести до додаткових витрат, якщо пошукова система поверне більше 100 результатів;
  Вартість можна розрахувати на сторінці Pricing.
- language_code
  Тип: string
  
  код мови пошукової системи
  обов'язкове поле, якщо language_name не вказано
  якщо ви використовуєте це поле, вказувати language_name не потрібно
  список доступних мов з їхніми language_code можна отримати, зробивши окремий запит до https://api.dataforseo.com/v3/app_data/google/languages
  приклад:
  en
- language_name
  Тип: string
  
  повна назва мови пошукової системи
  обов'язкове поле, якщо language_code не вказано
  якщо ви використовуєте це поле, вказувати language_code не потрібно
  список доступних мов з їхніми language_name можна отримати, зробивши окремий запит до https://api.dataforseo.com/v3/app_data/google/languages
  приклад:
  English
- location_code
  Тип: integer
  
  код локації пошукової системи
  обов'язкове поле, якщо не вказано location_name
  якщо ви використовуєте це поле, вказувати location_name не потрібно
  список доступних локацій пошукової системи з їхніми location_code можна отримати, зробивши окремий запит до https://api.dataforseo.com/v3/app_data/google/locations
  приклад:
  9061121
- location_name
  Тип: string
  
  повна назва локації пошукової системи
  обов'язкове поле, якщо не вказано location_code
  якщо ви використовуєте це поле, вказувати location_code не потрібно
  список доступних локацій пошукової системи з їхніми location_name можна отримати, зробивши окремий запит до https://api.dataforseo.com/v3/app_data/google/locations
  приклад:
  West Los Angeles,California,United States
- pingback_url
  Тип: string | null
  
  URL сповіщення про завершення завдання
  необов'язкове поле
  коли завдання буде завершено, ми повідомимо вас GET-запитом на вказаний вами URL
  рядок ‘$id’ можна використовувати як змінну $id, а ‘$tag’ — як URL-кодовану змінну $tag. Перед надсиланням запиту ми підставимо потрібні значення.
  приклад:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Примітка: спеціальні символи в pingback_url буде URL-кодовано;
  зокрема, символ # буде закодовано як %23
- postback_data
  Тип: string
  
  тип даних postback_url
  обов'язкове поле, якщо вказано postback_url
  відповідає типу даних, які буде надіслано на ваш сервер
  можливі значення:
  advanced, html
- postback_url
  Тип: string | null
  
  URL для надсилання результатів завдання
  необов'язкове поле
  після завершення завдання ми надішлемо POST-запит з його результатами, стиснутими у форматі gzip, на вказаний вами postback_url
  рядок ‘$id’ можна використовувати як змінну $id, а ‘$tag’ — як URL-кодовану змінну $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.
- tag
  Тип: string | null
  
  визначений користувачем ідентифікатор завдання
  необов'язкове поле
  обмеження — 255 символів
  цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
  вказане значення tag ви знайдете в об'єкті data відповіді

Відповіді

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

Тип: object | null · Response36Afe1097B20_AppDataGoogleAppListTaskPostTaskInfo
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/app_data/google/app_list/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/google/app_list/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_collection": "topselling_free",
    "location_code": 2840,
    "language_code": "en",
    "depth": 100
  }
]'

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

{
  "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 App List

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

DataForSEO

Налаштування завдань Google App List

Довідкова інформація про ціну