# Configurer les tâches ‘Search Volume’

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/keywords_data/bing/search_volume/task_post`

**Tags:** DataForSEO

Met une tâche de volume de recherche Bing en file d'attente et renvoie un `id` de tâche. 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. Récupérez avec `get_dataforseo_keywords_bing_search_volume_fetch`.

### Référence tarifaire

- Mesure : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.06.
- Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à 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.

## Related links

- [article du centre d'aide](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)
- [point de terminaison Status](<https://docs.dataforseo.com/v3/keywords_data/bing/status/>)
- [centre d'aide](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-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": {
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "<em>mots-clés</em><br><strong>champ obligatoire</strong><br>Le nombre maximal de mots-clés que vous pouvez indiquer : 1000<br>Le nombre maximal de caractères pour chaque mot-clé : 100<br>les mots-clés indiqués sont convertis en minuscules et les données sont fournies dans un tableau distinct<p>en savoir plus sur les règles et limites des champs <code>keyword</code> et <code>keywords</code> dans les API DataForSEO dans cet article du centre d'aide"
          },
          "location_name": {
            "type": "string",
            "description": "<em>nom complet de l'emplacement du moteur de recherche</em><br><strong>champ obligatoire si vous ne spécifiez pas</strong> <code>location_code</code> ou <code>location_coordinate</code><br><strong>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>location_code</code> ou <code>location_coordinate</code></strong><br>vous pouvez recevoir la liste des emplacements disponibles du moteur de recherche avec leur <code>location_name</code> en effectuant une requête distincte vers <code>https://api.dataforseo.com/v3/keywords_data/bing/locations</code><br>exemple :<br><code class=\"long-string\">London,England,United Kingdom</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>code d'emplacement du moteur de recherche</em><br><strong>champ obligatoire si vous ne spécifiez pas</strong> <code>location_name</code> ou <code>location_coordinate</code><br><strong>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>location_name</code> ou <code>location_coordinate</code></strong><br>vous pouvez recevoir la liste des emplacements disponibles des moteurs de recherche avec leur <code>location_code</code> en effectuant une requête distincte vers <code>https://api.dataforseo.com/v3/keywords_data/bing/locations</code><br>exemple :<br><code class=\"long-string\">2840</code>"
          },
          "location_coordinate": {
            "type": "string",
            "description": "<em>coordonnées GPS d'un emplacement</em><br><strong>champ obligatoire si vous ne spécifiez pas</strong> <code>location_name</code> ou <code>location_code</code><br><strong>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>location_name</code> ou <code>location_code</code></strong><br>le paramètre <code>location_coordinate</code> doit être indiqué au format <em>\"latitude,longitude\"</em><br><strong>les données sont fournies pour le pays auquel appartiennent les coordonnées indiquées</strong><br>exemple :<br><code class=\"long-string\">52.6178549,-155.352142</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>nom complet de la langue du moteur de recherche</em><br><strong>champ obligatoire si vous ne spécifiez pas</strong> <code>language_code</code><br>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>language_code</code><br>langues prises en charge :<br><code>English</code>, <code>French</code>, <code>German</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>code de langue du moteur de recherche</em><br><strong>champ obligatoire si vous ne spécifiez pas</strong> <code>language_name</code><br>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>language_name</code><br>langues prises en charge :<br><code class=\"long-string\">en</code>, <code>fr</code>, <code>de</code>"
          },
          "device": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>type d'appareil</em><br>champ facultatif<br>indiquez ce champ pour obtenir les données d'un type d'appareil particulier ; valeurs possibles : <code>all</code>, <code>mobile</code>, <code>desktop</code>, <code>tablet</code><br>valeur par défaut : <code>all</code>"
          },
          "sort_by": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>paramètres de tri des résultats</em><br>champ facultatif<br>utilisez ces paramètres pour trier les résultats par <code>search_volume</code>, <code>cpc</code>, <code>competition</code> ou <code>relevance</code> par ordre décroissant<br>valeur par défaut : <code>relevance</code>"
          },
          "date_from": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>date de début de l'intervalle de temps</em><br>champ facultatif<br>si vous n'indiquez pas ce champ, les données sont fournies pour les 12 derniers mois<br>valeur minimale : 24 mois à compter de la date du jour<br>si le point de terminaison Status renvoie <code>false</code> dans le champ <code>actual_data</code>, <code>date_from</code> peut être défini sur l'avant-dernier mois et les mois précédents ;<br>si le point de terminaison Status renvoie <code>true</code> dans le champ <code>actual_data</code>, <code>date_from</code> peut être défini sur le dernier mois et les mois précédents ;<br>format de date : <code>\"yyyy-mm-dd\"</code><br>exemple :<br><code>\"2020-01-01\"</code><p><strong>Remarque :</strong> nous ne recommandons pas d'utiliser un intervalle de temps personnalisé pour les dates de l'année écoulée"
          },
          "date_to": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>date de fin de l'intervalle de temps</em><br>champ facultatif<br>si vous n'indiquez pas ce champ, les données sont fournies pour les 12 derniers mois ;<br>valeur minimale : deux ans en arrière à compter de la date du jour ;<br>valeur maximale : un mois à compter de la date du jour ;<br><strong>remarque :</strong> nous ne recommandons pas d'utiliser un intervalle de temps personnalisé pour les dates de l'année écoulée ;<br>format de date : <code>\"yyyy-mm-dd\"</code><br>exemple :<br><code>\"2020-03-15\"</code><p><strong>Remarque :</strong> nous ne recommandons pas d'utiliser un intervalle de temps personnalisé pour les dates de l'année écoulée"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL d'envoi des résultats de la tâche</em><br>champ facultatif<br>une fois la tâche terminée, nous enverrons une requête POST avec ses résultats compressés au format <code>gzip</code> à l'adresse <code>postback_url</code> que vous avez spécifiée<br>vous pouvez utiliser la chaîne ‘$id’ comme variable <code>$id</code> et ‘$tag’ comme variable <code>$tag</code> encodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.<br>exemple :<br><code>http://your-server.com/postbackscript?id=$id</code><br><code>http://your-server.com/postbackscript?id=$id&amp;tag=$tag</code><br><strong>Remarque :</strong> les caractères spéciaux de <code>postback_url</code> seront encodés pour URL ;<br>notamment, le caractère <code>#</code> sera encodé en <code>%23</code><p>en savoir plus dans notre centre d'aide"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL de notification d'une tâche terminée</em><br>champ facultatif<br>lorsqu'une tâche est terminée, nous vous en informons par une requête GET envoyée à l'URL que vous avez spécifiée<br>vous pouvez utiliser la chaîne ‘$id’ comme variable <code>$id</code> et ‘$tag’ comme variable <code>$tag</code> encodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête<br>exemple :<br><code>http://your-server.com/pingscript?id=$id</code><br><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><br><strong>Remarque :</strong> les caractères spéciaux de <code>pingback_url</code> seront encodés pour URL ;<br>notamment, le caractère <code>#</code> sera encodé en <code>%23</code><p>en savoir plus dans notre centre d'aide"
          },
          "search_partners": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>type de partenaires de recherche Bing</em><br>champ facultatif<br>si vous indiquez <code class=\"prettyprint\">true</code>, les résultats sont fournis pour les réseaux détenus, exploités et syndiqués de Bing, Yahoo, AOL et des sites partenaires qui hébergent les recherches Bing, AOL et Yahoo.<br>valeur par défaut : <code>false</code> - les résultats sont renvoyés pour les réseaux de recherche Bing, AOL et Yahoo"
          },
          "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": [
          {
            "location_name": "United States",
            "language_name": "English",
            "keywords": [
              "average page rpm adsense",
              "adsense blank ads how long",
              "leads and prospects"
            ]
          }
        ]
      }
    ]
  },
  "example": [
    {
      "location_name": "United States",
      "language_name": "English",
      "keywords": [
        "average page rpm adsense",
        "adsense blank ads how long",
        "leads and prospects"
      ]
    }
  ]
}
```

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

### 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_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_KeywordsDataBingSearchVolumeTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_KeywordsDataBingSearchVolumeTaskPostResponseInfo`

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

### Response36Afe1097B20_KeywordsDataBingSearchVolumeTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_KeywordsDataBingSearchVolumeTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>tableau de résultats</em><br>dans ce cas, la valeur sera <code>null</code>"
        }
      }
    }
  ]
}
```
