DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Vue d'ensemble Whois de domaine
Des enregistrements Whois enrichis de métriques SEO. Chaque élément porte domain, created_datetime, changed_datetime, expiration_datetime, updated_datetime, first_seen, epp_status_codes, tld, registered et registrar, ainsi que metrics et backlinks_info. Paginé avec limit, offset et offset_token, filtré sur les champs de get_dataforseo_domains_whois_available_filters.
Référence tarifaire
- Mesure : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.012.
- 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)[]
- filtersType: array (object | null)[] | null
tableau de paramètres de filtrage des résultats
champ facultatif
vous pouvez ajouter plusieurs filtres à la fois (8 filtres maximum)
vous devez définir un opérateur logiqueand,orentre les conditions
les opérateurs suivants sont pris en charge :regex,<,<=,>,>=,=,<>,in,not_in,like,not_like
vous pouvez utiliser l'opérateur%aveclikeetnot_likepour correspondre à toute chaîne de zéro ou plusieurs caractèresObjet vide - limitType: integer | null
nombre maximal de domaines renvoyés
champ facultatif
valeur par défaut :100
valeur maximale :1000 - offsetType: integer | null
décalage dans le tableau de résultats des éléments renvoyés
champ facultatif
valeur par défaut :0
si vous indiquez la valeur10, les dix premiersitemsdu tableau de résultats sont omis et les données sont fournies pour les éléments suivants ;
Remarque : nous recommandons d'utiliser ce paramètre uniquement pour récupérer jusqu'à 10 000 résultats ; pour récupérer plus de 10 000 résultats, utilisez plutôtoffset_token - offsetType: string | null
_token jeton pour les requêtes suivantes
champ facultatif
fourni dans le champ identical de la réponse à chaque requête ;
utilisez ce paramètre pour éviter les délais d'attente lorsque vous essayez d'obtenir plus de 100 000 résultats en une seule requête ;
en indiquant la valeur uniqueoffset_tokendu tableau de réponse, vous obtiendrez les résultats suivants de la tâche initiale ;
les valeursoffset_tokensont uniques pour chaque tâche suivante
Remarque : sioffset_tokenest indiqué dans la requête, tous les autres paramètres doivent être identiques à ceux de la requête précédente
en savoir plus sur ce paramètre dans notre centre d'aide - orderType: array string[] | null
_by règles de tri des résultats
champ facultatif
vous pouvez utiliser les mêmes valeurs que dans le tableaufilterspour trier les résultats
types de tri possibles :asc- les résultats seront triés par ordre croissantdesc- les résultats seront triés par ordre décroissant
la virgule sert de séparateur
exemple :["metrics.organic.pos_1,desc"]
règle par défaut :["metrics.organic.count,desc"]
notez que vous pouvez définir au maximum trois règles de tri dans une seule requête
vous devez utiliser une virgule pour séparer plusieurs règles de tri
exemple :["expiration_datetime,asc","metrics.organic.etv,desc","metrics.organic.pos_1,desc"] - 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 valeurtagspécifiée dans l'objetdatade la réponse
- Type: object | null · Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveResponseInfo200
- 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_DomainAnalyticsWhoisOverviewLiveTaskInfo
- 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
- itemsType: array (object | null)[] | null
contient les données de classement et de trafic
tableau items
- backlinksType: object | null · Response36Afe1097B20_BacklinksInfo
_info données de backlinks pour le domaine renvoyé
- backlinksType: integer | null Format: int64
nombre moyen de backlinks
- dofollowType: integer | null Format: int64
nombre moyen de liens dofollow
- referringType: integer | null Format: int64
_domains nombre moyen de domaines référents
- referringType: integer | null Format: int64
_main _domains nombre moyen de domaines principaux référents
- referringType: integer | null Format: int64
_pages nombre moyen de pages référentes
- timeType: string | null
_update date et heure auxquelles les données de backlinks ont été mises à jour
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” ;
exemple :2019-11-15 12:57:46 +00:00
- changedType: string | null
_datetime - createdType: string | null
_datetime - domainType: string | null
nom de domaine
- eppType: array (string | null)[] | null
_status _codes - expirationType: string | null
_datetime - firstType: string | null
_seen date et heure auxquelles notre robot d'exploration a trouvé le domaine pour la première fois
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :"2019-11-15 12:57:46 +00:00" - metricsType: object | null · Response36Afe1097B20_MetricsBundleInfo
données de classement relatives au domaine spécifié
- organicType: object | null · Response36Afe1097B20_MetricsInfo
données de classement et de trafic issues de la recherche organique
- countType: integer | null Format: int64
nombre total de SERP organiques contenant le domaine
- estimatedType: number | null
_paid _traffic _cost coût estimé de la conversion du trafic de recherche organique en trafic payant
représente le coût mensuel estimé de la diffusion d'annonces (USD) pour tous les mots-clés sur lesquels un domaine se classe
la métrique est calculée comme le produit des valeursetvorganique etcpcpayant et indique le coût de génération du volume estimé de trafic organique mensuel via la publicité PPC dans Google Search
en savoir plus sur le calcul de la métrique dans cet article du centre d'aide - etvType: number | null
volume de trafic estimé
trafic organique mensuel estimé vers le domaine
calculé comme le produit des valeurs de CTR (taux de clics) et du volume de recherche de tous les mots-clés pour lesquels le domaine se classe
en savoir plus sur le mode de calcul de cette métrique dans cet article du centre d'aide - isType: integer | null Format: int64
_down classement en baisse indique combien d'éléments classés de ce domaine ont reculé dans Google Search
- isType: integer | null Format: int64
_lost éléments classés perdus indique combien d'éléments classés de ce domaine étaient auparavant présents dans les SERP, mais n'ont pas été trouvés lors de la dernière vérification
- isType: integer | null Format: int64
_new nombre de nouveaux éléments classés indique combien de nouveaux éléments classés ont été trouvés pour ce domaine
- isType: integer | null Format: int64
_up classement en hausse indique combien d'éléments classés de ce domaine ont progressé dans Google Search
- posType: integer | null
_1 nombre de SERP organiques où le domaine se classe #1
- posType: integer | null
_11 _20 nombre de SERP organiques où le domaine se classe #11-20
- posType: integer | null
_2 _3 nombre de SERP organiques où le domaine se classe #2-3
- posType: integer | null
_21 _30 nombre de SERP organiques où le domaine se classe #21-30
- posType: integer | null
_31 _40 nombre de SERP organiques où le domaine se classe #31-40
- posType: integer | null
_4 _10 nombre de SERP organiques où le domaine se classe #4-10
- posType: integer | null
_41 _50 nombre de SERP organiques où le domaine se classe #41-50
- posType: integer | null
_51 _60 nombre de SERP organiques où le domaine se classe #51-60
- posType: integer | null
_61 _70 nombre de SERP organiques où le domaine se classe #61-70
- posType: integer | null
_71 _80 nombre de SERP organiques où le domaine se classe #71-80
- posType: integer | null
_81 _90 nombre de SERP organiques où le domaine se classe #81-90
- posType: integer | null
_91 _100 nombre de SERP organiques où le domaine se classe #91-100
- paidType: object | null · Response36Afe1097B20_MetricsInfo
données de classement et de trafic issues de la recherche payante
- countType: integer | null Format: int64
nombre total de SERP organiques contenant le domaine
- estimatedType: number | null
_paid _traffic _cost coût estimé de la conversion du trafic de recherche organique en trafic payant
représente le coût mensuel estimé de la diffusion d'annonces (USD) pour tous les mots-clés sur lesquels un domaine se classe
la métrique est calculée comme le produit des valeursetvorganique etcpcpayant et indique le coût de génération du volume estimé de trafic organique mensuel via la publicité PPC dans Google Search
en savoir plus sur le calcul de la métrique dans cet article du centre d'aide - etvType: number | null
volume de trafic estimé
trafic organique mensuel estimé vers le domaine
calculé comme le produit des valeurs de CTR (taux de clics) et du volume de recherche de tous les mots-clés pour lesquels le domaine se classe
en savoir plus sur le mode de calcul de cette métrique dans cet article du centre d'aide - isType: integer | null Format: int64
_down classement en baisse indique combien d'éléments classés de ce domaine ont reculé dans Google Search
- isType: integer | null Format: int64
_lost éléments classés perdus indique combien d'éléments classés de ce domaine étaient auparavant présents dans les SERP, mais n'ont pas été trouvés lors de la dernière vérification
- isType: integer | null Format: int64
_new nombre de nouveaux éléments classés indique combien de nouveaux éléments classés ont été trouvés pour ce domaine
- isType: integer | null Format: int64
_up classement en hausse indique combien d'éléments classés de ce domaine ont progressé dans Google Search
- posType: integer | null
_1 nombre de SERP organiques où le domaine se classe #1
- posType: integer | null
_11 _20 nombre de SERP organiques où le domaine se classe #11-20
- posType: integer | null
_2 _3 nombre de SERP organiques où le domaine se classe #2-3
- posType: integer | null
_21 _30 nombre de SERP organiques où le domaine se classe #21-30
- posType: integer | null
_31 _40 nombre de SERP organiques où le domaine se classe #31-40
- posType: integer | null
_4 _10 nombre de SERP organiques où le domaine se classe #4-10
- posType: integer | null
_41 _50 nombre de SERP organiques où le domaine se classe #41-50
- posType: integer | null
_51 _60 nombre de SERP organiques où le domaine se classe #51-60
- posType: integer | null
_61 _70 nombre de SERP organiques où le domaine se classe #61-70
- posType: integer | null
_71 _80 nombre de SERP organiques où le domaine se classe #71-80
- posType: integer | null
_81 _90 nombre de SERP organiques où le domaine se classe #81-90
- posType: integer | null
_91 _100 nombre de SERP organiques où le domaine se classe #91-100
- registeredType: boolean | null
statut d'enregistrement du domaine
sifalse, l'enregistrement du nom de domaine a expiré
Remarque : les domaines expirés ne resteront dans la base de données que pendant une courte période - registrarType: string | null
registraire du domaine
sinull, le registraire du domaine est inconnu
exemple :NameCheap, Inc. - tldType: string | null
- updatedType: string | null
_datetime
- itemsType: integer | null Format: int64
_count le nombre de résultats renvoyés dans le tableau
items - offsetType: integer | null
valeur de décalage des résultats spécifiée dans la requête POST
- offsetType: string | null
_token - totalType: integer | null Format: int64
_count quantité totale de résultats de notre base de données correspondant à votre requête
- 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/domain_analytics/whois/overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"limit": 2,
"filters": [
[
"epp_status_codes",
"in",
[
"client_transfer_prohibited",
"client_update_prohibited"
]
]
]
}
]'
{
"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": [
{
"total_count": null,
"items_count": null,
"offset": null,
"offset_token": null,
"items": [
{
"domain": null,
"created_datetime": null,
"changed_datetime": null,
"expiration_datetime": null,
"updated_datetime": null,
"first_seen": null,
"epp_status_codes": [
"[Max Depth Exceeded]"
],
"tld": null,
"registered": null,
"registrar": null,
"metrics": "[Max Depth Exceeded]",
"backlinks_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}