# Obtenir les résultats avancés de SERP organique Bing par id（advanced）

**API:** Data API

**Endpoint:** `GET /v1/beta/dataforseo/serp/bing/organic/task_get/advanced/{id}`

**Tags:** DataForSEO

Récupère un résultat organique Bing en file d'attente par `id`. Renvoie `keyword`, `type`, `se_domain`, `location_code`, `language_code`, `check_url`, `datetime`, `spell`, `refinement_chips`, `item_types`, `items_count` et `items`. 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éférence tarifaire

- Mesure : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.02.
- 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

- [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>identifiant de la tâche</em><br><strong>identifiant unique de la tâche dans notre système au format UUID</strong><br>vous pourrez l'utiliser pendant <strong>30 jours</strong> pour demander les résultats de la tâche à tout moment |

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

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

`#/components/schemas/Response36Afe1097B20_AiModeRectangleInfo`

```json
{
  "type": "object",
  "properties": {
    "x": {
      "type": [
        "number",
        "null"
      ],
      "description": "coordonnée de l'axe x\ncoordonnée de l'axe x du coin supérieur gauche de l'extrait du résultat, le coin supérieur gauche de l'écran étant l'origine",
      "format": "double"
    },
    "y": {
      "type": [
        "number",
        "null"
      ],
      "description": "coordonnée de l'axe y\ncoordonnée de l'axe y du coin supérieur gauche de l'extrait du résultat, le coin supérieur gauche de l'écran étant l'origine",
      "format": "double"
    },
    "width": {
      "type": [
        "number",
        "null"
      ],
      "description": "largeur de l'élément en pixels",
      "format": "double"
    },
    "height": {
      "type": [
        "number",
        "null"
      ],
      "description": "hauteur de l'élément en pixels",
      "format": "double"
    }
  }
}
```

### Response36Afe1097B20_AmazonLabelElement

`#/components/schemas/Response36Afe1097B20_AmazonLabelElement`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "type d'élément"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "titre de l'élément"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL de recherche avec paramètres d'affinage"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "domaine dans la SERP"
    }
  }
}
```

### Response36Afe1097B20_BaseBingSerpApiElementItem

`#/components/schemas/Response36Afe1097B20_BaseBingSerpApiElementItem`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "type d'élément"
    },
    "rank_group": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>rang de groupe dans les SERP</em><br>position au sein d'un groupe d'éléments ayant des valeurs <code>type</code> identiques<br>les positions des éléments ayant des valeurs <code>type</code> différentes sont omises de <code>rank_group</code>"
    },
    "rank_absolute": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em> rang absolu dans la SERP</em><br>position absolue parmi tous les éléments de la SERP"
    },
    "page": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>numéro de page de résultats de recherche</em><br>indique le numéro de la page SERP sur laquelle se trouve l'élément"
    },
    "position": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>l'alignement de l'élément dans la SERP</em><br>            peut prendre les valeurs suivantes :<br>            <code>left</code>, <code>right</code>"
    },
    "xpath": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>le XPath de l'élément</em>"
    },
    "rectangle": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_AiModeRectangleInfo"
        }
      ],
      "description": "<em>paramètres du rectangle</em><br>            contient les coordonnées cartésiennes et les dimensions en pixels de l'extrait du résultat dans la SERP<br>            vaut <code>null</code> si <code>calculate_rectangles</code> dans la requête POST n'est pas défini sur <code>true</code>"
    }
  },
  "additionalProperties": false,
  "discriminator": {
    "propertyName": "type",
    "mapping": {
      "organic": "#/components/schemas/Response36Afe1097B20_BingOrganicSerpElementItem",
      "paid": "#/components/schemas/Response36Afe1097B20_BingPaidSerpElementItem",
      "featured_snippet": "#/components/schemas/Response36Afe1097B20_BingFeaturedSnippetSerpElementItem",
      "related_searches": "#/components/schemas/Response36Afe1097B20_BingRelatedSearchesSerpElementItem",
      "ai_overview": "#/components/schemas/Response36Afe1097B20_BingAiOverviewSerpElementItem",
      "images": "#/components/schemas/Response36Afe1097B20_BingImagesSerpElementItem",
      "video": "#/components/schemas/Response36Afe1097B20_BingVideoSerpElementItem",
      "shopping": "#/components/schemas/Response36Afe1097B20_BingShoppingSerpElementItem",
      "answer_box": "#/components/schemas/Response36Afe1097B20_BingAnswerBoxSerpElementItem",
      "local_pack": "#/components/schemas/Response36Afe1097B20_BingLocalPackSerpElementItem",
      "questions_and_answers": "#/components/schemas/Response36Afe1097B20_BingQuestionsAndAnswersSerpElementItem",
      "hotels_pack": "#/components/schemas/Response36Afe1097B20_BingHotelsPackSerpElementItem",
      "jobs": "#/components/schemas/Response36Afe1097B20_BingJobsSerpElementItem",
      "top_stories": "#/components/schemas/Response36Afe1097B20_BingTopStoriesSerpElementItem",
      "carousel": "#/components/schemas/Response36Afe1097B20_BingCarouselSerpElementItem",
      "map": "#/components/schemas/Response36Afe1097B20_BingMapSerpElementItem",
      "events": "#/components/schemas/Response36Afe1097B20_BingEventsSerpElementItem",
      "recipes": "#/components/schemas/Response36Afe1097B20_BingRecipesSerpElementItem",
      "people_also_ask": "#/components/schemas/Response36Afe1097B20_BingPeopleAlsoAskSerpElementItem",
      "people_also_search": "#/components/schemas/Response36Afe1097B20_BingPeopleAlsoSearchSerpElementItem"
    }
  }
}
```

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

`#/components/schemas/Response36Afe1097B20_RefinementChipsElement`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "type d'élément"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "titre de l'élément"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL de recherche avec paramètres d'affinage"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "domaine dans la SERP"
    },
    "options": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_AmazonLabelElement"
          }
        ]
      },
      "description": "autres options d'affinage de la recherche"
    }
  }
}
```

### Response36Afe1097B20_RefinementChipsInfo

`#/components/schemas/Response36Afe1097B20_RefinementChipsInfo`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "type d'élément"
    },
    "xpath": {
      "type": [
        "string",
        "null"
      ],
      "description": "le XPath de l'élément"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsElement"
          }
        ]
      },
      "description": "items de l'élément"
    }
  }
}
```

### Response36Afe1097B20_SerpBingOrganicTaskGetAdvancedResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpBingOrganicTaskGetAdvancedResponseInfo`

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

