v0.2.0-beta

OpenAPI 3.1.0

Živý scraper LLM ChatGPT

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/chat_gpt/llm_scraper/live/advanced

Živý scraper LLM ChatGPT

Položí ChatGPT keyword tak, jak by to udělal uživatel, a vrátí parsovanou odpověď. Vrací keyword, location_code, language_code, model, datetime, markdown, sources, fan_out_queries a brand_entities — markdown je odpověď tak, jak ji asistent vykreslil, sources jsou stránky, které citoval, a brand_entities jsou značky, které uvedl. force_web_search způsobí, že prochází web, místo aby odpovídal z trénovacích dat. Zabaleno do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code — odmítnutý požadavek stále vrací HTTP 200. Toto je endpoint pro otázku „co o nás ChatGPT říká“; pro počítání zmínek napříč mnoha odpověďmi použijte post_dataforseo_ai_llm_mentions_aggregated_metrics_live, místo abyste opakovaně scrapovali. Surová forma je post_dataforseo_ai_chat_gpt_llm_scraper_live_html.

Referenční údaje o cenách

Měření: vykázané náklady odpovědi.
Referenční odhad požadavku: USD 0.004.
Referenční multiplikátor pro zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.

Pouze referenční metadata — nejde o nabídku pro účet, garantovanou cenu ani limit útraty. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo

application/json

Typ: array (object | null)[]
- force_web_search
  Typ: boolean | null
  
  vynutit u AI agenta použití webového vyhledávání
  volitelné pole
  po zapnutí je model AI nucen přistupovat k aktuálním webovým informacím a citovat je;
  výchozí hodnota: false;
  Poznámka: i když je parametr nastaven na true, není zaručeno, že webové zdroje budou v odpovědi citovány
- keyword
  Typ: string
  
  klíčové slovo
  povinné pole
  v poli keyword můžete zadat až 2000 znaků
  všechny výskyty %## budou dekódovány (znak „+” bude dekódován jako mezera)
  pokud potřebujete v keyword použít znak „%”, zadejte jej jako „%25”;
  pokud potřebujete v keyword 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
- language_code
  Typ: string
  
  kód jazyka vyhledávače
  povinné pole, pokud nezadáte language_name;
  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/chat_gpt/llm_scraper/languages
- language_name
  Typ: string
  
  úplný název jazyka vyhledávače
  povinné pole, pokud nezadáte language_code;
  pokud toto pole použijete, nemusíte zadávat language_code;
  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/chat_gpt/llm_scraper/languages
- location_code
  Typ: integer
  
  kód lokality vyhledávače
  povinné pole, pokud nezadáte location_name
  pokud toto pole použijete, nemusíte zadávat location_name
  seznam dostupných lokalit vyhledávačů s jejich location_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
  příklad:
  2840
- location_name
  Typ: string
  
  úplný název lokality vyhledávače
  povinné pole, pokud nezadáte location_code
  pokud toto pole použijete, nemusíte zadávat location_code
  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/chat_gpt/llm_scraper/locations
  příklad:
  United States
- tag
  Typ: string | null
  
  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 | null · Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedResponseInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

status_code
Typ: integer | null

obecný kód stavu úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

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

tasks
Typ: array (object | null)[] | null

pole úloh

Typ: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedTaskInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

data
Typ: object | null

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

propertyName
Typ: object | null
id
Typ: string | null

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

path
Typ: array (string | null)[] | null

cesta URL

result
Typ: array (object | null)[] | null

pole výsledků

brand_entities
Typ: array (object | null)[] | null

pole entit značek
obsahuje informace o značkách zmíněných v odpovědi

category
Typ: string | null

kategorie značky

markdown
Typ: string | null

název značky ve formátu markdown
obsahuje název značky naformátovaný ve značkovacím jazyce markdown

title
Typ: string | null

název značky

type
Typ: string | null

typ prvku

urls
Typ: object | null

pole URL a domén relevantních pro značku

check_url
Typ: string | null

přímá adresa URL na výsledky vyhledávače
můžete ji použít k ověření, že jsme poskytli přesné výsledky

