v0.2.0-beta

OpenAPI 3.1.0

Živé LLM Mentions

Felo API Support

MIT

Server

https://openapi.felo.ai

Klientské knihovny

Shell Curl

DataForSEO

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

DataForSEO Operace

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

Živé LLM Mentions

Jednotlivé odpovědi, ve kterých asistent zmínil váš cíl. Vrací total_count, current_offset, search_after_token a items – po prvních stránkách stránkujte pomocí tokenu, nikoli offset. ⚠️ target je pole objektů, každý {"domain": "..."} nebo {"keyword": "..."}; samotný řetězec je odmítnut jako nesprávný typ a pole řetězců s hlášením „Each target item must be an object”. Pole filtrů pocházejí z get_dataforseo_ai_llm_mentions_available_filters. Zabalené v obálce DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code – odmítnutý požadavek stále vrací HTTP 200. Pro počty místo samotných zmínek použijte post_dataforseo_ai_llm_mentions_aggregated_metrics_live.

Cenová reference

Účtování: nahlášené náklady na odpověď.
Referenční odhad požadavku: USD 0.701.
Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo

povinné

application/json

Typ: array object[]
- target
  Typ: array object[]
  povinné
  
  pole objektů obsahujících cílové entity — povinné pole. V poli target můžete zadat až 10 entit (objektů). Jedna cílová entita může obsahovat buď jednu doménu, nebo jedno klíčové slovo a související parametry. Příklady: pole target s doménovou entitou [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] pole target s entitou klíčového slova [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] pole target s více entitami [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]
  
  domain
  Typ: string
  povinné
  
  cílová doména — povinné pole, pokud nezadáte keyword. V poli domain můžete zadat až 63 znaků; doména musí být zadána bez https:// a www.
  
  include_subdomains
  Typ: boolean
  
  určuje, zda budou subdomény cílové domény zahrnuty do vyhledávání — volitelné pole. Pokud je nastaveno na true, budou subdomény do vyhledávání zahrnuty. Výchozí hodnota: false
  
  keyword
  Typ: string
  
  cílové klíčové slovo — povinné pole, pokud nezadáte domain. V poli keyword můžete zadat až 250 znaků. Všechny výskyty %## budou dekódovány (znak „+” bude dekódován jako mezera). Pokud potřebujete použít znak „%”, zadejte jej jako „%25”; pokud potřebujete použít znak „+”, zadejte jej jako „%2B”. Další informace o pravidlech a omezeních polí keyword a keywords v rozhraních API DataForSEO najdete v tomto článku Centra nápovědy
  
  match_type
  Typ: string
  
  Typ shody cílového klíčového slova. Určuje, jak se zadané klíčové slovo porovnává. Volitelné pole. Možné hodnoty: word_match — fulltextové hledání výrazů odpovídajících zadanému klíčovému slovu s dalšími slovy před, za nebo uvnitř fráze (např. hledání „light” vrátí výsledky obsahující „light bulb”, „light switch”); partial_match — hledání podřetězce, které najde všechny výskyty zadané posloupnosti znaků, i když se objeví uvnitř delšího slova (např. hledání „light” vrátí výsledky obsahující „lighting”, „highlight”); výchozí hodnota: word_match.
  
  search_filter
  Typ: string
  
  Filtr vyhledávání entit: include nebo exclude; výchozí je include.
  
  search_scope
  Typ: array string[]
  
  Rozsah vyhledávání. Doménové entity: any, sources, search_results. Entity klíčových slov: any, question, answer, brand_entities, fan_out_queries. Výchozí: any.
- filters
  Typ: array
  
  Pole parametrů filtrování výsledků. Volitelné pole. Můžete přidat několik filtrů najednou (maximálně 8). Mezi podmínkami je nutné nastavit logický operátor and nebo or. Podporované operátory: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match. Operátor % můžete použít s like a not_like pro shodu s libovolným řetězcem o nule nebo více znacích. Příklad: ["ai_search_volume",">","1000"]. Úplný seznam možných filtrů je k dispozici zde.
- language_code
  Typ: string
  
  kód jazyka vyhledávání — volitelné pole. Pokud toto pole použijete, nemusíte zadávat language_name; seznam dostupných jazyků vyhledávače s jejich language_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages výchozí hodnota: en. Poznámka: data chat_gpt jsou dostupná pouze pro en
- language_name
  Typ: string
  
  úplný název jazyka vyhledávání — volitelné pole. Pokud toto pole použijete, nemusíte zadávat language_code; pokud toto pole nezadáte, ve výchozím nastavení se použije language_code s hodnotou en; seznam dostupných jazyků vyhledávače s jejich language_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages Poznámka: data chat_gpt jsou dostupná pouze pro angličtinu
- limit
  Typ: integer
  
  Maximální počet vrácených objektů. Volitelné pole. Výchozí hodnota: 100. Maximální hodnota: 1000.
