# Živý Google AI Mode SERP HTML

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/serp/google/ai_mode/live/html`

**Tags:** DataForSEO

Synchronně vrací odpověď Google AI Mode pro dotaz včetně zdrojů, které v Google cituje. Surový zdrojový kód stránky místo parsovaných výsledků. 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.

### 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.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "keyword": {
            "type": "string",
            "description": "<em>klíčové slovo</em><br><strong>povinné pole</strong><br>v poli <code>keyword</code> můžete zadat <strong>až 700 znaků</strong><br>všechny %## budou dekódovány (znak '+' bude dekódován jako mezera)<br>pokud potřebujete v <code>keyword</code> použít znak \"%\", zadejte jej jako \"%25\";<br>pokud potřebujete v <code>keyword</code> použít znak „+“, zadejte jej jako „%2B“;"
          },
          "location_name": {
            "type": "string",
            "description": "<em>úplný název lokality vyhledávače</em><br><strong>povinné pole, pokud nezadáte</strong> <code>location_code</code> nebo <code>location_coordinate</code><br><strong>pokud toto pole použijete, nemusíte zadávat <code>location_code</code> nebo <code>location_coordinate</code></strong><br>seznam dostupných lokalit vyhledávače s jejich <code>location_name</code> získáte samostatným požadavkem na <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations</code><br>příklad:<br><code class=\"long-string\">London,England,United Kingdom</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>kód lokality vyhledávače</em><br><strong>povinné pole, pokud nezadáte</strong> <code>location_name</code> nebo <code>location_coordinate</code><br><strong>pokud toto pole použijete, nemusíte zadávat <code>location_name</code> nebo <code>location_coordinate</code></strong><br>seznam dostupných lokalit vyhledávačů s jejich <code>location_code</code> získáte samostatným požadavkem na <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations</code><br>příklad:<br><code class=\"long-string\">2840</code>"
          },
          "location_coordinate": {
            "type": "string",
            "description": "<em>GPS souřadnice lokality</em><br><strong>povinné pole, pokud nezadáte</strong> <code>location_name</code> nebo <code>location_code</code><br><strong>pokud toto pole použijete, nemusíte zadávat <code>location_name</code> ani <code>location_code</code></strong><br>parametr <code>location_coordinate</code> je nutné zadat ve formátu <em>\"latitude,longitude,radius\"</em><br>maximální počet desetinných míst pro <em>\"latitude\"</em> a <em>\"longitude\"</em>: 7<br>minimální hodnota <em>\"radius\"</em>: 199.9 (mm)<br>maximální hodnota <em>\"radius\"</em>: 199999 (mm)<br>příklad:<br><code class=\"long-string\">53.476225,-2.243572,200</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>úplný název jazyka vyhledávače</em><br>povinné pole, pokud nezadáte <code>language_code</code>;<br>pokud toto pole použijete, nemusíte zadávat <code>language_code</code>;<br>seznam dostupných jazyků vyhledávače s jejich <code>language_name</code> získáte samostatným požadavkem na <code>https://api.dataforseo.com/v3/serp/google/ai_mode/languages</code>;"
          },
          "language_code": {
            "type": "string",
            "description": "<em>kód jazyka vyhledávače</em><br>povinné pole, pokud nezadáte <code>language_name</code>;<br>pokud toto pole použijete, nemusíte zadávat <code>language_name</code>;<br>seznam dostupných jazyků vyhledávače s jejich <code>language_code</code> získáte samostatným požadavkem na <code>https://api.dataforseo.com/v3/serp/google/ai_mode/languages</code>"
          },
          "device": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>typ zařízení</em><br>volitelné pole<br>vracet výsledky pro určitý typ zařízení<br>možné hodnoty:<code>desktop</code>, <code>mobile</code><br>výchozí hodnota: <code>desktop</code>"
          },
          "os": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>operační systém zařízení</em><br>volitelné pole<br>pokud v poli <code>device</code> zadáte <code>desktop</code>, vyberte z následujících hodnot: <code>windows</code>, <code>macos</code><br>výchozí hodnota: <code>windows</code><br>pokud v poli <code>device</code> zadáte <code>mobile</code>, vyberte z následujících hodnot: <code>android</code>, <code>ios</code><br>výchozí hodnota: <code>android</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>uživatelem definovaný identifikátor úlohy</em><br>volitelné pole<br><em>limit znaků je 255</em><br>tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem<br>zadanou hodnotu <code>tag</code> najdete v objektu <code>data</code> odpovědi"
          }
        },
        "example": [
          {
            "language_code": "en",
            "location_code": 2840,
            "keyword": "albert einstein"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_code": "en",
      "location_code": 2840,
      "keyword": "albert einstein"
    }
  ]
}
```

## Responses

### 200 — Úspěšná operace

Headers:
- `X-Request-Id` (string) — Identifikátor požadavku, který je třeba uvést při kontaktování podpory Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleAiModeLiveHtmlResponseInfo"
    }
  ]
}
```

### 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**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "aktuální verze API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "obecný kód stavu\núplný seznam kódů odpovědí najdete zde"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "obecná informační zpráva\núplný seznam obecných informačních zpráv najdete zde"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "celková doba provádění, sekundy"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "celkové náklady na úlohy, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "počet úloh v poli tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "počet úloh v poli tasks vrácených s chybou",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "identifikátor úlohy\njedinečný identifikátor úlohy v našem systému ve formátu UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "stavový kód úlohy\nvygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000\núplný seznam kódů odpovědí najdete zde"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "informační zpráva úlohy\núplný seznam obecných informačních zpráv najdete zde"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "doba provedení, sekundy"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "celkové náklady na úlohy, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "počet prvků v poli result",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "cesta URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "obsahuje stejné parametry, které jste zadali v požadavku POST"
    }
  }
}
```

### Response36Afe1097B20_HtmlItemInfo

`#/components/schemas/Response36Afe1097B20_HtmlItemInfo`

```json
{
  "type": "object",
  "properties": {
    "page": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<i>pořadové číslo vrácené stránky HTML</i>"
    },
    "date": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>datum a čas skenování stránky HTML</em><br>ve formátu UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>příklad:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "html": {
      "type": [
        "string",
        "null"
      ],
      "description": "<i>stránka</i> <i>HTML</i>"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleAiModeLiveHtmlResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleAiModeLiveHtmlResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleAiModeLiveHtmlTaskInfo"
              }
            ]
          },
          "description": "<em>pole úloh</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SerpGoogleAiModeLiveHtmlResultInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleAiModeLiveHtmlResultInfo`

```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>klíčové slovo přijaté v poli POST<br></em><strong>klíčové slovo se vrací s dekódovaným %## (znak plus '+' bude dekódován jako mezera)</strong>"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "typ prvku"
    },
    "se_domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>doména vyhledávače v poli POST</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>kód lokality v poli POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>kód jazyka v poli POST</em>"
    },
    "datetime": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>datum a čas přijetí výsledku</em><br>ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”<br>příklad:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>počet výsledků vrácených v poli <strong><code>items</code></strong></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_HtmlItemInfo"
          }
        ]
      },
      "description": "<em>prvky výsledků vyhledávání nalezené v SERP</em>"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleAiModeLiveHtmlTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleAiModeLiveHtmlTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleAiModeLiveHtmlResultInfo"
              }
            ]
          },
          "description": "<em>pole výsledků</em>"
        }
      }
    }
  ]
}
```
