# Métriques d'apps en lot Google Play en direct

**API:** Data API

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

**Tags:** DataForSEO

Notes, avis et estimations d'installations pour de nombreuses apps Google Play en un seul appel. Ce point de terminaison n'accepte pas de paramètre de limite, mais il est facturé par appel et non par élément : envoyez donc toute la liste d'un coup. Enveloppé dans l'enveloppe DataForSEO : les données dans `tasks[0].result`, l'issue dans `tasks[0].status_code` — une requête rejetée renvoie tout de même HTTP 200. Le prix est par appel : c'est ainsi que l'on trie une liste d'apps avant de dépenser des appels par app. Équivalent Apple : `post_dataforseo_labs_apple_bulk_app_metrics_live`.

### Référence tarifaire

- Facturation : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.1356.
- Multiplicateur de référence client : 1.0. Ne pas l'appliquer une seconde fois à un montant client déjà réglé.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation 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": {
          "app_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "<em>ids de l'application</em><br><strong>champ obligatoire</strong><br>IDs des applications mobiles sur Google Play ;<br>vous pouvez trouver l'ID dans l'URL de chaque application listée sur Google Play ;<br>exemple :<br>dans l'URL <code>https://play.google.com/store/apps/details?id=org.telegram.messenger</code><br>l'id est <code>org.telegram.messenger</code> ;<br>le nombre maximal d'IDs que vous pouvez indiquer dans ce champ est <code>1000</code>"
          },
          "location_name": {
            "type": "string",
            "description": "<em>nom complet de l'emplacement</em><br><strong>champ obligatoire si vous n'indiquez pas</strong> <code>location_code</code><br><strong>Remarque :</strong> il est obligatoire de spécifier <code>location_name</code> ou <code>location_code</code><br>vous pouvez obtenir la liste des emplacements disponibles avec leur <code>location_name</code> en effectuant une requête distincte vers <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code> ;<br><strong>Remarque :</strong> ce point de terminaison ne prend actuellement en charge que l'emplacement des États-Unis ;<br>exemple :<br><code class=\"long-string\">United States</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>code d'emplacement</em><br><strong>champ obligatoire si vous n'indiquez pas</strong> <code>location_name</code><br><strong>Remarque :</strong> il est obligatoire de spécifier <code>location_name</code> ou <code>location_code</code><br>vous pouvez obtenir la liste des emplacements disponibles avec leur <code>location_code</code> en effectuant une requête distincte vers <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code> ;<br><strong>Remarque :</strong> ce point de terminaison ne prend actuellement en charge que l'emplacement des États-Unis ;<br>exemple :<br><code class=\"long-string\">2840</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>nom complet de la langue</em><br><strong>champ obligatoire si vous n'indiquez pas</strong> <code>language_code</code><br><strong>Remarque :</strong> il est obligatoire de spécifier <code>language_name</code> ou <code>language_code</code><br>vous pouvez obtenir la liste des langues disponibles avec leur <code>language_name</code> en effectuant une requête distincte vers <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code> ;<br><strong>Remarque :</strong> ce point de terminaison ne prend actuellement en charge que la langue anglaise ;<br>exemple :<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>code de langue</em><br><strong>champ obligatoire si vous n'indiquez pas</strong> <code>language_name</code><br><strong>Remarque :</strong> il est obligatoire de spécifier <code>language_name</code> ou <code>language_code</code><br>vous pouvez obtenir la liste des langues disponibles avec leur <code>language_code</code> en effectuant une requête distincte vers <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code> ;<br><strong>Remarque :</strong> ce point de terminaison ne prend actuellement en charge que la langue anglaise<br>exemple :<br><code class=\"long-string\">en</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>identifiant de tâche défini par l'utilisateur</em><br>champ facultatif<br><em>la limite est de 255 caractères</em><br>vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat<br>vous trouverez la valeur <code>tag</code> spécifiée dans l'objet <code>data</code> de la réponse"
          }
        },
        "example": [
          {
            "app_ids": [
              "org.telegram.messenger",
              "com.zhiliaoapp.musically"
            ],
            "language_name": "English",
            "location_code": 2840
          }
        ]
      }
    ]
  },
  "example": [
    {
      "app_ids": [
        "org.telegram.messenger",
        "com.zhiliaoapp.musically"
      ],
      "language_name": "English",
      "location_code": 2840
    }
  ]
}
```

## Responses

### 200 — Opération réussie

Headers:
- `X-Request-Id` (string) — Identifiant de requête à inclure lorsque vous contactez le support Felo.

**application/json**

Schema: object | null

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

### 400 — La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.

### 401 — Une clé API Felo valide est requise.

### 402 — La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.

### 403 — Le compte n'est pas autorisé à effectuer cette opération.

### 429 — Une limite de requêtes ou de dépenses a été atteinte.

### 502 — Le service n'a pas pu terminer la requête.

### 503 — L'API ou le service de facturation est temporairement indisponible.

### 504 — Le service a expiré lors du traitement de la requête.

### default — Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_AppMetricsInfo

`#/components/schemas/Response36Afe1097B20_AppMetricsInfo`

