# Nejčastější hledání

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/dataforseo_labs/google/top_searches/live`

**Tags:** DataForSEO

Klíčová slova s nejvyšším objemem v dané lokalitě, nefiltrovaná podle seedu ani webu. Stránkování přes `limit`, `offset` a `offset_token`; po prvních stránkách používejte token. 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 objevný konec rodiny: použijte jej, když ještě nemáte výchozí klíčové slovo, a poté zúžte pomocí `post_dataforseo_labs_google_keyword_ideas_live`.

### Cenová reference

- Účtování: nahlášené náklady na odpověď.
- Referenční odhad požadavku: USD 0.1356.
- 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.

## Related links

- [tomto článku Centra nápovědy](<https://dataforseo.com/help-center/what-are-clickstream-based-metrics-and-how-do-we-calculate-them>)
- [Dataforseo Labs - Filters](<https://docs.dataforseo.com/v3/dataforseo_labs/filters>)
- [průvodci centra nápovědy](<https://dataforseo.com/help-center/how-to-use-filters-in-dataforseo-labs-api>)
- [Centru nápovědy](<https://dataforseo.com/help-center/what-is-the-difference-between-the-offset-and-offset_token-parameters#offset_token>)
- [tomto článku nápovědy](<https://dataforseo.com/help-center/search-intent-and-its-types>)
- [tomto článku centra nápovědy](<https://dataforseo.com/help-center/what-is-competition>)
- [zde](<https://cdn.dataforseo.com/v3/categories/categories_dataforseo_labs_2023_10_25.csv>)
- [této příručce centra nápovědy](<https://dataforseo.com/help-center/what-is-keyword-difficulty-and-how-is-it-calculated>)
- [tomto článku nápovědy](<https://dataforseo.com/help-center/what_is_rank_in_backlinks_api>)

## 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": {
          "location_name": {
            "type": "string",
            "description": "<em>úplný název lokality</em><br><strong>povinné pole, pokud nezadáte</strong> <code>location_code</code><br><strong>Poznámka:</strong> je nutné zadat buď <code>location_name</code>, nebo <code>location_code</code><br>seznam dostupných lokalit a jejich <code>location_name</code> získáte odesláním samostatného požadavku na <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>příklad:<br><code class=\"long-string\">United Kingdom</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>kód lokality</em><br><strong>povinné pole, pokud nezadáte</strong> <code>location_name</code><br><strong>Poznámka:</strong> je nutné zadat buď <code>location_name</code>, nebo <code>location_code</code><br>seznam dostupných lokalit a jejich <code>location_code</code> získáte odesláním samostatného požadavku na <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>příklad:<br><code class=\"long-string\">2840</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>úplný název jazyka</em><br><strong>povinné pole, pokud nezadáte</strong> <code>language_code</code><br><strong>Poznámka:</strong> je nutné zadat buď <code>language_name</code>, nebo <code>language_code</code><br>seznam dostupných lokalit a jejich <code>language_name</code> získáte odesláním samostatného požadavku na <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>příklad:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>kód jazyka</em><br><strong>povinné pole, pokud nezadáte</strong> <code>language_name</code><br><strong>Poznámka:</strong> je nutné zadat buď <code>language_name</code>, nebo <code>language_code</code><br>seznam dostupných lokalit a jejich <code>language_code</code> získáte odesláním samostatného požadavku na <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>příklad:<br><code class=\"long-string\">en</code>"
          },
          "include_serp_info": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>zahrnout data ze SERP pro každé klíčové slovo</em><br>volitelné pole<br>pokud je nastaveno na <code>true</code>, vrátíme pole <code>serp_info</code> obsahující data SERP (počet výsledků vyhledávání, příslušnou URL a funkce SERP) pro každé klíčové slovo v odpovědi<br>výchozí hodnota: <code>false</code>"
          },
          "include_clickstream_data": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>zahrnout nebo vyloučit data z metrik založených na clickstreamu ve výsledku</em><br>volitelné pole<br>pokud je parametr nastaven na <code>true</code>, obdržíte pole <code>clickstream_keyword_info</code>, <code>keyword_info_normalized_with_clickstream</code> a <code>keyword_info_normalized_with_bing</code> v odpovědi<br>výchozí hodnota: <code>false</code><br>při zapnutí tohoto parametru bude požadavek účtován dvojnásobnou cenou<p>další informace o tom, jak se metriky založené na clickstreamu počítají, najdete v tomto článku Centra nápovědy"
          },
          "ignore_synonyms": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>ignorovat velmi podobná klíčová slova</em><br>volitelné pole<br>pokud je nastaveno na <code class=\"prettyprint\">true</code>, vrátí se pouze základní klíčová slova a všechna velmi podobná klíčová slova budou vyloučena;  <br>výchozí hodnota: <code>false</code>"
          },
          "filters": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "object",
                "null"
              ]
            },
            "description": "<em>pole parametrů filtrování výsledků</em><br>volitelné pole<br><strong>můžete přidat několik filtrů najednou (maximálně 8)</strong><br>mezi podmínkami je nutné nastavit logický operátor <code>and</code>, <code>or</code><br>podporované operátory:<br><code>regex</code>, <code>not_regex</code>, <code>&lt;</code>, <code>&lt;=</code>, <code>&gt;</code>, <code>&gt;=</code>, <code>=</code>, <code>&lt;&gt;</code>, <code>in</code>, <code>not_in</code>, <code>match</code>, <code>not_match</code>, <code>ilike</code>, <code>not_ilike</code>, <code>like</code>,<code>not_like</code><br>operátor <code>%</code> můžete použít s <code>like</code> a <code>not_like</code>, stejně jako s <code>ilike</code> a <code>not_ilike</code>, pro shodu s libovolným řetězcem o nule nebo více znacích<br>příklad:<br><code>[\"keyword_info.search_volume\",\"&gt;\",0]</code><p><code>[[\"keyword_info.search_volume\",\"in\",[0,1000]],<br>\"and\",<br>[\"keyword_info.competition_level\",\"=\",\"LOW\"]]</code><p><code>[[\"keyword_info.search_volume\",\"&gt;\",100],<br>\"and\",<br>[[\"keyword_info.cpc\",\"&lt;\",0.5],<br>\"or\",<p>[\"keyword_info.high_top_of_page_bid\",\"&lt;=\",0.5]]]</code><br>další informace o filtrech naleznete v Dataforseo Labs - Filters nebo v tomto průvodci centra nápovědy"
          },
          "order_by": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>pravidla řazení výsledků</em><br>volitelné pole<br>k řazení výsledků můžete použít stejné hodnoty jako v poli <code>filters</code><br>možné typy řazení:<br><code>asc</code> — výsledky budou seřazeny vzestupně<br><code>desc</code> — výsledky budou seřazeny sestupně<br>typ řazení se nastavuje čárkou<br>příklad:<br><code>[\"keyword_info.competition,desc\"]</code><br>výchozí pravidlo:<br><code>[\"keyword_info.search_volume,desc\"]</code><br><strong>pamatujte, že v jednom požadavku lze nastavit nejvýše tři pravidla řazení</strong><br>několik pravidel řazení je nutné oddělit čárkou<br>příklad:<br><code>[\"keyword_info.search_volume,desc\",\"keyword_info.cpc,desc\"]</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"
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>maximální počet vrácených klíčových slov</em><br>volitelné pole<br><strong>Poznámka:</strong> více než 1000 výsledků můžete získat pomocí <code>offset_token</code> uvedeného v odpovědi na každý následující požadavek<br>výchozí hodnota: <code>1000</code><br>maximální hodnota: <code>1000</code>"
          },
          "offset": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>posun v poli výsledků vrácených klíčových slov</em><br>volitelné pole<br>výchozí hodnota: <code>0</code><br>pokud zadáte hodnotu <code>10</code>, prvních deset klíčových slov v poli výsledků bude vynecháno a data budou vrácena pro následující klíčová slova<br><strong>Poznámka:</strong> doporučujeme tento parametr používat pouze při načítání až 10 000 výsledků<br>pro načtení více než 10 000 výsledků použijte místo toho <code>offset_token</code>."
          },
          "offset_token": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>token posunu pro následující požadavky</em><br>volitelné pole<br>uvádí se v identickém poli odpovědi na každý požadavek;<br>tento parametr použijte, abyste se vyhnuli vypršení časového limitu při pokusu o získání více než 10 000 výsledků v jednom požadavku;<br>zadáním jedinečné hodnoty <code>offset_token</code> z pole odpovědi získáte následující výsledky původní úlohy;<br>hodnoty <code>offset_token</code> jsou jedinečné pro každou následující úlohu<br><strong>Poznámka:</strong> pokud je v požadavku zadán <code>offset_token</code>, všechny ostatní parametry kromě <code>limit</code> nebudou při zpracování úlohy brány v úvahu.<br>další informace o tomto parametru najdete v našem Centru nápovědy"
          }
        },
        "example": [
          {
            "language_name": "English",
            "location_code": 2840,
            "limit": 3
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_name": "English",
      "location_code": 2840,
      "limit": 3
    }
  ]
}
```

