Felo API PlatformFelo API Platform
Tous les endpoints DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Configurer les tâches Google Maps SERP

Felo API Support
MIT
Serveur:https://openapi.felo.ai
Bibliothèques clientes
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Opérations

Configurer les tâches Google Maps SERP

​

Met en file d'attente le map pack d'une requête locale, avec la note, l'adresse et le place id de chaque établissement sur Google, 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.

Corps
application/json
  • Type: array (object | null)[]
    • depth
      Type: integer | null

      profondeur d'analyse

      champ facultatif

      nombre de résultats dans la SERP

      valeur par défaut : 100

      valeur maximale : 700


      Votre compte sera facturé pour chaque SERP contenant jusqu'à 100 résultats ;

      définir une profondeur supérieure à 100 peut entraîner des frais supplémentaires si le moteur de recherche renvoie plus de 100 résultats ;

      Le coût peut être calculé sur la page Pricing.

    • device
      Type: string | null

      type d'appareil

      champ facultatif

      renvoie les résultats pour un type d'appareil spécifique

      peut prendre les valeurs :desktop, mobile

      valeur par défaut : desktop

      remarque : pour l'appareil mobile, seuls 20 résultats sont renvoyés par SERP

    • keyword
      Type: string

      mot-clé

      champ obligatoire

      vous pouvez indiquer jusqu'à 700 caractères dans le champ keyword

      tous les %## seront décodés (le caractère ‘+’ sera décodé comme un espace)

      si vous devez utiliser le caractère “%” dans votre keyword, indiquez-le comme “%25” ;

      si vous devez utiliser le caractère “+” dans votre keyword, indiquez-le comme “%2B” ;

      en savoir plus sur les règles et limites des champs keyword et keywords dans les API DataForSEO dans cet article du centre d'aide

    • language_code
      Type: string

      code de langue du moteur de recherche

      champ obligatoire si vous ne spécifiez pas language_name

      si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_name

      vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leur language_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages

      exemple :

      en

    • language_name
      Type: string

      nom complet de la langue du moteur de recherche

      champ obligatoire si vous ne spécifiez pas language_code

      si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_code

      vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leur language_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages

      exemple :

      English

    • location_code
      Type: integer

      code d'emplacement du moteur de recherche

      champ obligatoire si vous ne spécifiez pas location_name ou location_coordinate

      si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ou location_coordinate

      vous pouvez obtenir la liste des emplacements disponibles des moteurs de recherche avec leur location_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations

      exemple :

      2840

    • location_coordinate
      Type: string

      coordonnées GPS d'un emplacement

      champ obligatoire si vous ne spécifiez pas location_name ou location_code

      si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ou location_code

      le paramètre location_coordinate doit être spécifié au format "latitude,longitude,zoom"

      si "zoom" n'est pas spécifié, 17z sera appliqué comme valeur par défaut

      le nombre maximal de décimales pour "latitude" et "longitude" : 7

      la valeur minimale pour "zoom" : 3z

      la valeur maximale pour "zoom" : 21z

      exemple :

      52.6178549,-155.352142,20z

    • location_name
      Type: string

      nom complet de l'emplacement du moteur de recherche

      champ obligatoire si vous ne spécifiez pas location_code ou location_coordinate

      si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_code ou location_coordinate

      vous pouvez obtenir la liste des emplacements disponibles du moteur de recherche avec leur location_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations

      exemple :

      London,England,United Kingdom

    • max_crawl_pages
      Type: integer | null

      limite de pages explorées

      champ facultatif

      nombre de pages de résultats de recherche à explorer

      valeur maximale : 100

      Remarque : les paramètres max_crawl_pages et depth se complètent ;

      en savoir plus dans notre centre d'aide

    • os
      Type: string | null

      système d'exploitation de l'appareil

      champ facultatif

      si vous indiquez desktop dans le champ device, choisissez parmi les valeurs suivantes : windows, macos

      valeur par défaut : windows

      si vous indiquez mobile dans le champ device, choisissez parmi les valeurs suivantes : android, ios

      valeur par défaut : android

    • pingback_url
      Type: string | null

      URL de notification d'une tâche terminée

      champ facultatif

      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

      vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.

      exemple :

      http://your-server.com/pingscript?id=$id

      http://your-server.com/pingscript?id=$id&tag=$tag

      Remarque : les caractères spéciaux de pingback_url seront encodés pour URL ;

      notamment, le caractère # sera encodé en %23


      en savoir plus dans notre centre d'aide

    • postback_data
      Type: string

      type de données de postback_url

      champ obligatoire si vous spécifiez postback_url

      correspond à la fonction que vous avez utilisée pour définir la tâche

      valeurs possibles :

      advanced

    • postback_url
      Type: string | null

      URL d'envoi des résultats de la tâche

      champ facultatif

      une fois la tâche terminée, nous enverrons une requête POST contenant ses résultats compressés au format gzip à la postback_url que vous avez spécifiée

      vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée pour l'URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.

      exemple :

      http://your-server.com/postbackscript?id=$id

      http://your-server.com/postbackscript?id=$id&tag=$tag

      Remarque : les caractères spéciaux de postback_url seront encodés pour l'URL ;

      autrement dit, le caractère # sera encodé en %23


      en savoir plus sur notre centre d'aide

    • priority
      Type: integer | null

      priorité de la tâche

      champ facultatif

      peut prendre les valeurs suivantes :

      1 – priorité d'exécution normale (définie par défaut)

      2 – priorité d'exécution élevée


      Les tâches à priorité d'exécution élevée sont facturées en supplément.

      Le coût peut être calculé sur la page Tarifs.

    • se_domain
      Type: string | null

      domaine du moteur de recherche

      champ facultatif

      nous choisissons automatiquement le domaine du moteur de recherche pertinent en fonction de l'emplacement et de la langue que vous indiquez

      vous pouvez toutefois définir un domaine de moteur de recherche personnalisé dans ce champ

      exemple :

      google.co.uk

    • search_places
      Type: boolean | null

      mode de recherche de lieux

      champ facultatif

      le mode de recherche de lieux permet d'obtenir des résultats Google Maps sur un lieu précis (par exemple, Apple Store à New York)

      toutefois, en raison des particularités de notre algorithme d'exploration de données, ce mode peut interférer avec certaines requêtes à intention locale — et afficher des résultats pour un lieu différent de celui indiqué dans la requête ;

      pour éviter cette interférence et obtenir des résultats corrects pour les mots-clés à intention locale, vous pouvez définir ce paramètre sur false ;valeur par défaut : true

      Remarque : si le mode search_places est désactivé et qu'aucun résultat n'a été trouvé dans la zone de recherche, le tableau results sera vide

    • search_this_area
      Type: boolean | null

      afficher les résultats de la zone affichée

      champ facultatif

      peut prendre les valeurs :true, false

      valeur par défaut : true

      si la valeur est false, le mode search_this_area est désactivé

      Remarque : si le mode search_this_area est désactivé, les listes Google Maps peuvent contenir des résultats au-delà de la zone affichée

    • tag
      Type: string | null

      identifiant de tâche défini par l'utilisateur

      champ facultatif

      la limite est de 255 caractères

      vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat

      vous trouverez la valeur tag indiquée dans l'objet data de la réponse

    • url
      Type: string | null

      URL directe de la requête de recherche

      champ facultatif

      vous pouvez indiquer une URL directe et nous la décomposerons dans les champs nécessaires. Notez que cette méthode est la plus difficile à traiter pour notre API et qu'elle exige également que vous indiquiez la langue et l'emplacement exacts dans l'URL. Dans la plupart des cas, nous ne recommandons pas d'utiliser cette méthode.

      exemple :

      https://google.com/maps/search/pizza/@37.09024,-95.712891,4z


      Remarque : les paramètres de moteur de recherche suivants ne sont pas pris en charge et seront automatiquement désactivés s'ils sont indiqués dans l'URL : allinanchor:, allintext:, allintitle:, allinurl:, cache:, define:, definition:, filetype:, id:, inanchor:, info:, intext:, intitle:, inurl:, link:, site:.
