# Configurer les tâches SERP Google Local Finder

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/serp/google/local_finder/task_post`

**Tags:** DataForSEO

Met en file d'attente les résultats locaux étendus que Google affiche lorsqu'une requête est manifestement locale, et renvoie un `id` de tâche dans `tasks[0].id`. 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 jumeau en direct répond immédiatement et reste plus simple pour une requête unique ; mettez en file d'attente lorsque le lot dépasserait un appel d'outil.

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

- [article du centre d'aide](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)
- [Pricing](<https://dataforseo.com/pricing/serp/google-local-finder-serp-api>)
- [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": {
          "keyword": {
            "type": "string",
            "description": "<p><em>mot-clé</em><p><strong>champ obligatoire</strong><p>vous pouvez indiquer <strong>jusqu'à 700 caractères</strong> dans le champ <code>keyword</code><p>tous les %## seront décodés (le caractère ‘+’ sera décodé en espace)<p>si vous devez utiliser le caractère “%” dans votre <code>keyword</code>, spécifiez-le comme “%25” ;<p>si vous devez utiliser le caractère “+” dans votre <code>keyword</code>, spécifiez-le comme “%2B”</p><br><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</p>"
          },
          "location_code": {
            "type": "integer",
            "description": "<p><em>code d'emplacement du moteur de recherche</em><p><strong>champ obligatoire si vous ne spécifiez pas</strong> <code>location_name</code>&nbsp;ou <code>location_coordinate</code><p><strong>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>location_name</code> ou <code>location_coordinate</code></strong><p>vous pouvez obtenir la liste des emplacements disponibles des moteurs de recherche avec leur <code>location_code</code> en effectuant une requête distincte sur <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations</code><p>exemple :<p><code class=\"long-string\">2840</code></p>"
          },
          "language_code": {
            "type": "string",
            "description": "<p><em>code de langue du moteur de recherche</em><p><strong>champ obligatoire si vous ne spécifiez pas</strong> <code>language_name</code><p><strong>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>language_name</code></strong><p>vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leur <code>language_code</code>&nbsp;en effectuant une requête distincte sur <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages</code><p>exemple :<code class=\"long-string\">en</code></p>"
          },
          "depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<p><em>profondeur d'analyse</em><p>champ facultatif<p>nombre de résultats dans la SERP<p>valeur par défaut : <code>10</code><p>valeur maximale : <code>350</code><br><strong>votre compte sera facturé pour chaque SERP contenant jusqu'à 10 résultats ;</strong><br>définir une profondeur supérieure à 10 peut entraîner des frais supplémentaires si le moteur de recherche renvoie plus de 10 résultats, respectivement ;<br><p>si la profondeur indiquée est supérieure au nombre de résultats de la réponse, la différence sera automatiquement remboursée sur le solde de votre compte<br>Le coût peut être calculé sur la page Pricing."
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<p><em>priorité de la tâche</em><p>champ facultatif<p>peut prendre les valeurs suivantes :<p>1 – priorité d'exécution normale (définie par défaut)<p>2 – priorité d'exécution élevée</p><br>Les tâches à priorité d'exécution élevée sont facturées en supplément.<p>Le coût peut être calculé sur la page Pricing."
          },
          "device": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>type d'appareil</em><p>champ facultatif<p>renvoyer les résultats pour un type d'appareil particulier<p>peut prendre les valeurs :<code>desktop</code>, <code>mobile</code><p>valeur par défaut : <code>desktop</code></p>"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>URL de notification d'une tâche terminée</em><p>champ facultatif<p>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<p>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.<p>exemple :<p><code>http://your-server.com/pingscript?id=$id</code><p><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><p><strong>Remarque :</strong> les caractères spéciaux de <code>pingback_url</code> seront encodés pour URL ;<p>notamment, le caractère <code>#</code> sera encodé en <code>%23</code></p><br><p>en savoir plus dans notre centre d'aide</p>"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>URL d'envoi des résultats de la tâche</em><p>champ facultatif<p>une fois la tâche terminée, nous enverrons une requête POST contenant ses résultats compressés au format <code>gzip</code> à la <code>postback_url</code> que vous avez spécifiée<p>vous pouvez utiliser la chaîne ‘$id’ comme variable <code>$id</code> et ‘$tag’ comme variable <code>$tag</code> encodée pour l'URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.<p>exemple :<p><code>http://your-server.com/postbackscript?id=$id</code><p><code>http://your-server.com/postbackscript?id=$id&amp;tag=$tag</code><p><strong>Remarque :</strong> les caractères spéciaux de <code>postback_url</code> seront encodés pour l'URL ;<p>autrement dit, le caractère <code>#</code> sera encodé en <code>%23</code></p><br><p>en savoir plus sur notre centre d'aide</p>"
          },
          "postback_data": {
            "type": "string",
            "description": "<p><em>type de données de postback_url</em><p><strong>champ obligatoire si vous spécifiez <code>postback_url</code></strong><p>correspond à la fonction que vous avez utilisée pour définir une tâche<p>valeurs possibles :<p><code>advanced</code>, <code>html</code></p>"
          },
          "location_name": {
            "type": "string",
            "description": "<p><em>nom complet de l'emplacement du moteur de recherche</em><p><strong>champ obligatoire si vous ne spécifiez pas</strong> <code>location_code</code> ou <code>location_coordinate</code><p><strong>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>location_code</code> ou <code>location_coordinate</code></strong><p>vous pouvez obtenir la liste des emplacements disponibles du moteur de recherche avec leur <code>location_name</code> en effectuant une requête distincte sur <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations</code><p>exemple :<p><code class=\"long-string\">London,England,United Kingdom</code></p>"
          },
          "language_name": {
            "type": "string",
            "description": "<p><em>nom complet de la langue du moteur de recherche</em><p><strong>champ obligatoire si vous ne spécifiez pas</strong> <code>language_code</code><p><strong>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>language_code</code></strong><p>vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leur <code>language_name</code> en effectuant une requête distincte sur <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages</code><p>exemple :<p><code class=\"long-string\">English</code></p>"
          },
          "os": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>système d'exploitation de l'appareil</em><p>champ facultatif<p>si vous indiquez <code>desktop</code> dans le champ <code>device</code>, choisissez parmi les valeurs suivantes : <code>windows</code>, <code>macos</code><p>valeur par défaut : <code>windows</code><p>si vous indiquez <code>mobile</code> dans le champ <code>device</code>, choisissez parmi les valeurs suivantes : <code>android</code>, <code>ios</code><p>valeur par défaut : <code>android</code></p>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>identifiant de tâche défini par l'utilisateur</em><p>champ facultatif<p><em>la limite est de 255 caractères</em><p>vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat<p>vous trouverez la valeur <code>tag</code> indiquée dans l'objet <code>data</code> de la réponse</p>"
          },
          "location_coordinate": {
            "type": "string",
            "description": "<p><em>coordonnées GPS d'un emplacement</em><p><strong>champ obligatoire si vous ne spécifiez pas</strong> <code>location_name</code>&nbsp;ou <code>location_code</code><p><strong>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>location_name</code> ou <code>location_code</code></strong><p>le paramètre <code>location_coordinate</code> doit être spécifié au format <em>\"latitude,longitude,zoom\"</em><p>si <em>\"zoom\"</em> n'est pas spécifié, <em>9z</em> sera appliqué comme valeur par défaut<p>le nombre maximal de décimales pour <em>\"latitude\"</em> et <em>\"longitude\"</em> : 7<p>la valeur minimale pour <em>\"zoom\"</em> : 4z<p>la valeur maximale pour <em>\"zoom\"</em> : 18z<p>exemple :<p><code class=\"long-string\">52.6178549,-155.352142,18z</code></p>"
          },
          "min_rating": {
            "type": [
              "number",
              "null"
            ],
            "description": "<p><em>filtrer les résultats par note minimale</em><p>champ facultatif<p>valeurs possibles pour <code>desktop</code> : <code>3.5</code>, <code>4</code>, <code>4.5</code> ;<p>valeurs possibles pour <code>mobile</code> : <code>2</code>, <code>2.5</code>, <code>3</code>, <code>3.5</code>, <code>4</code>, <code>4.5</code></p>",
            "format": "double"
          },
          "time_filter": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>filtrer les résultats par horaires d'ouverture</em><p>champ facultatif<p>à l'aide de ce champ, vous pouvez filtrer les lieux des résultats selon l'heure à laquelle un lieu est ouvert aux visiteurs<p>notez que Google peut également fournir des résultats qui ne correspondent pas à ce filtre<p>valeurs possibles : <code>\"open_now\"</code>, <code>\"24_hours\"</code>, <code>\"$day_value\"</code>, <code>\"$day_value;$time_value\"</code> ;<p>au lieu de <code>$day_value</code>, utilisez l'une de ces valeurs : <code>\"monday\"</code>, <code>\"tuesday\"</code>, <code>\"wednesday\"</code>, <code>\"thursday\"</code>, <code>\"friday\"</code>, <code>\"saturday\"</code>, <code>\"sunday\"</code> ;<p>au lieu de <code>$time_value</code>, utilisez l'une de ces valeurs : <code>\"00\"</code>, <code>\"01\"</code>, <code>\"02\"</code>, <code>\"03\"</code>, <code>\"04\"</code>, <code>\"05\"</code>, <code>\"06\"</code>, <code>\"07\"</code>, <code>\"08\"</code>, <code>\"09\"</code>, <code>\"10\"</code>, <code>\"11\"</code>, <code>\"12\"</code>, <code>\"13\"</code>, <code>\"14\"</code>, <code>\"15\"</code>, <code>\"16\"</code>, <code>\"17\"</code>, <code>\"18\"</code>, <code>\"19\"</code>, <code>\"20\"</code>, <code>\"21\"</code>, <code>\"22\"</code>, <code>\"23\"</code><p>exemple : <code class=\"long-string\">\"tuesday;18\"</code></p>"
          }
        },
        "example": [
          {
            "language_code": "en",
            "location_code": 2840,
            "keyword": "local nail services",
            "min_rating": 4.5,
            "time_filter": "monday"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_code": "en",
      "location_code": 2840,
      "keyword": "local nail services",
      "min_rating": 4.5,
      "time_filter": "monday"
    }
  ]
}
```

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

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

`#/components/schemas/Response36Afe1097B20_SerpGoogleLocalFinderTaskPostResponseInfo`

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

### Response36Afe1097B20_SerpGoogleLocalFinderTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleLocalFinderTaskPostTaskInfo`

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