## 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_DataforseoLabsGoogleTopSearchesLiveResponseInfo"
    }
  ]
}
```

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

`#/components/schemas/Response36Afe1097B20_AvgBacklinksInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>typ vyhledávače</em>"
    },
    "backlinks": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>průměrný počet zpětných odkazů</em>"
    },
    "dofollow": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>průměrný počet odkazů dofollow</em>"
    },
    "referring_pages": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>průměrný počet odkazujících stránek</em>"
    },
    "referring_domains": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>průměrný počet odkazujících domén</em>"
    },
    "referring_main_domains": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>průměrný počet odkazujících hlavních domén</em>"
    },
    "rank": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>průměrný rank</em><br>více o metrice a vzorci pro její výpočet najdete v tomto článku nápovědy"
    },
    "main_domain_rank": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>průměrné pořadí hlavní domény</em><br>více o této metrice a jejím výpočtovém vzorci v tomto článku centra nápovědy"
    },
    "last_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>datum a čas aktualizace dat klíčového slova</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>"
    }
  }
}
```

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

`#/components/schemas/Response36Afe1097B20_ClickstreamKeywordInfo`

```json
{
  "type": "object",
  "properties": {
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>průměrná měsíční míra objemu vyhledávání</em><br>představuje (přibližný) počet vyhledávání daného námětu klíčového slova na google.com",
      "format": "int64"
    },
    "last_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>datum a čas aktualizace dat klíčového slova</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>"
    },
    "gender_distribution": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>rozložení odhadovaných metrik založených na clickstreamu podle pohlaví</em><br>více o tom, jak se metrika počítá, najdete v tomto článku nápovědy"
    },
    "age_distribution": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>rozložení metrik založených na clickstreamu podle věku</em><br>více o tom, jak se metrika počítá, najdete v tomto článku nápovědy"
    },
    "monthly_searches": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo"
          }
        ]
      },
      "description": "<em>měsíční vyhledávání</em><br>představuje (přibližný) počet vyhledávání daného námětu klíčového slova (dostupný za posledních dvanáct měsíců) v zadaných zeměpisných lokalitách"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveResponseInfo`

