# Získat výsledky vyhledávání aplikací Google podle ID

**API:** Data API

**Endpoint:** `GET /v1/beta/dataforseo/app_data/google/app_searches/task_get/advanced/{id}`

**Tags:** DataForSEO

Zpracovaný výsledek vyhledávání v Google Play zařazeného pomocí `post_dataforseo_app_google_app_searches_submit`. Vrací `keyword`, `se_domain`, `location_code`, `language_code`, `check_url`, `datetime`, `se_results_count`, `items_count` a `items`, přičemž každá položka nese `rank_group`, `rank_absolute`, `position`, `app_id`, `title`, `url`, `icon`, `reviews_count`, `rating`, `is_free` a `price`. Zabalené v obálce DataForSEO: data v `tasks[0].result`, výsledek v `tasks[0].status_code` – odmítnutý požadavek stále vrací HTTP 200. Předajte `app_id` odsud do `post_dataforseo_app_google_app_info_submit`.

### Cenová reference

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

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

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

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

`#/components/schemas/Response36Afe1097B20_AppDataGoogleAppSearchesTaskGetAdvancedResponseInfo`

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

### Response36Afe1097B20_AppDataGoogleAppSearchesTaskGetAdvancedResultInfo

`#/components/schemas/Response36Afe1097B20_AppDataGoogleAppSearchesTaskGetAdvancedResultInfo`

```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>klíčové slovo přijaté v požadavku POST</em>"
    },
    "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>"
    },
    "se_results_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>celkový počet výsledků</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>počet položek v poli výsledků</em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_GooglePlaySearchOrganic"
          }
        ]
      },
      "description": "<em>nalezené aplikace</em>"
    }
  }
}
```

### Response36Afe1097B20_AppDataGoogleAppSearchesTaskGetAdvancedTaskInfo

`#/components/schemas/Response36Afe1097B20_AppDataGoogleAppSearchesTaskGetAdvancedTaskInfo`

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

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

`#/components/schemas/Response36Afe1097B20_GooglePlaySearchOrganic`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "typ prvku"
    },
    "rank_group": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>pozice ve skupině prvků se shodnými hodnotami <code>type</code></em><br>pozice prvků s odlišný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"
    },
    "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>"
    },
    "app_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>id aplikace v poli POST</em>"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>název aplikace</em>"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL stránky aplikace v Google Play</em>"
    },
    "icon": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL ikony aplikace</em>"
    },
    "reviews_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>celkový počet recenzí aplikace</em>",
      "format": "int64"
    },
    "rating": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo"
        }
      ],
      "description": "<em>průměrné hodnocení aplikace</em>"
    },
    "is_free": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "price": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_PriceInfo"
        }
      ]
    },
    "developer": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>název vývojáře aplikace</em>"
    },
    "developer_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL stránky vývojáře v Google Play</em>"
    }
  }
}
```

### Response36Afe1097B20_PriceInfo

`#/components/schemas/Response36Afe1097B20_PriceInfo`

```json
{
  "type": "object",
  "properties": {
    "current": {
      "type": [
        "number",
        "null"
      ],
      "description": "aktuální cena\nudává aktuální cenu produktu nebo služby uvedené ve výsledku",
      "format": "double"
    },
    "regular": {
      "type": [
        "number",
        "null"
      ],
      "description": "běžná cena\nudává běžnou cenu produktu nebo služby bez uplatněných slev",
      "format": "double"
    },
    "max_value": {
      "type": [
        "number",
        "null"
      ],
      "description": "maximální cena\nmaximální cena produktu nebo služby uvedená ve výsledku",
      "format": "double"
    },
    "currency": {
      "type": [
        "string",
        "null"
      ],
      "description": "měna uvedené ceny\nkód ISO měny použité na cenu"
    },
    "is_price_range": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "cena je uvedena jako rozsah\nudává, zda je cena uvedena jako rozsah"
    },
    "displayed_price": {
      "type": [
        "string",
        "null"
      ],
      "description": "řetězec ceny ve výsledku\nsurový řetězec ceny tak, jak je uveden ve výsledku"
    }
  }
}
```

### Response36Afe1097B20_RatingInfo

`#/components/schemas/Response36Afe1097B20_RatingInfo`

```json
{
  "properties": {
    "rating_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "typ hodnocení\nzde najdete následující prvky: Max5, Percents, CustomMax"
    },
    "value": {
      "type": [
        "number",
        "null"
      ],
      "description": "hodnota hodnocení",
      "format": "double"
    },
    "votes_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "množství zpětné vazby",
      "format": "int64"
    },
    "rating_max": {
      "type": [
        "integer",
        "null"
      ],
      "description": "maximální hodnota pro rating_type"
    }
  }
}
```