Réponses
  • 200
    Type: object | null · Response36Afe1097B20_SerpGoogleMapsTaskPostResponseInfo
    • cost
      Type: number | null Format: double

      coût total des tâches, USD

    • status_code
      Type: integer | null

      code d'état général vous pouvez trouver la liste complète des codes de réponse ici

    • status_message
      Type: string | null

      message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici

    • tasks
      Type: array (object | null)[] | null

      tableau de tâches

      • Type: object | null · Response36Afe1097B20_SerpGoogleMapsTaskPostTaskInfo
        • cost
          Type: number | null Format: double

          coût total des tâches, USD

        • data
          Type: object | null

          contient les mêmes paramètres que ceux spécifiés dans la requête POST

          • propertyName
            Type: object | null
        • id
          Type: string | null

          identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID

        • path
          Type: array (string | null)[] | null

          chemin de l'URL

        • result
          Type: object | null

          tableau de résultats
          dans ce cas, la valeur sera null

        • result_count
          Type: integer | null Format: int64

          nombre d'éléments dans le tableau de résultats

        • status_code
          Type: integer | null

          code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici

        • status_message
          Type: string | null

          message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici

        • time
          Type: string | null

          temps d'exécution, en secondes

    • tasks_count
      Type: integer | null Format: int64

      le nombre de tâches dans le tableau de tâches

    • tasks_error
      Type: integer | null Format: int64

      le nombre de tâches dans le tableau de tâches renvoyées avec une erreur

    • time
      Type: string | null

      temps d'exécution total, en secondes

    • version
      Type: string | null

      la version actuelle de l'API

    application/json
  • 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
Request Example for post/v1/beta/dataforseo/serp/google/maps/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/maps/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": null
    }
  ]
}

Opération réussie

Setting Google Maps SERP Tasks