```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_DataforseoLabsGoogleTopSearchesLiveTaskInfo"
              }
            ]
          },
          "description": "<em>pole úloh</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveResultInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>typ vyhledávače</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>"
    },
    "total_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>celkový počet výsledků v naší databázi relevantních pro váš požadavek</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>počet výsledků vrácených v poli <code>items</code></em>",
      "format": "int64"
    },
    "offset": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>aktuální hodnota offsetu</em>"
    },
    "offset_token": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>token posunu pro následné požadavky</em><br>řetězec uvedený v tomto poli můžete použít k získání následných výsledků počáteční úlohy;<br><strong>poznámka:</strong> hodnoty <code>offset_token</code> jsou jedinečné pro každou následnou úlohu"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_KeywordDataInfo"
          }
        ]
      },
      "description": "<em>obsahuje klíčová slova a související data</em>"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveTaskInfo`

```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_DataforseoLabsGoogleTopSearchesLiveResultInfo"
              }
            ]
          },
          "description": "<em>pole výsledků</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_KeywordDataInfo

`#/components/schemas/Response36Afe1097B20_KeywordDataInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>typ vyhledávače</em>"
    },
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>vrácený nápad na klíčové slovo</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>"
    },
    "keyword_info": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_KeywordInfo"
        }
      ],
      "description": "<em>data klíčového slova pro vrácený nápad na klíčové slovo</em>"
    },
    "keyword_info_normalized_with_bing": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_KeywordInfoNormalizedWithInfo"
        }
      ],
      "description": "<em>obsahuje objem vyhledávání klíčového slova normalizovaný objemem vyhledávání Bing</em>"
    },
    "keyword_info_normalized_with_clickstream": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_KeywordInfoNormalizedWithInfo"
        }
      ],
      "description": "<em>obsahuje objem vyhledávání klíčového slova normalizovaný clickstream daty<br></em>"
    },
    "clickstream_keyword_info": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_ClickstreamKeywordInfo"
        }
      ],
      "description": "<em>clickstream data pro vrácené klíčové slovo</em><br>pro získání výsledků tohoto pole musí být parametr <code>include_clickstream_data</code> nastaven na <code>true</code>"
    },
    "keyword_properties": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_KeywordProperties"
        }
      ],
      "description": "<em>doplňující informace o klíčovém slovu</em>"
    },
    "serp_info": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_SerpInfo"
        }
      ],
      "description": "<em>data SERP</em><br>hodnota bude <code>null</code>, pokud jste v poli POST nenastavili pole <code>include_serp_info</code> na <code>true</code> nebo pokud v naší databázi nejsou pro toto klíčové slovo data SERP"
    },
    "avg_backlinks_info": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_AvgBacklinksInfo"
        }
      ],
      "description": "<em>data o zpětných odkazech pro vrácené klíčové slovo</em><br>tento objekt poskytuje průměrný počet zpětných odkazů, odkazujících stránek a domén a také průměrné hodnoty pořadí mezi 10 nejlepšími webovými stránkami organicky se umisťujícími na klíčové slovo"
    },
    "search_intent_info": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_SearchIntentInfo"
        }
      ],
      "description": "<em>informace o záměru vyhledávání pro vrácené klíčové slovo</em><br>o záměru vyhledávání se dozvíte v tomto článku nápovědy"
    }
  }
}
```

### Response36Afe1097B20_KeywordInfo

`#/components/schemas/Response36Afe1097B20_KeywordInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>typ vyhledávače</em>"
    },
    "last_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>datum a čas aktualizace dat klíčového slova</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>"
    },
    "competition": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>konkurence</em><br>představuje relativní míru konkurence spojené s daným klíčovým slovem. Hodnota vychází z dat Google Ads a může být v rozmezí od 0 do 1 (včetně)"
    },
    "competition_level": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>úroveň konkurence</em><br>představuje relativní úroveň konkurence spojené s daným klíčovým slovem pouze v placeném SERP;<br>možné hodnoty: <code>LOW</code>, <code>MEDIUM</code>, <code>HIGH</code><br>pokud úroveň konkurence není známa, hodnota je <code>null</code>;<br>více o této metrice v tomto článku centra nápovědy"
    },
    "cpc": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>cena za kliknutí</em><br>představuje průměrnou cenu za kliknutí (USD), která byla historicky za klíčové slovo placena"
    },
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>průměrná měsíční míra objemu vyhledávání</em><br>představuje (přibližný) počet vyhledávání daného námětu klíčového slova na google.com",
      "format": "int64"
    },
    "low_top_of_page_bid": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>minimální nabídka, aby se reklama zobrazovala v horní části první stránky</em><br>udává hodnotu vyšší než přibližně 20 % nejnižších nabídek, při kterých se reklamy zobrazovaly (na základě statistik Google Ads pro inzerenty)<br>hodnota se může lišit v závislosti na lokalitě uvedené v požadavku POST"
    },
    "high_top_of_page_bid": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>maximální nabídka, aby se reklama zobrazovala v horní části první stránky</em><br>udává hodnotu vyšší než přibližně 80 % nejnižších nabídek, při kterých se reklamy zobrazovaly (na základě statistik Google Ads pro inzerenty)<br>hodnota se může lišit v závislosti na lokalitě uvedené v požadavku POST"
    },
    "categories": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "integer"
      },
      "description": "<em>kategorie produktů a služeb</em><br>úplný seznam možných kategorií si můžete stáhnout zde"
    },
    "monthly_searches": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo"
          }
        ]
      },
      "description": "<em>měsíční vyhledávání</em><br>představuje (přibližný) počet vyhledávání daného námětu klíčového slova (dostupný za posledních dvanáct měsíců) v zadaných zeměpisných lokalitách"
    },
    "search_volume_trend": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_SearchVolumeTrend"
        }
      ],
      "description": "<em>změny trendu objemu vyhledávání</em><br>představuje změnu objemu vyhledávání v procentech oproti předchozímu období"
    }
  }
}
```

### Response36Afe1097B20_KeywordInfoNormalizedWithInfo

`#/components/schemas/Response36Afe1097B20_KeywordInfoNormalizedWithInfo`

