Felo API PlatformFelo API Platform
Все эндпоинты 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

    Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

    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

Нужна помощь?