```json
{
  "type": "object",
  "properties": {
    "pos_1": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre de SERP organiques où le produit occupe la position #1</em>"
    },
    "pos_2_3": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre de SERP organiques où le produit occupe les positions #2-3</em>"
    },
    "pos_4_10": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre de SERP organiques où le produit occupe les positions #4-10</em>"
    },
    "pos_11_100": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre de SERP organiques où le produit occupe les positions #11-100</em>"
    },
    "count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre total de SERP organiques Amazon contenant le produit</em>",
      "format": "int64"
    },
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>volume de recherche total des mots-clés de classement du produit dans la SERP organique</em>",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "la version actuelle de l'API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "code d'état général\nvous pouvez trouver la liste complète des codes de réponse ici"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "message d'information général\nvous pouvez trouver la liste complète des messages d'information généraux ici"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "temps d'exécution total, en secondes"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "coût total des tâches, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "le nombre de tâches dans le tableau de tâches",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "le nombre de tâches dans le tableau de tâches renvoyées avec une erreur",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "identifiant de la tâche\nidentifiant unique de la tâche dans notre système au format UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "code d'état de la tâche\ngénéré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000\nvous pouvez trouver la liste complète des codes de réponse ici"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "message d'information de la tâche\nvous pouvez trouver la liste complète des messages d'information généraux ici"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "temps d'exécution, en secondes"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "coût total des tâches, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "nombre d'éléments dans le tableau de résultats",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "chemin de l'URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "contient les mêmes paramètres que ceux spécifiés dans la requête POST"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveResponseInfo`

```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_DataforseoLabsGoogleBulkAppMetricsLiveTaskInfo"
              }
            ]
          },
          "description": "<em>tableau de tâches</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveResultInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>type de moteur de recherche</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>code de localisation dans un tableau POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>code de langue dans un tableau POST</em>"
    },
    "total_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>quantité totale de résultats de notre base de données correspondant à votre requête</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>le nombre de résultats renvoyés dans le tableau <code>items</code></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsleBulkAppMetricsLiveItem"
          }
        ]
      },
      "description": "<em>contient les données associées aux métriques de classement de l'application spécifiée"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkAppMetricsLiveTaskInfo`

```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_DataforseoLabsGoogleBulkAppMetricsLiveResultInfo"
              }
            ]
          },
          "description": "<em>tableau de résultats</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_DataforseoLabsleBulkAppMetricsLiveItem

`#/components/schemas/Response36Afe1097B20_DataforseoLabsleBulkAppMetricsLiveItem`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>type de moteur de recherche</em>"
    },
    "app_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>id de l'app dans un tableau POST</em>"
    },
    "metrics": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "$ref": "#/components/schemas/Response36Afe1097B20_AppMetricsInfo"
      },
      "description": "<em>métriques des mots-clés de classement de l'application</em><br>données de classement relatives aux mots-clés pour lesquels l'application fournie est classée sur Google Play"
    }
  }
}
```