```json
{
  "type": "object",
  "properties": {
    "last_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "datum a čas aktualizace datové sady\nve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”\npříklad:\n2019-11-15 12:57:46 +00:00"
    },
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "aktuální hledanost klíčového slova"
    },
    "is_normalized": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "informace o klíčovém slově jsou normalizované\npokud je true, hodnoty jsou normalizovány daty Bing"
    },
    "monthly_searches": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo"
          }
        ]
      },
      "description": "míry měsíční hledanosti\npole objektů s mírami hledanosti v určitém měsíci roku"
    }
  }
}
```

### Response36Afe1097B20_KeywordProperties

`#/components/schemas/Response36Afe1097B20_KeywordProperties`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>typ vyhledávače</em>"
    },
    "core_keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>hlavní klíčové slovo ve skupině</em><br>obsahuje hlavní klíčové slovo ve skupině určené algoritmem shlukování synonym<br>pokud je hodnota <code>null</code>, naše databáze neobsahuje žádná klíčová slova, která by příslušný algoritmus mohl označit za synonymní s <code>keyword</code>"
    },
    "synonym_clustering_algorithm": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>algoritmus použitý k identifikaci synonym</em><br>možné hodnoty:<br><code>keyword_metrics</code> - označuje algoritmus založený na parametrech <code>keyword_info</code><br><code>text_processing</code> - označuje textový algoritmus<br>pokud je hodnota <code>null</code>, naše databáze neobsahuje žádná klíčová slova, která by příslušný algoritmus mohl označit za synonymní s <code>keyword</code>"
    },
    "keyword_difficulty": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>obtížnost umístění v první desítce organických výsledků pro klíčové slovo</em><br>udává šanci dostat se do top 10 organických výsledků pro klíčové slovo na logaritmické škále od 0 do 100;<br>počítá se mimo jiné analýzou odkazových profilů prvních 10 stránek v SERP;<br>více o této metrice v této příručce centra nápovědy"
    },
    "detected_language": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>zjištěný jazyk klíčového slova</em><br>udává jazyk klíčového slova rozpoznaný naším systémem"
    },
    "is_another_language": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "<em>zjištěný jazyk klíčového slova se liší od nastaveného jazyka</em><br>pokud je <code>true</code>, jazyk nastavený v požadavku neodpovídá jazyku, který pro dané klíčové slovo určil náš systém"
    },
    "words_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>počet slov v klíčovém slově</em><br>udává, z kolika slov se klíčové slovo skládá",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_MonthlySearchesInfo