datetime
Typ: string | null

datum a čas přijetí výsledku
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:
2019-11-15 12:57:46 +00:00

fan_out_queries
Typ: array (string | null)[] | null

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

item_types
Typ: array (string | null)[] | null

typy výsledků vyhledávání
obsahuje typy výsledků vyhledávání (items) nalezených v SERP.
možné typy položek:
chat_gpt_text, chat_gpt_table, chat_gpt_navigation_list, chat_gpt_images, chat_gpt_local_businesses, chat_gpt_products

items
Typ: array (object | null)[] | null

prvky výsledků ChatGPT

rank_absolute
Typ: integer | null

absolutní rank v SERP
absolutní pozice mezi všemi prvky

rank_group
Typ: integer | null

pořadí skupiny v SERP
pozice ve skupině prvků se shodnými hodnotami type
pozice prvků s jinými hodnotami type se v rank_group vynechávají

type
Typ: string | null

typ prvku

items_count
Typ: integer | null Formát: int64

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

keyword
Typ: string | null

klíčové slovo přijaté v poli POST
klíčové slovo se vrací s dekódovaným %## (symbol „+” bude dekódován na znak mezery)

language_code
Typ: string | null

kód jazyka v poli POST

location_code
Typ: integer | null

kód lokality v poli POST

markdown
Typ: string | null

obsah prvku ve formátu markdown
obsah výsledku formátovaný v značkovacím jazyce markdown

model
Typ: string | null

označuje verzi modelu

se_results_count
Typ: integer | null Formát: int64

celkový počet výsledků

search_results
Typ: array (object | null)[] | null

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

breadcrumb
Typ: string | null

drobečková navigace

description
Typ: string | null

popis výsledku

domain
Typ: string | null

doména výsledku

title
Typ: string | null

název výsledku

type
Typ: string | null

typ prvku

url
Typ: string | null

URL výsledku

sources
Typ: array (object | null)[] | null

pole zdrojů
zdroje, které model ve své konečné odpovědi skutečně citoval nebo na které se spoléhal

domain
Typ: string | null

doména zdroje v SERP

markdown
Typ: string | null

obsah prvku ve formátu markdown
obsah výsledku formátovaný v značkovacím jazyce markdown

publication_date
Typ: string | null

datum a čas zveřejně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

snippet
Typ: string | null

popis zdroje

source_name
Typ: string | null

název zdroje

thumbnail
Typ: string | null

miniatura zdroje

title
Typ: string | null

titulek zdroje

type
Typ: string | null

typ prvku

url
Typ: string | null

zdrojová URL

result_count
Typ: integer | null Formát: int64

počet prvků v poli result

status_code
Typ: integer | null

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

status_message
Typ: string | null

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

time
Typ: string | null

doba provedení, sekundy

tasks_count
Typ: integer | null Formát: int64

počet úloh v poli tasks

tasks_error
Typ: integer | null Formát: int64

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

time
Typ: string | null

celková doba provádění, sekundy

version
Typ: string | null

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/chat_gpt/llm_scraper/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

Zobrazit schéma

{
  "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": [
        {
          "keyword": null,
          "location_code": null,
          "language_code": null,
          "model": null,
          "check_url": null,
          "datetime": null,
          "markdown": null,
          "search_results": [
            {
              "type": null,
              "url": null,
              "domain": null,
              "title": null,
              "description": null,
              "breadcrumb": null
            }
          ],
          "sources": [
            {
              "type": null,
              "title": null,
              "snippet": null,
              "domain": null,
              "url": null,
              "thumbnail": null,
              "source_name": null,
              "publication_date": null,
              "markdown": null
            }
          ],
          "fan_out_queries": [
            null
          ],
          "brand_entities": [
            {
              "type": null,
              "title": null,
              "category": null,
              "markdown": null,
              "urls": null
            }
          ],
          "se_results_count": null,
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Živý scraper LLM ChatGPT

OvěřováníRequired

DataForSEO

Živý scraper LLM ChatGPT

Referenční údaje o cenách