v0.2.0-beta

OpenAPI 3.1.0

Google Organic SERP Advanced 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

post/v1/beta/dataforseo/serp/google/organic/live/advanced

Google Organic SERP Advanced en temps réel

Renvoie les résultats classés d'un mot-clé sur Google, 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. advanced est le choix par défaut ; prenez regular quand seule la liste classée importe, et html uniquement pour vérifier ce que l'analyseur a écarté. 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.0175.
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)[]
- browser_screen_height
  Type: integer | null
  
  hauteur d'écran du navigateur champ facultatif vous pouvez définir une hauteur d'écran de navigateur personnalisée pour calculer le classement en pixels d'un appareil particulier ; elle peut être définie dans la plage suivante : 240-9999 ; par défaut, le paramètre est défini sur : 1080 pour desktop ; 640 pour mobile sur android ; 812 pour mobile sur iOS ; Remarque : pour utiliser ce paramètre, définissez calculate_rectangles sur true
- browser_screen_resolution_ratio
  Type: integer | null
  
  ratio de résolution d'écran du navigateur champ facultatif vous pouvez définir un ratio de résolution d'écran de navigateur personnalisé pour calculer le classement en pixels d'un appareil particulier ; il peut être défini dans la plage suivante : 0.5-3 ; par défaut, le paramètre est défini sur : 1 pour desktop ; 3 pour mobile sur android ; 3 pour mobile sur iOS ; Remarque : pour utiliser ce paramètre, définissez calculate_rectangles sur true
- browser_screen_width
  Type: integer | null Format: int64
  
  largeur d'écran du navigateur champ facultatif vous pouvez définir une largeur d'écran de navigateur personnalisée pour calculer le classement en pixels d'un appareil particulier ; elle peut être définie dans la plage suivante : 240-9999 ; par défaut, le paramètre est défini sur : 1920 pour desktop ; 360 pour mobile sur android ; 375 pour mobile sur iOS ; Remarque : pour utiliser ce paramètre, définissez calculate_rectangles sur true
- calculate_rectangles
  Type: boolean | null
  
  calculer le classement en pixels des éléments du SERP dans les résultats avancés champ facultatif le classement en pixels désigne la distance entre l'extrait du résultat et le coin supérieur gauche de l'écran ; Consultez le centre d'aide pour en savoir plus>> par défaut, le paramètre est défini sur false ; Remarque : l'utilisation de ce paramètre vous sera facturée 0,002 $ de plus
- depth
  Type: integer | null
  
  profondeur d'analyse champ facultatif nombre de résultats dans le SERP valeur par défaut : 10 valeur maximale : 200 Votre compte sera facturé pour chaque SERP contenant jusqu'à 10 résultats ; 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 ; Le coût peut être calculé sur la page Tarifs.
- device
  Type: string | null
  
  type d'appareil champ facultatif renvoyer les résultats pour un type d'appareil particulier peut prendre les valeurs : desktop, mobile valeur par défaut : desktop
- find_targets_in
  Type: array string[] | null
  
  types d'élément du SERP à vérifier pour les cibles champ facultatif pour activer ce paramètre, stop_crawl_on_match doit également être activé spécifie les types d'élément du SERP à vérifier pour les correspondances de cible s'il n'est pas spécifié, tous les éléments de premier niveau avec les champs url et domain sont vérifiés pour les cibles valeurs possibles : organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Remarque : ne peut pas contenir les mêmes types d'élément que ignore_targets_in exemple : "find_targets_in": ["organic", "featured_snippet"] en savoir plus sur ce paramètre dans notre centre d'aide
- group_organic_results
  Type: boolean | null
  
  afficher les résultats associés champ facultatif si la valeur est true, l'élément related_result de la réponse sera fourni sous forme d'extrait de son résultat organique parent ; si la valeur est false, l'élément related_result sera fourni comme résultat organique distinct ; valeur par défaut : true
- ignore_targets_in
  Type: array string[] | null
  
  types d'élément du SERP à exclure de la recherche de cibles champ facultatif pour activer ce paramètre, stop_crawl_on_match doit également être activé spécifie les types d'élément du SERP à exclure lors de la recherche de correspondances de cible valeurs possibles : organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Remarque : ne peut pas contenir les mêmes types d'élément que find_targets_in exemple : "ignore_targets_in": ["paid", "images"] en savoir plus sur ce paramètre dans notre centre d'aide
- keyword
  Type: string
  
  mot-clé champ obligatoire vous pouvez spécifier jusqu'à 700 caractères dans le champ keyword tous les %## seront décodés (le caractère ‘+’ sera également décodé en espace) si vous devez utiliser le caractère “%” dans votre keyword, spécifiez-le comme “%25” ; si vous devez utiliser le caractère “+” dans votre keyword, spécifiez-le comme “%2B” ; si ce champ contient des paramètres tels que ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘definition:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, les frais par tâche seront multipliés par 5 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 | null
  
  code de langue du moteur de recherche champ facultatif si vous spécifiez 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/google/languages exemple : en