`#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo`

```json
{
  "type": "object",
  "properties": {
    "year": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Rok."
    },
    "month": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Měsíc."
    },
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "průměrná měsíční hledanost"
    }
  }
}
```

### Response36Afe1097B20_SearchIntentInfo

`#/components/schemas/Response36Afe1097B20_SearchIntentInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>typ vyhledávače</em>"
    },
    "main_intent": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>hlavní záměr vyhledávání</em><br>možné hodnoty: <code>informational</code>, <code>navigational</code>, <code>commercial</code>, <code>transactional</code>"
    },
    "foreign_intent": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>doplňkové záměry vyhledávání</em><br>možné hodnoty: <code>informational</code>, <code>navigational</code>, <code>commercial</code>, <code>transactional</code>"
    },
    "last_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>datum a čas aktualizace dat klíčového slova</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>"
    }
  }
}
```

### Response36Afe1097B20_SearchVolumeTrend

`#/components/schemas/Response36Afe1097B20_SearchVolumeTrend`

```json
{
  "type": "object",
  "properties": {
    "monthly": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>změna objemu vyhledávání v procentech oproti předchozímu měsíci</em>"
    },
    "quarterly": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>změna objemu vyhledávání v procentech oproti předchozímu čtvrtletí</em>"
    },
    "yearly": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>změna objemu vyhledávání v procentech oproti předchozímu roku</em>"
    }
  }
}
```

