Obtenir les résultats avancés de SERP Google AI Mode par id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Obtenir les résultats avancés de SERP Google AI Mode par id
Récupère un résultat Google AI Mode 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.
- Type: object | null · Response36Afe1097B20_SerpGoogleAiModeTaskGetAdvancedResponseInfo200
- Type: number | null Format: doublecost
coût total des tâches, USD
- Type: integer | nullstatus
_code code d'état général vous pouvez trouver la liste complète des codes de réponse ici
- Type: string | nullstatus
_message message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici
- Type: array (object | null)[] | nulltasks
tableau de tâches
- Type: object | null · Response36Afe1097B20_SerpGoogleAiModeTaskGetAdvancedTaskInfo
- costType: number | null Format: double
coût total des tâches, USD
- dataType: object | null
contient les mêmes paramètres que ceux spécifiés dans la requête POST
- propertyType: object | null
Name
- idType: string | null
identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID
- pathType: array (string | null)[] | null
chemin de l'URL
- resultType: array (object | null)[] | null
tableau de résultats
- checkType: string | null
_url URL directe vers les résultats du moteur de recherche
vous pouvez l'utiliser pour vérifier que nous fournissons des résultats exacts - datetimeType: 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 - itemType: array (string | null)[] | null
_types 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 :ai_overview - itemsType: array (object | null)[] | null
éléments présents dans l'élément
- itemsType: array (object | null)[] | null
éléments présents dans l'élément
- positionType: string | null
l'alignement de l'élément dans la SERP
peut prendre les valeurs suivantes :left,right - typeType: string | null
type d'élément
- markdownType: string | null
- pageType: integer | null
page SERP
page SERP sur laquelle l'élément est classé - positionType: string | null
l'alignement de l'élément dans la SERP
peut prendre les valeurs suivantes :left,right - rankType: integer | null
_absolute rang absolu dans les SERP
position absolue parmi tous les éléments du SERP - rankType: integer | null
_group rang de groupe dans les SERP
position au sein d'un groupe d'éléments ayant des valeurstypeidentiques
les positions des éléments ayant des valeurstypedifférentes sont omises derank_group - rectangleType: 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 ànullsicalculate_rectanglesdans la requête POST n'est pas défini surtrue- heightType: number | null Format: double
hauteur de l'élément en pixels
- widthType: number | null Format: double
largeur de l'élément en pixels
- xType: 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
- yType: 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
- referencesType: array (object | null)[] | null
références supplémentaires associées à l'élément
inclut des références à des pages web qui ont pu être utilisées pour générer l'ai_overview- domainType: string | null
nom de domaine de la référence
- positionType: string | null
l'alignement de l'élément dans la SERP
peut prendre les valeurs suivantes :left,right - sourceType: string | null
nom ou titre de la source de référence
- textType: string | null
texte du composant
- titleType: string | null
texte d'ancrage du lien
- typeType: string | null
type d'élément
- urlType: string | null
URL du lien
- typeType: string | null
type d'élément
- xpathType: string | null
- itemsType: integer | null Format: int64
_count le nombre de résultats renvoyés dans le tableau
items - keywordType: 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) - languageType: string | null
_code code de langue dans un tableau POST
- locationType: integer | null
_code code de localisation dans un tableau POST
- refinementType: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips puces de raffinement de recherche
dans ce cas, la valeur seranull- itemsType: array (object | null)[] | null
items de l'élément
- domainType: string | null
domaine dans la SERP
- optionsType: array (object | null)[] | null
autres options d'affinage de la recherche
- domainType: string | null
domaine dans la SERP
- titleType: string | null
titre de l'élément
- typeType: string | null
type d'élément
- urlType: string | null
URL de recherche avec paramètres d'affinage
- titleType: string | null
titre de l'élément
- typeType: string | null
type d'élément
- urlType: string | null
URL de recherche avec paramètres d'affinage
- typeType: string | null
type d'élément
- xpathType: string | null
le XPath de l'élément
- seType: string | null
_domain domaine du moteur de recherche dans un tableau POST
- seType: integer | null Format: int64
_results _count nombre total de résultats dans la SERP
- spellType: 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 ;
dans ce cas, la valeur seranull- keywordType: string | null
mot-clé obtenu à la suite de l'autocorrection du moteur de recherche les résultats seront fournis pour le mot-clé corrigé
- typeType: 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
- typeType: string | null
type d'élément
- resultType: integer | null Format: int64
_count nombre d'éléments dans le tableau de résultats
- statusType: integer | null
_code 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
- statusType: string | null
_message message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici
- timeType: string | null
temps d'exécution, en secondes
- Type: integer | null Format: int64tasks
_count le nombre de tâches dans le tableau de tâches
- Type: integer | null Format: int64tasks
_error le nombre de tâches dans le tableau de tâches renvoyées avec une erreur
- Type: string | nulltime
temps d'exécution total, en secondes
- Type: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/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": null,
"rank_group": null,
"rank_absolute": null,
"page": null,
"position": null,
"xpath": null,
"markdown": null,
"items": [
"[Max Depth Exceeded]"
],
"references": [
"[Max Depth Exceeded]"
],
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}