# Načtení pokročilých výsledků SERP vyhledávání obrázků Google podle id

**API:** Data API

**Endpoint:** `GET /v1/beta/dataforseo/serp/google/search_by_image/task_get/advanced/{id}`

**Tags:** DataForSEO

Načte zařazený výsledek vyhledávání obrázků Google podle `id`. Vrací `keyword`, `type`, `se_domain`, `location_code`, `language_code`, `check_url`, `datetime`, `spell`, `refinement_chips`, `item_types`, `items_count` a `items`. 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.

## Related links

- [UUID](<https://en.wikipedia.org/wiki/Universally_unique_identifier>)
- [XPath](<https://en.wikipedia.org/wiki/XPath>)

## Base URL

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

## Authentication

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

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `id` | path | yes | string | <em>identifikátor úlohy</em><br><strong>jedinečný identifikátor úlohy v našem systému ve formátu UUID</strong><br>můžete jej po dobu <strong>30 dní</strong> kdykoli použít k vyžádání výsledků úlohy |

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

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

`#/components/schemas/Response36Afe1097B20_AiModeRectangleInfo`

```json
{
  "type": "object",
  "properties": {
    "x": {
      "type": [
        "number",
        "null"
      ],
      "description": "souřadnice osy x\nsouřadnice osy x levého horního rohu úryvku výsledku, přičemž počátkem je levý horní roh obrazovky",
      "format": "double"
    },
    "y": {
      "type": [
        "number",
        "null"
      ],
      "description": "souřadnice osy y\nsouřadnice osy y levého horního rohu úryvku výsledku, přičemž počátkem je levý horní roh obrazovky",
      "format": "double"
    },
    "width": {
      "type": [
        "number",
        "null"
      ],
      "description": "šířka prvku v pixelech",
      "format": "double"
    },
    "height": {
      "type": [
        "number",
        "null"
      ],
      "description": "výška prvku v pixelech",
      "format": "double"
    }
  }
}
```

### Response36Afe1097B20_AmazonLabelElement

`#/components/schemas/Response36Afe1097B20_AmazonLabelElement`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "typ prvku"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "název prvku"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL vyhledávání s parametry upřesnění"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "doména v SERP"
    }
  }
}
```

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

`#/components/schemas/Response36Afe1097B20_BaseSerpApiGoogleSearchByImagesElementItem`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "typ prvku"
    },
    "rank_group": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>pořadí skupiny v SERP</em><br>            pozice ve skupině prvků se shodnými hodnotami <code>type</code><br>            pozice prvků s jinými hodnotami <code>type</code> se v <code>rank_group</code> vynechávají"
    },
    "rank_absolute": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>absolutní pořadí v SERP</em><br>            absolutní pozice mezi všemi prvky v SERP"
    },
    "page": {
      "type": [
        "integer",
        "null"
      ]
    },
    "position": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>zarovnání prvku v SERP</em><br>            může nabývat následujících hodnot:<br>            <code>left</code>, <code>right</code>"
    },
    "xpath": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>XPath prvku</em>"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>název prvku</em>"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL vyhledávání s parametry upřesnění</em>"
    },
    "rectangle": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_AiModeRectangleInfo"
        }
      ],
      "description": "<em>parametry obdélníku</em><br>            obsahuje kartézské souřadnice a rozměry v pixelech výňatku výsledku v SERP<br>            rovná se <code>null</code>, pokud <code>calculate_rectangles</code> v požadavku POST není nastaveno na <code>true</code>"
    }
  },
  "additionalProperties": false,
  "discriminator": {
    "propertyName": "type",
    "mapping": {
      "organic": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleSearchByImagesOrganicElementItem",
      "images": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleSearchByImagesImagesElementItem"
    }
  }
}
```

### Response36Afe1097B20_RefinementChipsElement

`#/components/schemas/Response36Afe1097B20_RefinementChipsElement`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "typ prvku"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "název prvku"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL vyhledávání s parametry upřesnění"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "doména v SERP"
    },
    "options": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_AmazonLabelElement"
          }
        ]
      },
      "description": "další možnosti upřesnění vyhledávání"
    }
  }
}
```

### Response36Afe1097B20_RefinementChipsInfo

`#/components/schemas/Response36Afe1097B20_RefinementChipsInfo`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "typ prvku"
    },
    "xpath": {
      "type": [
        "string",
        "null"
      ],
      "description": "XPath prvku"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsElement"
          }
        ]
      },
      "description": "položky prvku"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleSearchByImageTaskGetAdvancedResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleSearchByImageTaskGetAdvancedResponseInfo`

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

### Response36Afe1097B20_SerpGoogleSearchByImageTaskGetAdvancedResultInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleSearchByImageTaskGetAdvancedResultInfo`

```json
{
  "type": "object",
  "properties": {
    "image_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>adresa URL zadaná v poli POST</em>"
    },
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>klíčové slovo, které Google přiřadil k zadanému obrázku</em>"
    },
    "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>"
    },
    "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"
    },
    "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>"
    },
    "spell": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_SpellInfo"
        }
      ],
      "description": "<em>automatická oprava vyhledávače</em><br>            pokud vyhledávač poskytl výsledky pro opravené klíčové slovo, uvedeme klíčové slovo opravené vyhledávačem a typ automatické opravy"
    },
    "refinement_chips": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsInfo"
        }
      ],
      "description": "<em>čipy pro upřesnění vyhledávání</em><br>"
    },
    "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í (<code>items</code>) nalezených v SERP.<br>            možné typy položek:<br>            <code>organic</code>,<br>            <code>images</code>"
    },
    "se_results_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em> celkový počet výsledků v SERP</em>",
      "format": "int64"
    },
    "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_BaseSerpApiGoogleSearchByImagesElementItem"
          }
        ]
      },
      "description": "<em>položky obsažené v faq_box</em>"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleSearchByImageTaskGetAdvancedTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleSearchByImageTaskGetAdvancedTaskInfo`

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

### Response36Afe1097B20_SpellInfo

`#/components/schemas/Response36Afe1097B20_SpellInfo`

```json
{
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "klíčové slovo získané v důsledku automatické opravy vyhledávače\n výsledky budou poskytnuty pro opravené klíčové slovo"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "typ automatické opravy\n možné hodnoty:\n did_you_mean, showing_results_for, no_results_found_for, including_results_for\n poznámka: Yahoo a Yandex podporují pouze následující typ automatické opravy:\n including_results_for"
    }
  }
}
```
