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

Obtenir les résultats avancés de SERP Google Local Finder par id

Serveur:https://openapi.felo.ai
Bibliothèques clientes

DataForSEO

​

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

Obtenir les résultats avancés de SERP Google Local Finder par id

​

Récupère un résultat Google Local Finder 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.

Paramètres de chemin
  • id
    Type: string
    obligatoire

    identifiant de la tâche
    un identifiant unique universel (UUID)
    identifiant unique de la tâche dans notre système
    vous pourrez l'utiliser pendant 30 jours pour demander les résultats de la tâche à tout moment

Réponses
  • 200
    Type: object | null · Response36Afe1097B20_SerpGoogleLocalFinderTaskGetAdvancedResponseInfo
    • 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_SerpGoogleLocalFinderTaskGetAdvancedTaskInfo
        • 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: array (object | null)[] | null

          tableau de résultats

          • check_url
            Type: string | null

            URL directe vers les résultats du moteur de recherche
            vous pouvez l'utiliser pour vérifier que nous fournissons des résultats exacts

          • datetime
            Type: string | null

            date et heure de réception du résultat
            au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
            exemple :
            2019-11-15 12:57:46 +00:00

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

            types de résultats de recherche dans la SERP
            contient les types de résultats de recherche (items) trouvés dans la SERP.
            types d'éléments possibles :
            local_pack

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

            éléments de l'élément

            • Type: object | null · Response36Afe1097B20_LocalPackSerpElementItem
                • Type: object · Response36Afe1097B20_LocalPackSerpElementItem
                  • type
                    Discriminateur
                    Type: string | null

                    type d'élément

                  • booking_url
                    Type: string | null

                    URL de la page de réservation

                  • cid
                    Type: string | null

                    ID client défini par Google

                  • description
                    Type: string | null

                    description du lien

                  • domain
                    Type: string | null

                    domaine du site web qui héberge la vidéo

                  • is_paid
                    Type: boolean | null

                    indique si l'élément est une annonce

                  • page
                    Type: integer | null

                    numéro de page de résultats de recherche
                    indique le numéro de la page SERP sur laquelle se trouve l'élément

                  • phone
                    Type: string | null

                    numéro de téléphone

                  • position
                    Type: string | null

                    l'alignement de l'élément dans la SERP
                    peut prendre les valeurs suivantes :
                    left, right

                  • rank_absolute
                    Type: integer | null

                    rang absolu dans la SERP
                    position absolue parmi tous les éléments de la SERP
                    toujours égal à 0 pour desktop

                  • rank_group
                    Type: integer | null

                    rang de groupe dans la SERP
                    position au sein d'un groupe d'éléments ayant des valeurs type identiques ;
                    les positions des éléments ayant des valeurs type différentes sont omises de rank_group ;
                    toujours égal à 0 pour desktop

                  • rating
                    Type: object | null · Response36Afe1097B20_RatingInfo

                    la note de l'élément
                    le taux de popularité basé sur les avis et affiché dans la SERP ;
                    s'il n'y en a pas, vaut null

                    • rating_max
                      Type: integer | null

                      la valeur maximale d'un rating_type

                    • rating_type
                      Type: string | null

                      le type de note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax

                    • value
                      Type: number | null Format: double

                      la valeur de la note

                    • votes_count
                      Type: integer | null Format: int64

                      la quantité d'avis

                  • rectangle
                    Type: object | null · Response36Afe1097B20_AiModeRectangleInfo

                    paramètres du rectangle
                    contient les coordonnées cartésiennes et les dimensions en pixels de l'extrait du résultat dans la SERP
                    équivaut à null si calculate_rectangles dans la requête POST n'est pas défini sur true

                    • height
                      Type: number | null Format: double

                      hauteur de l'élément en pixels

                    • width
                      Type: number | null Format: double

                      largeur de l'élément en pixels

                    • x
                      Type: number | null Format: double

                      coordonnée de l'axe x coordonné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

                    • y
                      Type: number | null Format: double

                      coordonnée de l'axe y coordonné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

                  • title
                    Type: string | null

                    titre de la ligne

                  • url
                    Type: string | null

                    URL de la source d'avis tierce

                  • xpath
                    Type: string | null

                    le XPath de l'élément

          • items_count
            Type: integer | null Format: int64

            le nombre de résultats renvoyés dans le tableau items

          • keyword
            Type: string | null

            mot-clé reçu dans un tableau POST
            le mot-clé est renvoyé avec %## décodé (le symbole plus '+' sera décodé en espace)

          • language_code
            Type: string | null

            code de langue dans un tableau POST

          • location_code
            Type: integer | null

            code de localisation dans un tableau POST

          • refinement_chips
            Type: object | null · Response36Afe1097B20_RefinementChipsInfo

            puces de raffinement de recherche

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

              items de l'élément

              • domain
                Type: string | null

                domaine dans la SERP

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

                autres options d'affinage de la recherche

                • domain
                  Type: string | null

                  domaine dans la SERP

                • title
                  Type: string | null

                  titre de l'élément

                • type
                  Type: string | null

                  type d'élément

                • url
                  Type: string | null

                  URL de recherche avec paramètres d'affinage

              • title
                Type: string | null

                titre de l'élément

              • type
                Type: string | null

                type d'élément

              • url
                Type: string | null

                URL de recherche avec paramètres d'affinage

            • type
              Type: string | null

              type d'élément

            • xpath
              Type: string | null

              le XPath de l'élément

          • se_domain
            Type: string | null

            domaine du moteur de recherche dans un tableau POST

          • se_results_count
            Type: integer | null Format: int64

            nombre total de résultats dans la SERP

          • spell
            Type: object | null · Response36Afe1097B20_SpellInfo

            autocorrection du moteur de recherche
            si le moteur de recherche a fourni des résultats pour un mot-clé corrigé, nous indiquerons le mot-clé corrigé par le moteur de recherche et le type d'autocorrection

            • keyword
              Type: string | null

              mot-clé obtenu à la suite de l'autocorrection du moteur de recherche les résultats seront fournis pour le mot-clé corrigé

            • type
              Type: string | null

              type d'autocorrection valeurs possibles : did_you_mean, showing_results_for, no_results_found_for, including_results_for remarque : Yahoo et Yandex ne prennent en charge que le type d'autocorrection suivant : including_results_for

          • type
            Type: string | null

            type d'élément

        • 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 get/v1/beta/dataforseo/serp/google/local_finder/task_get/advanced/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/local_finder/task_get/advanced/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "page": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "xpath": "[Max Depth Exceeded]",
              "rectangle": "[Max Depth Exceeded]",
              "rank_group": "[Max Depth Exceeded]",
              "rank_absolute": "[Max Depth Exceeded]",
              "title": "[Max Depth Exceeded]",
              "description": "[Max Depth Exceeded]",
              "domain": "[Max Depth Exceeded]",
              "phone": "[Max Depth Exceeded]",
              "booking_url": "[Max Depth Exceeded]",
              "url": "[Max Depth Exceeded]",
              "is_paid": "[Max Depth Exceeded]",
              "rating": "[Max Depth Exceeded]",
              "cid": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Get Google Local Finder SERP Advanced Results by id