Google Dataset Info Advanced en direct
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Dataset Info Advanced en direct
Renvoie la fiche d'un jeu de données dans Google Dataset Search, 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.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: array (object | null)[]
- datasetType: string
_id ID du jeu de données
champ obligatoire
vous pouvez trouver l'ID du jeu de données dans l'URL du jeu de données ou dans l'élément
datasetdu résultat Google Dataset Searchexemple :
L2cvMTFqbl85ZHN6MQ== - deviceType: string | null
type d'appareil
champ facultatif
renvoie les résultats pour un type d'appareil spécifique
valeur possible :
desktop - languageType: string | null
_code code de langue du moteur de recherche
champ facultatif
si vous utilisez ce champ, vous n'avez pas besoin de spécifier
language_namevaleur possible :
en - languageType: string | null
_name nom complet de la langue du moteur de recherche
champ facultatif
si vous utilisez ce champ, vous n'avez pas besoin de spécifier
language_codevaleur possible :
English - osType: string | null
système d'exploitation de l'appareil
champ facultatif
valeurs possibles :
windows,macosvaleur par défaut :
windows - tagType: 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
tagindiquée dans l'objetdatade la réponse
- Type: object | null · Response36Afe1097B20_SerpGoogleDatasetInfoLiveAdvancedResponseInfo200
- 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_SerpGoogleDatasetInfoLiveAdvancedTaskInfo
- 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 précis - 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.
type d'élément possible :dataset - itemsType: array (object | null)[] | null
éléments de résultats de recherche trouvés dans la SERP
- areaType: array (string | null)[] | null
_covered la liste des zones couvertes dans le jeu de données
par exemple :Africa,Global - authorsType: array (object | null)[] | null
la liste des auteurs du jeu de données
- domainType: string | null
domaine du lien de l'auteur
- nameType: string | null
nom de l'auteur du jeu de données
- typeType: string | null
type d'élément
- urlType: string | null
URL du lien de l'auteur
- datasetType: object | null · Response36Afe1097B20_DatasetDescription
_description description du jeu de données
- linksType: array (object | null)[] | null
liens présentés dans 'dataset_description'
- descriptionType: string | null
description de l'élément de résultats
- domainType: string | null
domaine vers lequel un lien pointe
- snippetType: string | null
texte à côté du titre du lien
- titleType: string | null
titre d'un élément de lien donné
- typeType: string | null
type d'élément
- urlType: string | null
URL
- xpathType: string | null
le XPath de l'élément
- textType: string | null
texte de la description
- datasetType: string | null
_id ID du jeu de données
- datasetType: array (object | null)[] | null
_providers la liste des institutions ayant fourni le jeu de données
- 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
- formatsType: array (object | null)[] | null
la liste des formats de fichier du jeu de données
- formatType: string | null
type de format de fichier du jeu de données
par exemple :zip,html,csv - sizeType: integer | null Format: int64
taille du fichier en octets
- typeType: string | null
type d'élément
- imageType: string | null
_url URL de l'image
l'URL menant à l'image sur la ressource d'origine ou dans le stockage DataForSEO (si la source d'origine n'est pas disponible) - licensesType: array (object | null)[] | null
la liste des licences délivrées pour le jeu de données
- 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
- linksType: array (object | null)[] | null
sitelinks
les liens affichés sous certains résultats de recherche de Google Dataset
s'il n'y en a aucun, la valeur estnull- descriptionType: string | null
description de l'élément de résultats
- domainType: string | null
domaine vers lequel un lien pointe
- snippetType: string | null
texte à côté du titre du lien
- titleType: string | null
titre d'un élément de lien donné
- typeType: string | null
type d'élément
- urlType: string | null
URL
- xpathType: string | null
le XPath de l'élément
- periodType: object | null · Response36Afe1097B20_PeriodCovered
_covered période couverte dans le jeu de données
- displayedType: string | null
_date période affichée dans le SERP
exemple :Mar 2, 2020 - Dec 9, 2022 - endType: string | null
_date date et heure de fin de la période
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2022-12-09 02:00:00 +00:00 - startType: string | null
_date date et heure de début de la période
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2020-03-02 02:00:00 +00:00
- 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 - relatedType: string | null
_article lien vers l'article associé
lien vers l'article publié associé au jeu de données - scholarlyType: string | null
_articles _url URL des articles scientifiques
lien vers la liste des articles scientifiques sur Google Scholar
exemple :https://scholar.google.com/scholar?q=%2210.6084%20m9%20figshare%207427933%20v1%22 - scholarlyType: integer | null Format: int64
_citations _count nombre d'articles qui font référence au jeu de données
- titleType: string | null
titre de l'élément
- typeType: string | null
type d'élément
- uniqueType: string | null
_identifier identifiant numérique d'un objet
identifiant numérique unique du jeu de données
exemple :https://doi.org/10.5061/dryad.hmgqnk9m3 - updatedType: string | null
_date date et heure de la dernière mise à jour du résultat
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2022-11-27 02:00:00 +00:00 - 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 caractère '+' sera décodé en espace) - languageType: string | null
_code code de langue dans un tableau POST
- 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- 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
- 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/dataset_info/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"dataset_id": "L2cvMTFqbl85ZHN6MQ=="
}
]'
{
"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,
"se_domain": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"item_types": [
null
],
"se_results_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"position": null,
"xpath": null,
"dataset_id": null,
"title": null,
"image_url": null,
"scholarly_citations_count": null,
"scholarly_articles_url": null,
"unique_identifier": null,
"related_article": null,
"links": [
"[Max Depth Exceeded]"
],
"dataset_providers": [
"[Max Depth Exceeded]"
],
"formats": [
"[Max Depth Exceeded]"
],
"authors": [
"[Max Depth Exceeded]"
],
"licenses": [
"[Max Depth Exceeded]"
],
"updated_date": null,
"area_covered": [
"[Max Depth Exceeded]"
],
"period_covered": "[Max Depth Exceeded]",
"dataset_description": "[Max Depth Exceeded]"
}
]
}
]
}
]
}