- location_code
  Typ: integer
  
  kód lokality vyhledávání — volitelné pole. Pokud toto pole použijete, nemusíte zadávat location_name. Seznam dostupných lokalit vyhledávače s jejich location_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages výchozí hodnota: 2840. Poznámka: data chat_gpt jsou dostupná pouze pro 2840
- location_name
  Typ: string
  
  úplný název lokality vyhledávání — volitelné pole. Pokud toto pole použijete, nemusíte zadávat location_code; pokud toto pole nezadáte, ve výchozím nastavení se použije location_code s hodnotou 2840; seznam dostupných lokalit vyhledávače s jejich location_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages Poznámka: data chat_gpt jsou dostupná pouze pro Spojené státy
- offset
  Typ: integer
  
  Posun v poli výsledků vrácených dat o zmínkách. Volitelné pole. Výchozí hodnota: 0. Příklad: pokud zadáte hodnotu 10, prvních deset objektů zmínek v poli výsledků bude vynecháno a data budou vrácena pro následující objekty. Poznámka: maximální hodnota je 9 000; pokud chcete vynechat více výsledků, použijte search_after_token.
- order_by
  Typ: array string[]
  
  Pravidla řazení výsledků. Volitelné pole. K řazení výsledků můžete použít stejné hodnoty jako v poli filters. Možné typy řazení: asc — výsledky budou seřazeny vzestupně; desc — výsledky budou seřazeny sestupně. Typ řazení se nastavuje čárkou. Příklad: ["ai_search_volume,desc"]. Pamatujte, že v jednom požadavku lze nastavit nejvýše tři pravidla řazení; několik pravidel řazení je nutné oddělit čárkou.
- platform
  Typ: string
  
  cílová platforma — volitelné pole. Možné hodnoty: chat_gpt, google. Výchozí hodnota: google. Poznámka: vrácená data závisí na vybrané platformě. Poznámka 2: data chat_gpt jsou dostupná pouze pro Spojené státy a angličtinu
- search_after_token
  Typ: string
  
  Token pro následné požadavky. Volitelné pole. Vrací se ve stejném poli odpovědi na každý požadavek. Tento parametr použijte, abyste se vyhnuli časovým limitům při pokusu o získání více než 20 000 výsledků v jednom požadavku. Zadáním jedinečné hodnoty search_after_token z pole odpovědi získáte následující výsledky počáteční úlohy. Hodnoty search_after_token jsou jedinečné pro každou následnou úlohu. Poznámka: pokud je v požadavku zadán search_after_token, všechny ostatní parametry musí být shodné s předchozím požadavkem.
- tag
  Typ: string
  
  uživatelem definovaný identifikátor úlohy — volitelné pole. Limit znaků je 255. Tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem. Zadanou hodnotu tag najdete v objektu data odpovědi

Odpovědi

200
Typ: object

Úspěšná odpověď
cost
Typ: number

celkové náklady na úlohy, USD

status_code
Typ: integer

obecný kód stavu. Úplný seznam kódů odpovědí najdete zde. Poznámka: důrazně doporučujeme navrhnout systém pro zpracování souvisejících výjimečných nebo chybových stavů

status_message
Typ: string

obecná informační zpráva. Úplný seznam obecných informačních zpráv najdete zde

tasks
Typ: array string[]

pole úloh

tasks_count
Typ: integer

počet úloh v poli tasks

tasks_error
Typ: integer

počet úloh v poli tasks vrácených s chybou

tasks.cost
Typ: number

náklady na úlohu, USD

tasks.data
Typ: object

obsahuje stejné parametry, které jste zadali v požadavku POST

tasks.id
Typ: string

identifikátor úlohy. Jedinečný identifikátor úlohy v našem systému ve formátu UUID

tasks.path
Typ: array string[]

cesta URL

tasks.result
Typ: array string[]

pole výsledků

tasks.result_count
Typ: integer

počet prvků v poli result

tasks.result.current_offset
Typ: integer

Počet objektů zmínek vynechaných v poli items.

tasks.result.items
Typ: array string[]

Obsahuje relevantní data o zmínkách.

tasks.result.items_count
Typ: integer

Počet výsledků vrácených v poli items.

tasks.result.items.ai_search_volume
Typ: integer

aktuální míra AI vyhledávacího objemu pro klíčové slovo. Další informace o této metrice najdete zde

tasks.result.items.answer
Typ: string

Relevantní odpověď ve formátu Markdown. Obsah výsledku naformátovaný ve značkovacím jazyce Markdown.

tasks.result.items.brand_entities
Typ: array string[]

Pole entit značek. Obsahuje informace o značkách zmíněných v odpovědi.

tasks.result.items.brand_entities.category
Typ: string

Kategorie značky.

tasks.result.items.brand_entities.position
Typ: integer

Pozice ve výsledcích.

