Felo API PlatformFelo API Platform
Усі endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Створення live-завдань «DataForSEO Trends Explore»

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клієнтські бібліотеки
Shell Curl

DataForSEO

​

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

DataForSEO Операції

Створення live-завдань «DataForSEO Trends Explore»

​

Інтерес з часом для щонайбільше п'яти keywords — крива Google Trends. Повертає keywords, type, location_code, language_code, datetime, items_count і items. type вибирає web, news, images, youtube або shopping, а date_from/date_to задають вікно. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. Trends дає відносний інтерес, а не абсолютний обсяг; для підрахунків використовуйте post_dataforseo_keywords_gads_search_volume_live.

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

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

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

Тіло
application/json
  • Тип: array (object | null)[]
    • date_from
      Тип: string | null

      початкова дата діапазону часу
      необов'язкове поле
      якщо не вказати це поле, за замовчуванням буде використано поточний день і місяць попереднього року
      мінімальне значення для типу web: 2004-01-01
      мінімальне значення для інших типів: 2008-01-01
      формат дати: "yyyy-mm-dd"
      приклад:
      "2019-01-15"

    • date_to
      Тип: string | null

      кінцева дата діапазону часу
      необов'язкове поле
      якщо не вказати це поле, за замовчуванням буде використано сьогоднішню дату
      формат дати: "yyyy-mm-dd"
      приклад:
      "2019-01-15"

    • keywords
      Тип: array string[]

      ключові слова
      обов'язкове поле
      максимальна кількість ключових слів: 5

      Докладніше про правила й обмеження полів keyword і keywords в API DataForSEO читайте в статті Help Center

    • location_code
      Тип: integer | null

      код місцеположення пошукової системи
      необов'язкове поле
      якщо не використовувати це поле, ви отримаєте глобальні результати
      якщо використовуєте це поле, location_name вказувати не потрібно
      список доступних місцеположень пошукових систем з їхніми location_code можна отримати окремим запитом до https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      дані буде надано для країни, до якої належить указаний location_code;
      приклад:
      2840

    • location_name
      Тип: string | null

      повна назва місцезнаходження пошукової системи
      необов'язкове поле
      якщо не використовувати це поле, ви отримаєте глобальні результати
      якщо використовуєте це поле, location_code вказувати не потрібно
      список доступних місцезнаходжень пошукової системи з їхнім location_name можна отримати окремим запитом до https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      дані буде надано для країни, до якої належить указаний location_name;
      приклад:
      United Kingdom

    • tag
      Тип: string | null

      визначений користувачем ідентифікатор завдання
      необов'язкове поле
      обмеження — 255 символів
      цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
      вказане значення tag ви знайдете в об'єкті data відповіді

    • time_range
      Тип: string | null

      попередньо задані часові діапазони
      необов'язкове поле
      якщо вказати параметри date_from або date_to, це поле буде проігноровано під час постановки завдання
      можливі значення для всіх параметрів type:
      past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years

    • type
      Тип: string | null

      тип елемента

Відповіді
  • 200
    Тип: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsExploreLiveResponseInfo
    • cost
      Тип: number | null Формат: double

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

    • status_code
      Тип: integer | null

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

    • status_message
      Тип: string | null

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

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

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

      • Тип: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsExploreLiveTaskInfo
        • 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

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

          • 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

            містить популярність ключового слова та пов'язані дані

            • Тип: object | null · Response36Afe1097B20_DataforseoTrendsDataforseoTrendsGraphElementItem
                • Тип: object · Response36Afe1097B20_DataforseoTrendsDataforseoTrendsGraphElementItem
                  • type
                    Дискримінатор
                    Тип: string | null

                    тип елемента

                  • averages
                    Тип: array (integer | null)[] | null
                  • data
                    Тип: array (object | null)[] | null

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

                    • date_from
                      Тип: string | null

                      дата початку відповідного часового діапазону
                      у форматі UTC: "yyyy-mm-dd"

                    • date_to
                      Тип: string | null

                      дата завершення відповідного часового діапазону
                      у форматі UTC: "yyyy-mm-dd"

                    • timestamp
                      Тип: integer | null

                      момент часу у форматі Unix time

                    • values
                      Тип: array (integer | null)[] | null

                      відносний показник популярності ключового слова на конкретну позначку часу
                      становить показник популярності ключового слова за заданий часовий діапазон
                      якщо вказано більше одного ключового слова, значення усереднюються до найбільшого значення за всіма вказаними ключовими словами
                      значення 100 — пік популярності терміна. Значення 50 означає, що термін удвічі менш популярний. Оцінка 0 означає, що даних за цим терміном недостатньо

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

                    ключові слова в масиві POST

                  • position
                    Тип: integer | null

                    вирівнювання елемента
                    може набувати таких значень: 1, 2, 3, 4 тощо.

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

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

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

            ключові слова в масиві POST

          • language_code
            Тип: string | null

            код мови в масиві POST
            якщо даних немає, значення — null

          • location_code
            Тип: integer | null

            код локації в масиві POST
            якщо даних немає, значення — null

          • type
            Тип: string | 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
Request Example for post/v1/beta/dataforseo/keywords_data/dataforseo_trends/explore/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/explore/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "iphone 14",
      "samsung s23"
    ],
    "location_code": 2840
  }
]'

{
  "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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "data": "[Max Depth Exceeded]",
              "averages": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

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

Setting Live ‘DataForSEO Trends Explore’ Tasks