v0.2.0-beta

OpenAPI 3.1.0

Vytváření úloh SERP Google AI Mode

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/serp/google/ai_mode/task_post

Vytváření úloh SERP Google AI Mode

Zařadí do fronty odpověď Google AI Mode pro dotaz včetně zdrojů, které v Google cituje, a vrátí id úlohy v tasks[0].id. 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. Živý protějšek odpovídá okamžitě a pro jedno hledání je jednodušší; do fronty zařazujte, když by dávka překonala trpělivost volání nástroje.

Cenová reference

Účtování: nahlášené náklady na odpověď.
Referenční odhad požadavku: USD 0.02.
Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již 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

application/json

Typ: array (object | null)[]
- browser_screen_height
  Typ: integer | null
  
  výška obrazovky prohlížeče
  
  volitelné pole
  
  můžete nastavit vlastní výšku obrazovky prohlížeče pro výpočet pixelového pořadí pro konkrétní zařízení;
  
  lze ji zadat v následujícím rozsahu: 240-9999;
  
  ve výchozím nastavení je parametr nastaven na:
  
  1080 pro desktop;
  
  640 pro mobile na android;
  
  812 pro mobile na iOS;
  
  Poznámka: pro použití tohoto parametru nastavte calculate_rectangles na true
- browser_screen_resolution_ratio
  Typ: integer | null
  
  faktor měřítka obrazovky prohlížeče
  
  volitelné pole
  
  můžete nastavit vlastní faktor měřítka obrazovky prohlížeče pro výpočet pixelového pořadí pro konkrétní zařízení;
  
  lze jej zadat v následujícím rozsahu: 0.5-3;
  
  ve výchozím nastavení je parametr nastaven na:
  
  1 pro desktop;
  
  3 pro mobile na android;
  
  3 pro mobile na iOS;
  
  Poznámka: pro použití tohoto parametru nastavte calculate_rectangles na true
- browser_screen_width
  Typ: integer | null Formát: int64
  
  šířka obrazovky prohlížeče
  
  volitelné pole
  
  můžete nastavit vlastní šířku obrazovky prohlížeče pro výpočet pixelového pořadí pro konkrétní zařízení;
  
  lze ji zadat v následujícím rozsahu: 240-9999;
  
  ve výchozím nastavení je parametr nastaven na:
  
  1920 pro desktop;
  
  360 pro mobile na android;
  
  375 pro mobile na iOS;
  
  Poznámka: pro použití tohoto parametru nastavte calculate_rectangles na true
- calculate_rectangles
  Typ: boolean | null
  
  vypočítat pixelové pořadí prvků SERP v rozšířených výsledcích
  
  volitelné pole
  
  pixelové pořadí označuje vzdálenost mezi úryvkem výsledku a levým horním rohem obrazovky;
  
  Další informace najdete v Centru nápovědy>>
  
  ve výchozím nastavení je parametr nastaven na false
  
  Poznámka: pokud je nastaveno na true, poplatek za úlohu bude vynásoben 2
- device
  Typ: string | null
  
  typ zařízení
  
  volitelné pole
  
  vracet výsledky pro určitý typ zařízení
  
  může nabývat hodnot:desktop, mobile
  
  výchozí hodnota: desktop
- keyword
  Typ: string
  
  klíčové slovo
  
  povinné pole
  
  v poli keyword můžete zadat až 700 znaků
  
  všechny %## 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 č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/serp/google/ai_mode/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/serp/google/ai_mode/languages;
- location_code
  Typ: integer
  
  kód lokality vyhledávače
  
  povinné pole, pokud nezadáte location_name nebo location_coordinate
  
  pokud toto pole použijete, nemusíte zadávat location_name nebo location_coordinate
  
  seznam dostupných lokalit vyhledávačů s jejich location_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/google/locations
  
  Poznámka: seznam zemí, ve kterých je režim AI Mode aktuálně dostupný, najdete na stránce Google Search Help
- location_coordinate
  Typ: string
  
  GPS souřadnice lokality
  
  povinné pole, pokud nezadáte location_name nebo location_code
  
  pokud toto pole použijete, nemusíte zadávat location_name nebo location_code
  
  parametr location_coordinate je nutné zadat ve formátu "latitude,longitude,zoom"
  
  pokud není "zoom" zadán, použije se jako výchozí hodnota 9z
  
  maximální počet desetinných míst pro "latitude" a "longitude": 7
  
  minimální hodnota pro "zoom": 4z
  
  maximální hodnota pro "zoom": 18z
  
  příklad:
  
  52.6178549,-155.352142,18z
- location_name
  Typ: string
  
  úplný název lokality vyhledávače
  
  povinné pole, pokud nezadáte location_code nebo location_coordinate
  
  pokud toto pole použijete, nemusíte zadávat location_code nebo location_coordinate
  
  seznam dostupných lokalit vyhledávače s jejich location_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/google/locations
  
  Poznámka: seznam zemí, ve kterých je režim AI Mode aktuálně dostupný, najdete na stránce Google Search Help
- os
  Typ: string | null
  
  operační systém zařízení
  
  volitelné pole
  
  pokud v poli device zadáte desktop, vyberte z následujících hodnot: windows, macos
  
  výchozí hodnota: windows
  
  pokud v poli device zadáte mobile, vyberte z následujících hodnot: android, ios
  
  výchozí hodnota: android
- pingback_url
  Typ: string | null
  
  URL oznámení o dokončené úloze
  
  volitelné pole
  
  po dokončení úlohy vás upozorníme požadavkem GET odeslaným na zadanou URL
  
  řetězec ‘$id’ můžete použít jako proměnnou $id a ‘$tag’ jako proměnnou $tag kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.
  
  příklad:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Poznámka: speciální znaky v pingback_url budou kódovány v URL;
  
  např. znak # bude zakódován jako %23
  
  další informace najdete v našem Centru nápovědy
- postback_data
  Typ: string
  
  datový typ postback_url
  
  povinné pole, pokud zadáte postback_url
  
  odpovídá funkci, kterou jste použili k nastavení úlohy
  
  možné hodnoty:
  
  advanced, html
- postback_url
  Typ: string | null
  
  URL pro odesílání výsledků úlohy
  
  volitelné pole
  
  po dokončení úlohy odešleme požadavek POST s výsledky komprimovanými ve formátu gzip na zadanou postback_url
  
  řetězec ‘$id’ můžete použít jako proměnnou $id a ‘$tag’ jako proměnnou $tag kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.
  
  příklad:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Poznámka: speciální znaky v postback_url budou kódovány v URL;
  
  mj. znak # bude zakódován jako %23
  
  další informace najdete v Centru nápovědy
- priority
  Typ: integer | null
  
  priorita úlohy
  
  volitelné pole
  
  může nabývat následujících hodnot:
  
  1 – normální priorita provedení (ve výchozím nastavení)
  
  2 – vysoká priorita provedení
  
  Za úlohy s vysokou prioritou provedení bude účtován příplatek.
  Náklady lze vypočítat na stránce Ceny.
- tag
  Typ: string | null
  
  identifikátor úlohy definovaný uživatelem
  
  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_SerpGoogleAiModeTaskPostResponseInfo
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_SerpGoogleAiModeTaskPostTaskInfo
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: object | null

pole výsledků
v tomto případě bude hodnota null

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/serp/google/ai_mode/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "what is google ai mode"
  }
]'

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

Úspěšná operace

Vytváření úloh SERP Google AI Mode

OvěřováníRequired

DataForSEO

Vytváření úloh SERP Google AI Mode

Cenová reference