- language_name
  Type: string | null
  
  nom complet de la langue du moteur de recherche champ facultatif si vous spécifiez 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/google/languages exemple : English
- load_async_ai_overview
  Type: boolean | null
  
  charger l'aperçu IA de manière asynchrone champ facultatif définissez la valeur true pour obtenir des éléments ai_overview dans les SERP même s'ils sont chargés de manière asynchrone ; si la valeur est false, vous obtiendrez uniquement les éléments ai_overview du cache ; valeur par défaut : false Remarque : l'utilisation de ce paramètre vous sera facturée 0,002 $ de plus ; si l'élément est absent ou contient "asynchronous_ai_overview": false, tous les frais supplémentaires seront remboursés sur le solde de votre compte
- location_code
  Type: integer | null
  
  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/google/locations exemple : 2840
- location_coordinate
  Type: string | null
  
  coordonnées GPS d'un emplacement champ facultatif si vous spécifiez 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,radius" le nombre maximal de décimales pour "latitude" et "longitude" : 7 la valeur minimale pour "radius" : 199 (mm) la valeur maximale pour "radius" : 199999 (mm) exemple : 53.476225,-2.243572,200
- location_name
  Type: string | null
  
  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/google/locations exemple : London,England,United Kingdom
- match_type
  Type: string | null
  
  type de correspondance de cible champ obligatoire si stop_crawl_on_match est spécifié type de correspondance pour match_value valeurs possibles : domain – domaine ou sous-domaine spécifique with_subdomains – domaine principal et sous-domaines wildcard – modèle générique
- match_value
  Type: string | null
  
  domaine, sous-domaine ou valeur générique de cible champ obligatoire si stop_crawl_on_match est spécifié indiquez un domaine, un sous-domaine ou une valeur générique de cible ; Remarque : le domaine ou le sous-domaine doit être indiqué sans protocole de requête ; exemple : "match_value": "dataforseo.com","match_value": "/blog/post-*"
- 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 : vous serez facturé pour chaque page explorée (10 résultats organiques par page) ; en savoir plus sur les tarifs sur notre page Tarifs ; Remarque n° 2 : 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
- people_also_ask_click_depth
  Type: integer | null
  
  clics sur l'élément correspondant champ facultatif indiquez la profondeur de clics sur l'élément people_also_ask pour obtenir des éléments people_also_ask_element supplémentaires ; Remarque : votre compte sera facturé 0,00015 $ de plus par clic ; si l'élément est absent ou si nous effectuons moins de clics que vous l'avez indiqué, tous les frais supplémentaires seront remboursés sur le solde de votre compte valeurs possibles : de 1 à 4
- remove_from_url
  Type: array string[] | null
  
  supprimer des paramètres spécifiques des URL champ facultatif avec ce champ, vous pouvez indiquer jusqu'à 10 paramètres à supprimer des URL du résultat exemple : "remove_from_url": ["srsltid"] Remarque : si le champ target est spécifié, les paramètres d'URL indiqués seront supprimés avant la recherche
- 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, google.com.au, google.de, 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 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 : lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- 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 de caractères est 255 vous pouvez utiliser ce paramètre pour identifier la tâche et la faire correspondre 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 de destination pour obtenir des résultats champ facultatif un domaine ou un sous-domaine doit être indiqué sans https:// et www. notez que les résultats des tâches spécifiques à une cible incluront uniquement les éléments du SERP qui contiennent 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 restreindre 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, 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
- target_search_mode
  Type: string | null
  
  mode de correspondance des cibles champ facultatif pour activer ce paramètre, stop_crawl_on_match doit également être activé définit comment l'exploration doit s'arrêter lorsque plusieurs cibles sont indiquées dans stop_crawl_on_match valeurs possibles : all, any all – l'exploration ne s'arrête que lorsque toutes les cibles indiquées sont trouvées any – l'exploration s'arrête dès qu'une seule cible est trouvée valeur par défaut : any en savoir plus sur ce paramètre dans notre centre d'aide
- 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://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS 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 : lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.

Réponses

200
Type: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo
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_SerpGoogleOrganicLiveAdvancedTaskInfo
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 précis

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 :answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box,product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview

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

items de l'élément

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 de résultats de recherche 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

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 précisons le mot-clé corrigé par le moteur de recherche ainsi que 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

post/v1/beta/dataforseo/serp/google/organic/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein",
    "calculate_rectangles": true
  }
]'

Afficher le schéma

{
  "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

Google Organic SERP Advanced en temps réel

AuthentificationRequired

DataForSEO

Google Organic SERP Advanced en temps réel

Référence tarifaire