### Response36Afe1097B20_SerpBingOrganicTaskGetAdvancedResultInfo

`#/components/schemas/Response36Afe1097B20_SerpBingOrganicTaskGetAdvancedResultInfo`

```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>mot-clé reçu dans un tableau POST<br>        </em><strong>le mot-clé est renvoyé avec %## décodé (le symbole '+' sera décodé en espace)</strong>"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "type d'élément"
    },
    "se_domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>domaine du moteur de recherche dans un tableau POST</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>"
    },
    "check_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL directe vers les résultats du moteur de recherche</em><br>            vous pouvez l'utiliser pour vérifier que nous fournissons des résultats précis"
    },
    "datetime": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>date et heure de réception du résultat</em><br>            au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”<br>            exemple :<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>autocorrection du moteur de recherche</em><br>            si le moteur de recherche a fourni des résultats pour un mot-clé corrigé, nous précisons le mot-clé corrigé par le moteur de recherche ainsi que le type d'autocorrection"
    },
    "refinement_chips": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsInfo"
        }
      ],
      "description": "<em>puces de raffinement de recherche</em><br>            vaut <code>null</code>"
    },
    "item_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>types de résultats de recherche dans la SERP</em><br>            contient les types de résultats de recherche (<code>items</code>) trouvés dans la SERP.<br>            types d'éléments possibles :<br>            <span>answer_box, carousel, events, featured_snippet, hotels_pack, images, jobs, local_pack, map, organic, paid, people_also_ask, people_also_search, questions_and_answers,recipes, related_searches, shopping, top_stories, video</span>, ai_overview</span>"
    },
    "se_results_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em> nombre total de résultats dans la SERP</em>",
      "format": "int64"
    },
    "pages_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre total de pages récupérées</em><br>            nombre total de SERP récupérées dans le résultat",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>le nombre de résultats renvoyés dans le tableau <strong><code>items</code></strong></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_BaseBingSerpApiElementItem"
          }
        ]
      },
      "description": "<em>éléments supplémentaires présents dans l'élément</em><br>            s'il n'y en a aucun, la valeur est <code>null</code>"
    }
  }
}
```

### Response36Afe1097B20_SerpBingOrganicTaskGetAdvancedTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpBingOrganicTaskGetAdvancedTaskInfo`

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

### Response36Afe1097B20_SpellInfo

`#/components/schemas/Response36Afe1097B20_SpellInfo`

```json
{
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "mot-clé obtenu à la suite de l'autocorrection du moteur de recherche\n les résultats seront fournis pour le mot-clé corrigé"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "type d'autocorrection\n valeurs possibles :\n did_you_mean, showing_results_for, no_results_found_for, including_results_for\n remarque : Yahoo et Yandex ne prennent en charge que le type d'autocorrection suivant :\n including_results_for"
    }
  }
}
```
