DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live-поиск упоминаний LLM
Отдельные ответы, в которых ассистент упомянул вашу цель. Возвращает total_count, current_offset, search_after_token и items — после первых страниц постраничная навигация выполняется по токену, а не по offset. ⚠️ target — это массив объектов, каждый {"domain": "..."} или {"keyword": "..."}; строка сама по себе отклоняется как неверный тип, а массив строк — с сообщением 'Each target item must be an object'. Поля фильтра берутся из get_dataforseo_ai_llm_mentions_available_filters. Упаковано в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200. Если нужны счётчики, а не сами упоминания, используйте post_dataforseo_ai_llm_mentions_aggregated_metrics_live.
Справочная информация о цене
- Тарификация: по заявленной стоимости ответа.
- Ориентировочная стоимость запроса: 0.701 USD.
- Справочный коэффициент клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
Только справочные метаданные, а не предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Окончательные списания определяются записями биллинга Felo.
- Тип: array object[]
- targetТип: array object[]обязательно
массив объектов с целевыми сущностями. Обязательное поле. В поле target можно указать до 10 сущностей (объектов). Одна целевая сущность может содержать либо один домен, либо одно ключевое слово и связанные параметры. Примеры: массив target с сущностью-доменом [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] / массив target с сущностью-ключевым словом [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] / массив target с несколькими сущностями [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]
- domainТип: stringобязательно
целевой домен. Обязательное поле, если не указано keyword. В поле domain можно указать до 63 символов; домен указывается без https:// и www.
- includeТип: boolean
_subdomains указывает, будут ли поддомены целевого домена включены в поиск. Необязательное поле. Если задано true, поддомены включаются в поиск. Значение по умолчанию: false.
- keywordТип: string
целевое ключевое слово. Обязательное поле, если не указан domain. В поле keyword можно указать до 250 символов. Все %## будут декодированы (символ «+» декодируется в пробел). Если в keyword нужен символ «%», укажите его как «%25»; если нужен символ «+», укажите его как «%2B». Подробнее о правилах и ограничениях полей keyword и keywords в API DataForSEO читайте в этой статье Help Center.
- matchТип: string
_type Тип соответствия целевого ключевого слова определяет, как сопоставляется указанное ключевое слово. Необязательное поле возможные значения: word_match — полнотекстовый поиск по фразам, соответствующим указанному исходному ключевому слову с дополнительными словами до, после или внутри ключевой фразы (например, по запросу "light" будут найдены "light bulb", "light switch"); partial_match — поиск подстроки, который находит все вхождения указанной последовательности символов, даже если она встречается внутри более длинного слова (например, по запросу "light" будут найдены "lighting", "highlight"); значение по умолчанию: word_match
- searchТип: string
_filter фильтр поиска сущностей: include или exclude; по умолчанию include.
- searchТип: array string[]
_scope область поиска. Для сущностей-доменов: any, sources, search_results. Для сущностей-ключевых слов: any, question, answer, brand_entities, fan_out_queries. Значение по умолчанию: any.
- filtersТип: array
массив параметров фильтрации результатов необязательное поле можно добавить несколько фильтров одновременно (не более 8) между условиями нужно указать логический оператор and или or поддерживаются следующие операторы: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match оператор % можно использовать с like и not_like для сопоставления любой строки из нуля или более символов пример: ["ai_search_volume",">","1000"] Полный список возможных фильтров доступен здесь.
- languageТип: string
_code код языка поиска. Необязательное поле. Если используете это поле, указывать language_name не нужно. Список доступных языков поисковой системы с их language_code можно получить отдельным запросом к https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Значение по умолчанию: en. Примечание: данные chat_gpt доступны только для en.
- languageТип: string
_name полное название языка поиска. Необязательное поле. Если используете это поле, указывать language_code не нужно; если поле не указано, по умолчанию используется language_code со значением en. Список доступных языков поисковой системы с их language_name можно получить отдельным запросом к https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Примечание: данные chat_gpt доступны только на английском языке.
- limitТип: integer
максимальное количество возвращаемых объектов необязательное поле значение по умолчанию: 100 максимальное значение: 1000
- locationТип: integer
_code код местоположения поиска. Необязательное поле. Если используете это поле, указывать location_name не нужно. Список доступных местоположений поисковой системы с их location_code можно получить отдельным запросом к https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Значение по умолчанию: 2840. Примечание: данные chat_gpt доступны только для 2840.
- locationТип: string
_name полное название местоположения поиска. Необязательное поле. Если используете это поле, указывать location_code не нужно; если поле не указано, по умолчанию используется location_code со значением 2840. Список доступных местоположений поисковой системы с их location_name можно получить отдельным запросом к https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Примечание: данные chat_gpt доступны только для United States.
- offsetТип: integer
смещение в массиве результатов возвращаемых данных об упоминаниях необязательное поле значение по умолчанию: 0 пример: если указать значение 10, первые десять объектов упоминаний в массиве результатов будут пропущены, а данные будут предоставлены для последующих объектов; Примечание: максимальное значение — 9 000, если нужно сместить больше результатов, используйте search_after_token
- orderТип: array string[]
_by правила сортировки результатов необязательное поле можно использовать те же значения, что и в массиве filters, для сортировки результатов возможные типы сортировки: asc — результаты сортируются по возрастанию desc — результаты сортируются по убыванию для задания типа сортировки используйте запятую пример: ["ai_search_volume,desc"] обратите внимание, что в одном запросе можно задать не более трёх правил сортировки несколько правил сортировки нужно разделять запятой
- platformТип: string
целевая платформа. Необязательное поле. Возможные значения: chat_gpt, google. Значение по умолчанию: google. Примечание: возвращаемые данные зависят от выбранной платформы. Примечание #2: данные chat_gpt доступны только для США и английского языка.
- searchТип: string
_after _token токен для последующих запросов необязательное поле возвращается в одноимённом поле ответа на каждый запрос; используйте этот параметр, чтобы избежать тайм-аутов при получении более 20 000 результатов в одном запросе; указав уникальное значение search_after_token из массива ответа, вы получите последующие результаты исходной задачи; значения search_after_token уникальны для каждой последующей задачи; Примечание: если в запросе указан search_after_token, все остальные параметры должны совпадать с предыдущим запросом
- tagТип: string
пользовательский идентификатор задачи. Необязательное поле. Ограничение — 255 символов. Этот параметр позволяет идентифицировать задачу и сопоставить её с результатом. Указанное значение tag вы найдёте в объекте data ответа.
- Тип: object200
Успешный ответ
- Тип: numbercost
общая стоимость задач, USD
- Тип: integerstatus
_code общий код состояния. Полный список кодов ответа можно найти здесь. Примечание: мы настоятельно рекомендуем предусмотреть систему обработки связанных исключительных ситуаций и ошибок.
- Тип: stringstatus
_message общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.
- Тип: array string[]tasks
массив задач
- Тип: integertasks
_count число задач в массиве tasks
- Тип: integertasks
_error число задач в массиве tasks, возвращённых с ошибкой
- Тип: numbertasks
.cost стоимость задачи, USD
- Тип: objecttasks
.data содержит те же параметры, что вы указали в POST-запросе
- Тип: stringtasks
.id идентификатор задачи. Уникальный идентификатор задачи в нашей системе в формате UUID.
- Тип: array string[]tasks
.path путь URL
- Тип: array string[]tasks
.result массив результатов
- Тип: integertasks
.result _count число элементов в массиве result
- Тип: integertasks
.result .current _offset количество объектов упоминаний, пропущенных в массиве items
- Тип: array string[]tasks
.result .items содержит данные о релевантных упоминаниях
- Тип: integertasks
.result .items _count количество результатов, возвращённых в массиве items
- Тип: integertasks
.result .items .ai _search _volume текущий показатель объёма AI-поиска для ключевого слова. Подробнее об этой метрике здесь.
- Тип: stringtasks
.result .items .answer релевантный ответ в формате Markdown содержимое результата, отформатированное на языке разметки Markdown
- Тип: array string[]tasks
.result .items .brand _entities массив сущностей брендов содержит информацию о брендах, упомянутых в ответе
- Тип: stringtasks
.result .items .brand _entities .category категория бренда
- Тип: integertasks
.result .items .brand _entities .position позиция в результатах
- Тип: stringtasks
.result .items .brand _entities .title название бренда
- Тип: array string[]tasks
.result .items .fan _out _queries массив fan-out запросов содержит связанные поисковые запросы, производные от основного запроса, для более полного ответа
- Тип: stringtasks
.result .items .first _response _at дата и время первой фиксации данных ответа в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00” пример: 2025-10-21 06:25:30 +00:00
- Тип: stringtasks
.result .items .language _code код языка в массиве POST
- Тип: stringtasks
.result .items .last _response _at дата и время последнего обновления данных ответа в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00” пример: 2025-10-21 06:25:30 +00:00
- Тип: integertasks
.result .items .location _code код местоположения в массиве POST
- Тип: stringtasks
.result .items .model _name название модели AI, из которой получены данные Примечание: для типа платформы google значение всегда google_ai_overview
- Тип: array string[]tasks
.result .items .monthly _searches ежемесячные объёмы AI-поиска массив объектов с объёмами AI-поиска за определённый месяц года
- Тип: integertasks
.result .items .monthly _searches .month месяц
- Тип: integertasks
.result .items .monthly _searches .search _volume объём AI-поиска за определённый месяц года подробнее об этой метрике читайте здесь
- Тип: integertasks
.result .items .monthly _searches .year год
- Тип: stringtasks
.result .items .platform платформа, переданная в массиве POST
- Тип: stringtasks
.result .items .question релевантный вопрос
- Тип: array string[]tasks
.result .items .search _results массив результатов поиска все результаты веб-поиска, которые модель получила при поиске информации, включая дубликаты и неиспользованные записи
- Тип: string
хлебные крошки
- Тип: stringtasks
.result .items .search _results .description описание результата
- Тип: stringtasks
.result .items .search _results .domain домен результата
- Тип: integertasks
.result .items .search _results .position позиция в результатах
- Тип: stringtasks
.result .items .search _results .publication _date дата и время публикации результата в формате: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” пример: 2019-11-15 12:57:46 +00:00
- Тип: stringtasks
.result .items .search _results .title заголовок результата
- Тип: stringtasks
.result .items .search _results .url URL результата
- Тип: array string[]tasks
.result .items .sources массив источников источники, которые модель цитировала или на которые опиралась в итоговом ответе
- Тип: stringtasks
.result .items .sources .domain домен источника
- Тип: stringtasks
.result .items .sources .markdown содержимое элемента в формате Markdown содержимое результата, отформатированное на языке разметки Markdown
- Тип: integertasks
.result .items .sources .position позиция в результатах
- Тип: stringtasks
.result .items .sources .publication _date дата и время публикации результата в формате: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” пример: 2019-11-15 12:57:46 +00:00
- Тип: stringtasks
.result .items .sources .snippet описание источника
- Тип: stringtasks
.result .items .sources .source _name название источника
- Тип: stringtasks
.result .items .sources .thumbnail миниатюра источника
- Тип: stringtasks
.result .items .sources .title заголовок источника
- Тип: stringtasks
.result .items .sources .url URL источника
- Тип: stringtasks
.result .search _after _token токен для последующих запросов указав уникальный search_after_token при создании новой задачи, вы получите последующие результаты исходной задачи; значения search_after_token уникальны для каждой последующей задачи
- Тип: integertasks
.result .total _count общее количество результатов, релевантных запросу
- Тип: integertasks
.status _code код состояния задачи, сформированный DataForSEO; может находиться в диапазоне 10000-60000. Полный список кодов ответа можно найти здесь.
- Тип: stringtasks
.status _message информационное сообщение задачи. Полный список общих информационных сообщений можно найти здесь.
- Тип: stringtasks
.time время выполнения, секунды
- Тип: stringtime
время выполнения, секунды
- Тип: stringversion
текущая версия API
application/json - 400
Запрос не удалось обработать. Проверьте параметры запроса.
- 401
Требуется действительный API-ключ Felo.
- 402
Запрос не может быть выполнен: не выполнено требование биллинга.
- 403
Аккаунту не разрешено выполнять эту операцию.
- 429
Достигнут лимит запросов или расходов.
- 502
Сервис не смог выполнить запрос.
- 503
API или сервис биллинга временно недоступны.
- 504
Истекло время ожидания обработки запроса.
- default
Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": [
{}
],
"location_name": "",
"location_code": 1,
"language_name": "",
"language_code": "",
"platform": "",
"filters": [],
"order_by": [
""
],
"offset": 1,
"search_after_token": "",
"limit": 1,
"tag": ""
}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks.id": "string",
"tasks.status_code": 1,
"tasks.status_message": "string",
"tasks.time": "string",
"tasks.cost": 1,
"tasks.result_count": 1,
"tasks.path": [
"string"
],
"tasks.data": {},
"tasks.result": [
"string"
],
"tasks.result.total_count": 1,
"tasks.result.current_offset": 1,
"tasks.result.search_after_token": "string",
"tasks.result.items_count": 1,
"tasks.result.items": [
"string"
],
"tasks.result.items.platform": "string",
"tasks.result.items.model_name": "string",
"tasks.result.items.location_code": 1,
"tasks.result.items.language_code": "string",
"tasks.result.items.question": "string",
"tasks.result.items.answer": "string",
"tasks.result.items.sources": [
"string"
],
"tasks.result.items.sources.snippet": "string",
"tasks.result.items.sources.source_name": "string",
"tasks.result.items.sources.thumbnail": "string",
"tasks.result.items.sources.markdown": "string",
"tasks.result.items.sources.position": 1,
"tasks.result.items.sources.title": "string",
"tasks.result.items.sources.domain": "string",
"tasks.result.items.sources.url": "string",
"tasks.result.items.sources.publication_date": "string",
"tasks.result.items.search_results": [
"string"
],
"tasks.result.items.search_results.description": "string",
"tasks.result.items.search_results.breadcrumb": "string",
"tasks.result.items.search_results.position": 1,
"tasks.result.items.search_results.title": "string",
"tasks.result.items.search_results.domain": "string",
"tasks.result.items.search_results.url": "string",
"tasks.result.items.search_results.publication_date": "string",
"tasks.result.items.ai_search_volume": 1,
"tasks.result.items.monthly_searches": [
"string"
],
"tasks.result.items.monthly_searches.year": 1,
"tasks.result.items.monthly_searches.month": 1,
"tasks.result.items.monthly_searches.search_volume": 1,
"tasks.result.items.first_response_at": "string",
"tasks.result.items.last_response_at": "string",
"tasks.result.items.brand_entities": [
"string"
],
"tasks.result.items.brand_entities.position": 1,
"tasks.result.items.brand_entities.title": "string",
"tasks.result.items.brand_entities.category": "string",
"tasks.result.items.fan_out_queries": [
"string"
]
}