v0.2.0-beta

OpenAPI 3.1.0

Live-пошук згадок LLM

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/ai_optimization/llm_mentions/search/live

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.

Тіло

обов'язкове

application/json

Тип: 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_subdomains
  Тип: boolean
  
  вказує, чи буде включено піддомени цільового домену в пошук. Необов'язкове поле. Якщо задано true, піддомени включаються в пошук. Значення за замовчуванням: false.
  
  keyword
  Тип: string
  
  цільове ключове слово. Обов'язкове поле, якщо не вказано domain. У полі keyword можна вказати до 250 символів. Усі %## буде декодовано (символ «+» декодується в пробіл). Якщо в keyword потрібен символ «%», укажіть його як «%25»; якщо потрібен символ «+», укажіть його як «%2B». Докладніше про правила й обмеження полів keyword і keywords в API DataForSEO читайте в цій статті Help Center.
  
  match_type
  Тип: string
  
  Тип відповідності цільового ключового слова визначає, як зіставляється вказане ключове слово. Необов'язкове поле можливі значення: word_match — повнотекстовий пошук за фразами, що відповідають указаному початковому ключовому слову з додатковими словами до, після або всередині ключової фрази (наприклад, за запитом "light" буде знайдено "light bulb", "light switch"); partial_match — пошук підрядка, який знаходить усі входження вказаної послідовності символів, навіть якщо вона трапляється всередині довшого слова (наприклад, за запитом "light" буде знайдено "lighting", "highlight"); значення за замовчуванням: word_match
  
  search_filter
  Тип: string
  
  фільтр пошуку сутностей: include або exclude; за замовчуванням include.
  
  search_scope
  Тип: array string[]
  
  область пошуку. Для сутностей-доменів: 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_code
  Тип: string
  
  код мови пошуку. Необов'язкове поле. Якщо використовуєте це поле, вказувати language_name не потрібно. Список доступних мов пошукової системи з їхнім language_code можна отримати окремим запитом до https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Значення за замовчуванням: en. Примітка: дані chat_gpt доступні лише для en.
- language_name
  Тип: string
  
  повна назва мови пошуку. Необов'язкове поле. Якщо використовуєте це поле, вказувати 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_code
  Тип: integer
  
  код місцезнаходження пошуку. Необов'язкове поле. Якщо використовуєте це поле, вказувати location_name не потрібно. Список доступних місцезнаходжень пошукової системи з їхнім location_code можна отримати окремим запитом до https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Значення за замовчуванням: 2840. Примітка: дані chat_gpt доступні лише для 2840.
- location_name
  Тип: string
  
  повна назва місцезнаходження пошуку. Необов'язкове поле. Якщо використовуєте це поле, вказувати 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_by
  Тип: array string[]
  
  правила сортування результатів необов'язкове поле можна використовувати ті самі значення, що й у масиві filters, для сортування результатів можливі типи сортування: asc — результати сортуються за зростанням desc — результати сортуються за спаданням для задання типу сортування використовуйте кому приклад: ["ai_search_volume,desc"] зауважте, що в одному запиті можна задати не більше трьох правил сортування кілька правил сортування потрібно розділяти комою
- platform
  Тип: string
  
  цільова платформа. Необов'язкове поле. Можливі значення: chat_gpt, google. Значення за замовчуванням: google. Примітка: повернуті дані залежать від вибраної платформи. Примітка #2: дані chat_gpt доступні лише для США та англійської мови.
- search_after_token
  Тип: string
  
  токен для наступних запитів необов'язкове поле повертається в однойменному полі відповіді на кожен запит; використовуйте цей параметр, щоб уникнути тайм-аутів під час отримання понад 20 000 результатів в одному запиті; вказавши унікальне значення search_after_token з масиву відповіді, ви отримаєте наступні результати початкового завдання; значення search_after_token унікальні для кожного наступного завдання; Примітка: якщо в запиті вказано search_after_token, усі інші параметри мають бути ідентичні попередньому запиту
- tag
  Тип: string
  
  визначений користувачем ідентифікатор завдання. Необов'язкове поле. Обмеження — 255 символів. Цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом. Вказане значення tag ви знайдете в об'єкті data відповіді.

Відповіді

200
Тип: object

Успішна відповідь
cost
Тип: number

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

status_code
Тип: integer

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

status_message
Тип: string

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

tasks
Тип: array string[]

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

tasks_count
Тип: integer

кількість завдань у масиві tasks

tasks_error
Тип: integer

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

tasks.cost
Тип: number

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

tasks.data
Тип: object

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

tasks.id
Тип: string

ідентифікатор завдання. Унікальний ідентифікатор завдання в нашій системі у форматі UUID.

tasks.path
Тип: array string[]

шлях URL

tasks.result
Тип: array string[]

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

tasks.result_count
Тип: integer

кількість елементів у масиві result

tasks.result.current_offset
Тип: integer

кількість об'єктів згадок, пропущених у масиві items

tasks.result.items
Тип: array string[]

містить дані про релевантні згадки