### Response36Afe1097B20_SerpInfo

`#/components/schemas/Response36Afe1097B20_SerpInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>typ vyhledávače</em>"
    },
    "check_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>přímá adresa URL na výsledky vyhledávače</em><br>můžete ji použít k ověření, že jsme poskytli přesné výsledky"
    },
    "serp_item_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>typy výsledků vyhledávání v SERP</em><br>obsahuje typy výsledků vyhledávání (items) nalezených v SERP<br>možné typy položek:<br><code>answer_box</code>, <code>app</code>, <code>carousel</code>, <code>multi_carousel</code>, <code>featured_snippet</code>, <code>google_flights</code>, <code>google_reviews</code>, <code>third_party_reviews</code>, <code>google_posts</code>, <code>images</code>, <code>jobs</code>, <code>knowledge_graph</code>, <code>local_pack</code>, <code>hotels_pack</code>, <code>map</code>, <code>organic</code>, <code>paid</code>, <code>people_also_ask</code>, <code>related_searches</code>, <code>people_also_search</code>, <code>shopping</code>, <code>top_stories</code>, <code>twitter</code>, <code>video</code>, <code>events</code>, <code>mention_carousel</code>, <code>recipes</code>, <code>top_sights</code>, <code>scholarly_articles</code>, <code>popular_products</code>, <code>podcasts</code>, <code>questions_and_answers</code>, <code>find_results_on</code>, <code>stocks_box</code>, <code>visual_stories</code>, <code>commercial_units</code>, <code>local_services</code>, <code>google_hotels</code>, <code>math_solver</code>, <code>currency_box</code>, <code>product_considerations</code>, <code>found_on_web</code>, <code>short_videos</code>, <code>refine_products</code>, <code>explore_brands</code>, <code>perspectives</code>, <code>discussions_and_forums</code>, <code>compare_sites</code>, <code>courses</code>, <code>ai_overview</code>;<br><strong>poznámka</strong> skutečné výsledky budou vráceny pouze pro prvky <code>organic</code>, <code>paid</code>, <code>featured_snippet</code> a <code>local_pack</code>"
    },
    "se_results_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>počet výsledků vyhledávání pro vrácené klíčové slovo</em>",
      "format": "int64"
    },
    "last_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>datum a čas aktualizace dat klíčového slova</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>"
    },
    "previous_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>předchozí, před nejnovějším, datum a čas aktualizace dat SERP</em><br>ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”<br>příklad:<br><code class=\"long-string\">2019-10-15 12:57:46 +00:00</code>"
    }
  }
}
```