tasks.result.items.brand_entities.title
Typ: string

Název značky.

tasks.result.items.fan_out_queries
Typ: array string[]

Pole dotazů fan-out. Obsahuje související vyhledávací dotazy odvozené z hlavního dotazu pro komplexnější odpověď.

tasks.result.items.first_response_at
Typ: string

Datum a čas prvního zaznamenání dat odpovědi ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”. Příklad: 2025-10-21 06:25:30 +00:00.

tasks.result.items.language_code
Typ: string

Kód jazyka v poli POST.

tasks.result.items.last_response_at
Typ: string

Datum a čas poslední aktualizace dat odpovědi ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”. Příklad: 2025-10-21 06:25:30 +00:00.

tasks.result.items.location_code
Typ: integer

Kód lokality v poli POST.

tasks.result.items.model_name
Typ: string

Název modelu AI, ze kterého byla data získána. Poznámka: pro typ platformy google je hodnota vždy google_ai_overview.

tasks.result.items.monthly_searches
Typ: array string[]

Měsíční míry vyhledávání AI. Pole objektů s mírami vyhledávání AI v daném měsíci roku.

tasks.result.items.monthly_searches.month
Typ: integer

Měsíc.

tasks.result.items.monthly_searches.search_volume
Typ: integer

Míra vyhledávání AI v daném měsíci roku. Více o této metrice najdete zde.

tasks.result.items.monthly_searches.year
Typ: integer

Rok.

tasks.result.items.platform
Typ: string

Platforma přijatá v poli POST.

tasks.result.items.question
Typ: string

Související otázka.

tasks.result.items.search_results
Typ: array string[]

Pole výsledků vyhledávání. Všechny výstupy webového vyhledávání, které model získal při vyhledávání informací, včetně duplicit a nepoužitých položek.

tasks.result.items.search_results.breadcrumb
Typ: string

Drobečková navigace.

tasks.result.items.search_results.description
Typ: string

Popis výsledku.

tasks.result.items.search_results.domain
Typ: string

Doména výsledku.

tasks.result.items.search_results.position
Typ: integer

Pozice ve výsledcích.

tasks.result.items.search_results.publication_date
Typ: string

Datum a čas publikování výsledku ve formátu: „year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”. Příklad: 2019-11-15 12:57:46 +00:00.

tasks.result.items.search_results.title
Typ: string

Titulek výsledku.

tasks.result.items.search_results.url
Typ: string

URL výsledku.

tasks.result.items.sources
Typ: array string[]

Pole zdrojů. Zdroje, které model citoval nebo o které se opřel ve své závěrečné odpovědi.

tasks.result.items.sources.domain
Typ: string

Doména zdroje.

tasks.result.items.sources.markdown
Typ: string

Obsah prvku ve formátu Markdown. Obsah výsledku naformátovaný ve značkovacím jazyce Markdown.

tasks.result.items.sources.position
Typ: integer

Pozice ve výsledcích.

tasks.result.items.sources.publication_date
Typ: string

Datum a čas publikování výsledku ve formátu: „year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”. Příklad: 2019-11-15 12:57:46 +00:00.

tasks.result.items.sources.snippet
Typ: string

Popis zdroje.

tasks.result.items.sources.source_name
Typ: string

Název zdroje.

tasks.result.items.sources.thumbnail
Typ: string

Náhled zdroje.

tasks.result.items.sources.title
Typ: string

Titulek zdroje.

tasks.result.items.sources.url
Typ: string

URL zdroje.

tasks.result.search_after_token
Typ: string

Token pro následné požadavky. Zadáním jedinečného search_after_token při nastavování nové úlohy získáte následující výsledky počáteční úlohy. Hodnoty search_after_token jsou jedinečné pro každou následnou úlohu.

tasks.result.total_count
Typ: integer

Celkový počet výsledků odpovídajících požadavku.

tasks.status_code
Typ: integer

kód stavu úlohy vygenerovaný DataForSEO; může být v rozsahu: 10000-60000. úplný seznam kódů odpovědí najdete zde

tasks.status_message
Typ: string

informační zpráva úlohy. úplný seznam obecných informačních zpráv najdete zde

tasks.time
Typ: string

doba provedení, sekundy

time
Typ: string

doba provedení, sekundy

version
Typ: string

aktuální verze API
application/json
400

Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
401

Je vyžadován platný API klíč Felo.
402

V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
403

Účet nemá oprávnění tuto operaci provést.
429

Byl dosažen limit požadavků nebo útraty.
502

Služba nemohla požadavek dokončit.
503

API nebo fakturační služba je dočasně nedostupná.
504

Při zpracování požadavku vypršel časový limit služby.
default

Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

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

Zobrazit schéma

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

Úspěšná odpověď

Živé LLM Mentions

OvěřováníRequired

DataForSEO

Živé LLM Mentions

Cenová reference