tasks.result.items_count
Тип: integer

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

tasks.result.items.ai_search_volume
Тип: integer

поточний показник обсягу AI-пошуку для ключового слова. Докладніше про цю метрику тут.

tasks.result.items.answer
Тип: string

релевантна відповідь у форматі Markdown вміст результату, відформатований мовою розмітки Markdown

tasks.result.items.brand_entities
Тип: array string[]

масив сутностей брендів містить інформацію про бренди, згадані у відповіді

tasks.result.items.brand_entities.category
Тип: string

категорія бренду

tasks.result.items.brand_entities.position
Тип: integer

позиція в результатах

tasks.result.items.brand_entities.title
Тип: string

назва бренду

tasks.result.items.fan_out_queries
Тип: array string[]

масив fan-out запитів містить пов'язані пошукові запити, похідні від основного запиту, для повнішої відповіді

tasks.result.items.first_response_at
Тип: string

дата й час першої фіксації даних відповіді у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00” приклад: 2025-10-21 06:25:30 +00:00

tasks.result.items.language_code
Тип: string

код мови в масиві POST

tasks.result.items.last_response_at
Тип: string

дата й час останнього оновлення даних відповіді у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00” приклад: 2025-10-21 06:25:30 +00:00

tasks.result.items.location_code
Тип: integer

код локації в масиві POST

tasks.result.items.model_name
Тип: string

назва моделі AI, з якої отримано дані Примітка: для типу платформи google значення завжди google_ai_overview

tasks.result.items.monthly_searches
Тип: array string[]

щомісячні обсяги AI-пошуку масив об'єктів з обсягами AI-пошуку за певний місяць року

tasks.result.items.monthly_searches.month
Тип: integer

місяць

tasks.result.items.monthly_searches.search_volume
Тип: integer

обсяг AI-пошуку за певний місяць року докладніше про цю метрику читайте тут

tasks.result.items.monthly_searches.year
Тип: integer

рік

tasks.result.items.platform
Тип: string

платформа, передана в масиві POST

tasks.result.items.question
Тип: string

релевантне запитання

tasks.result.items.search_results
Тип: array string[]

масив результатів пошуку всі результати вебпошуку, які модель отримала під час пошуку інформації, включно з дублікатами та невикористаними записами

tasks.result.items.search_results.breadcrumb
Тип: string

навігаційний ланцюжок

tasks.result.items.search_results.description
Тип: string

опис результату

tasks.result.items.search_results.domain
Тип: string

домен результату

tasks.result.items.search_results.position
Тип: integer

позиція в результатах

tasks.result.items.search_results.publication_date
Тип: string

дата й час публікації результату у форматі: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” приклад: 2019-11-15 12:57:46 +00:00

tasks.result.items.search_results.title
Тип: string

заголовок результату

tasks.result.items.search_results.url
Тип: string

URL результату

tasks.result.items.sources
Тип: array string[]

масив джерел джерела, які модель цитувала або на які спиралася у фінальній відповіді

tasks.result.items.sources.domain
Тип: string

домен джерела

tasks.result.items.sources.markdown
Тип: string

вміст елемента у форматі Markdown вміст результату, відформатований мовою розмітки Markdown

tasks.result.items.sources.position
Тип: integer

позиція в результатах

tasks.result.items.sources.publication_date
Тип: string

дата й час публікації результату у форматі: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” приклад: 2019-11-15 12:57:46 +00:00

tasks.result.items.sources.snippet
Тип: string

опис джерела

tasks.result.items.sources.source_name
Тип: string

назва джерела

tasks.result.items.sources.thumbnail
Тип: string

мініатюра джерела

tasks.result.items.sources.title
Тип: string

заголовок джерела

tasks.result.items.sources.url
Тип: string

URL джерела

tasks.result.search_after_token
Тип: string

токен для наступних запитів вказавши унікальний search_after_token під час створення нового завдання, ви отримаєте наступні результати початкового завдання; значення search_after_token унікальні для кожного наступного завдання

tasks.result.total_count
Тип: integer

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

tasks.status_code
Тип: integer

код стану завдання, сформований DataForSEO; може перебувати в діапазоні 10000-60000. Повний список кодів відповіді можна знайти тут.

tasks.status_message
Тип: string

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

tasks.time
Тип: string

час виконання, секунди

time
Тип: string

час виконання, секунди

version
Тип: string

поточна версія API
application/json
400

Не вдалося обробити запит. Перевірте параметри запиту.
401

Потрібен дійсний API-ключ Felo.
402

Запит неможливо виконати: умови білінгу не виконано.
403

Обліковий запис не має дозволу на цю операцію.
429

Досягнуто ліміту запитів або витрат.
502

Служба не змогла виконати запит.
503

API або служба білінгу тимчасово недоступні.
504

Час очікування обробки запиту вичерпано.
default

Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

application/json

post/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live

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"
  ]
}

Успішна відповідь

Live-пошук згадок LLM

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

DataForSEO

Live-пошук згадок LLM

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