v0.2.0-beta

OpenAPI 3.1.0

Настройка live-задач «Демография DataForSEO Trends»

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/keywords_data/dataforseo_trends/demography/live

Настройка live-задач «Демография DataForSEO Trends»

Аудитория Google Trends за ключевым словом: разбивка по возрасту и полу за то же окно, что использует post_dataforseo_keywords_trends_explore_live, с теми же аргументами type и даты. Ответ обёрнут в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200. Дёшево, как и его собрат. Для «где», а не «кто», используйте post_dataforseo_keywords_trends_subregion_interests_live.

Справочная информация о ценах

Тарификация: заявленная стоимость ответа.
Справочная оценка запроса: USD 0.0024.
Справочный множитель для клиента: 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
  избегайте символов и специальных знаков (например, UTF-символов, эмодзи);
  если указать нелатинские символы, вы получите данные для стран, где они используются
  
  Подробнее о правилах и ограничениях полей 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_KeywordsDataDataforseoTrendsDemographyLiveResponseInfo
cost
Тип: number | null Формат: double

общая стоимость задач, USD

status_code
Тип: integer | null

общий код состояния. Полный список кодов ответа можно найти здесь.

status_message
Тип: string | null

общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.

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

массив задач

Тип: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsDemographyLiveTaskInfo
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_DataforseoTrendsDemographyElementItem
Тип: object · Response36Afe1097B20_DataforseoTrendsDemographyElementItem
type
Дискриминатор
Тип: string | null

тип элемента

demography
Тип: object | null · Response36Afe1097B20_Demography

демографическая разбивка данных о популярности ключевых слов по каждому указанному термину
содержит данные о популярности ключевых слов по возрасту и полу

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

распределение популярности ключевых слов по возрасту

keyword
Тип: string | null

соответствующее ключевое слово, для которого предоставлены демографические данные

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

содержит возрастной диапазон и соответствующие значения популярности ключевого слова

type
Тип: string | null

тип элемента

value
Тип: integer | null

показатель популярности ключевого слова в указанном возрастном диапазоне
с помощью этого value можно понять, насколько ключевое слово популярно в каждом возрастном диапазоне;
расчёт: мы определяем наибольшее значение популярности соответствующего ключевого слова по всем возрастным группам, а затем выражаем все остальные значения как процент от этого наибольшего значения (100);
значение 100 — наибольшая популярность термина
значение 0 означает, что данных по этому термину недостаточно

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

распределение популярности ключевых слов по полу

keyword
Тип: string | null

соответствующее ключевое слово, для которого предоставлены демографические данные

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

содержит возрастной диапазон и соответствующие значения популярности ключевого слова

type
Тип: string | null

тип элемента

value
Тип: integer | null

показатель популярности ключевого слова в указанном возрастном диапазоне
с помощью этого value можно понять, насколько ключевое слово популярно в каждом возрастном диапазоне;
расчёт: мы определяем наибольшее значение популярности соответствующего ключевого слова по всем возрастным группам, а затем выражаем все остальные значения как процент от этого наибольшего значения (100);
значение 100 — наибольшая популярность термина
значение 0 означает, что данных по этому термину недостаточно

demography_comparison
Тип: object | null · Response36Afe1097B20_DemographyComparisonInfo

сравнение демографических данных о популярности ключевых слов для указанных параметров
содержит данные о популярности ключевых слов по возрасту и полу
если вы указали одно ключевое слово, значение будет null

age
Тип: object | null

тип элемента

propertyName
Тип: array (integer | null)[] | null
gender
Тип: object | null

тип элемента

propertyName
Тип: array (integer | null)[] | null
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

post/v1/beta/dataforseo/keywords_data/dataforseo_trends/demography/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/demography/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "rugby",
      "cricket"
    ],
    "date_from": "2023-01-01",
    "date_to": "2024-01-01",
    "type": "web",
    "location_name": "United States"
  }
]'

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

{
  "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]",
              "demography": "[Max Depth Exceeded]",
              "demography_comparison": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

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

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

По вопросам API, оплаты и аккаунта пишите в поддержку.
Общайтесь с разработчиками Felo в Discord.
Загляните в наш журнал изменений.
Нужны цены за объём или помощь с закупкой? Связаться с отделом продаж.
Создаёте на LLM? Прочитайте llms.txt.

Настройка live-задач «Демография DataForSEO Trends»

АутентификацияRequired

DataForSEO

Настройка live-задач «Демография DataForSEO Trends»

Справочная информация о ценах

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