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

Yahoo Organic SERP Regular en temps réel

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

Yahoo Organic SERP Regular en temps réel

​

Renvoie les résultats classés d'un mot-clé sur Yahoo, de façon synchrone. 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.

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

      profondeur d'analyse
      champ facultatif
      nombre de résultats dans le SERP
      valeur par défaut : 6
      valeur maximale : 200
      Votre compte sera facturé pour chaque SERP ;
      Chaque SERP Yahoo peut contenir moins de 10 résultats ; définir une profondeur supérieure à la valeur par défaut peut donc entraîner des frais supplémentaires ;
      Le coût peut être calculé sur la page Tarifs.

    • device
      Type: string | null

      type d'appareil
      champ facultatif
      peut prendre les valeurs :desktop, mobile
      valeur par défaut : desktop

    • 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é en 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_or 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,radius"
      nombre maximal de décimales pour "latitude" et "longitude" : 7
      valeur minimale pour "radius" : 199.9 (mm)
      valeur maximale pour "radius" : 199999 (mm)
      exemple :
      53.476225,-2.243572,200

    • 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 par défaut : 1
      valeur maximale : 100
      Remarque : les paramètres max_crawl_pages et depth sont complémentaires ;
      en savoir plus sur 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

    • 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
      toutefois, vous pouvez définir un domaine de moteur de recherche personnalisé dans ce champ
      exemple :
      au.search.yahoo.com, uk.search.yahoo.com, ca.search.yahoo.com, etc.

    • search_param
      Type: string | null

      paramètres supplémentaires de la requête de recherche
      champ facultatif
      obtenez la liste des paramètres disponibles et plus de détails ici

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

      tableau de cibles pour arrêter l'exploration champ facultatif s'il est indiqué, la réponse contiendra les résultats SERP jusqu'au match_value indiqué inclus ; vous pouvez indiquer jusqu'à 10 valeurs de cible dans ce tableau exemple : "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] en savoir plus sur ce paramètre dans notre centre d'aide - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Votre compte sera facturé pour chaque SERP explorée via les cibles indiquées

      • match_type
        Type: string | null

        type de correspondance de la cible champ obligatoire si stop_crawl_on_match est indiqué ; type de correspondance pour match_value valeurs possibles : domain, with_subdomains, wildcard

      • match_value
        Type: string | null

        domaine ou valeur générique de cible champ obligatoire si stop_crawl_on_match est indiqué ; indiquez un domaine ou une valeur générique de cible ; Remarque : le nom de domaine doit être indiqué sans protocole de requête ; exemple : dataforseo.com

    • 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 spécifiée dans l'objet data de la réponse

    • target
      Type: string | null

      domaine, sous-domaine ou page web cible pour obtenir des résultats
      champ facultatif
      un domaine ou un sous-domaine doit être indiqué sans https:// ni www.
      notez que les résultats des tâches spécifiques à target incluront uniquement les éléments SERP contenant une chaîne url ;
      vous pouvez également utiliser le caractère générique (‘’) pour indiquer le modèle de recherche dans le SERP et affiner les résultats ;
      exemples :
      example.com - renvoie les résultats de la page d'accueil du site web avec des URL telles que https://example.com, ou https://www.example.com/, ou https://example.com/ ;
      example.com       - renvoie les résultats du domaine, y compris toutes ses pages ;
      example.com - renvoie les résultats de l'ensemble du domaine, y compris toutes ses pages et sous-domaines ;
      example.com - renvoie les résultats de la page d'accueil quel que soit le sous-domaine, par exemple https://en.example.com ;
      example.com/example-page - renvoie les résultats de l'URL exacte ;
      example.com/example-page       - renvoie les résultats de toutes les URL du domaine qui commencent par la chaîne indiquée

    • 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://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8

Réponses
  • 200
    Type: object | null · Response36Afe1097B20_SerpYahooOrganicLiveRegularResponseInfo
    • 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_SerpYahooOrganicLiveRegularTaskInfo
        • 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 avons fourni 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 trouvés dans la SERP
            contient les types de tous les résultats de recherche (items) trouvés dans la SERP renvoyée
            types d'éléments possibles :
            featured_snippet, images, local_pack, hotels_pack, organic, paid, people_also_ask, related_searches, shopping, recipes, top_stories, video, ai_overview;
            notez que ce tableau contient tous les types de résultats de recherche trouvés dans la SERP renvoyée ;
            toutefois, ce point de terminaison ne fournit des données que pour les types organic, paid et featured_snippet ;
            pour obtenir tous les éléments (y compris les fonctionnalités SERP et les extraits enrichis) trouvés dans la SERP renvoyée, consultez le point de terminaison Yahoo Organic Advanced SERP

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

            éléments dans la SERP

            • 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

            • position
              Type: string | null

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

            • 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

            • type
              Type: string | null

              type d'élément

            • 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 caractère '+' 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

          • pages_count
            Type: integer | null Format: int64

            nombre total de pages récupérées
            nombre total de SERP récupérées dans le résultat

          • refinement_chips
            Type: object | null · Response36Afe1097B20_RefinementChipsInfo

            puces de raffinement de recherche
            vaut null

            • 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 post/v1/beta/dataforseo/serp/yahoo/organic/live/regular
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/yahoo/organic/live/regular \
  --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": [
        {
          "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,
          "pages_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "page": null,
              "position": null,
              "xpath": null,
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Live Yahoo Organic SERP Regular