DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Historique des liens entrants
Le profil de liens entrants d'une target tel qu'il était à chaque date d'une plage, avec date_from, date_to et un élément par point. Pour le profil actuel uniquement, utilisez post_dataforseo_backlinks_summary_live. Pour une série temporelle plus légère, post_dataforseo_backlinks_timeseries_summary_live rapporte moins de métriques par point. Ce point de terminaison n'accepte pas de paramètre de limite : le seul levier est de l'appeler moins souvent.
Référence tarifaire
- Facturation : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.0271.
- Multiplicateur de référence client : 1.0. Ne pas l'appliquer une seconde fois à 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)[]
- dateType: string | null
_from date de début de la plage temporelle
champ facultatif
valeur minimale2019-01-01
si vous n'indiquez pas ce champ, la valeur minimale est utilisée par défaut
format de date :"yyyy-mm-dd"
exemple :"2019-01-15" - dateType: string | null
_to date de fin de l'intervalle de temps
champ facultatif
si vous n'indiquez pas ce champ, la date du jour est utilisée par défaut
format de date :"yyyy-mm-dd"
exemple :"2019-01-15" - rankType: string | null
_scale définit l'échelle utilisée pour calculer et afficher les valeurs
rank,domain_from_ranketpage_from_rank
champ facultatifvous pouvez utiliser ce paramètre pour choisir si les valeurs de rang sont présentées sur une échelle de 0–100 ou de 0–1000
valeurs possibles :
one_hundred— les valeurs de rang sont affichées sur une échelle de 0–100one_thousand— les valeurs de rang sont affichées sur une échelle de 0–1000valeur par défaut :
one_thousanden savoir plus sur le fonctionnement de ce paramètre et le calcul des métriques de classement dans cet article du centre d'aide
- 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 - targetType: string
domaine
champ obligatoire
un domaine doit être indiqué sanshttps://niwww.
- Type: object | null · Response36Afe1097B20_BacklinksHistoryLiveResponseInfo200
- 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_BacklinksHistoryLiveTaskInfo
- 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
- dateType: string | null
_from date de début de la plage temporelle
au format UTC : “yyyy-mm-dd”
exemple :2019-01-01 - dateType: string | null
_to date de fin de la plage temporelle
au format UTC :"yyyy-mm-dd"
exemple :"2019-01-15" - itemsType: array (object | null)[] | null
contient les données historiques de backlinks du domaine indiqué
les données sont fournies mois par mois ;
les métriques sont agrégées selon les backlinks que le domaine indiqué possédait le premier jour de chaque mois- backlinksType: integer | null Format: int64
nombre de backlinks
- brokenType: integer | null Format: int64
_backlinks nombre de backlinks brisés
nombre de backlinks brisés pointant vers latarget - brokenType: integer | null
_pages nombre de pages brisées
nombre de pages qui reçoivent des backlinks mais répondent avec des codes de statut 4xx ou 5xx - crawledType: integer | null
_pages nombre de pages crawlées pour la
target - dateType: string | null
date et heure auxquelles les données de la cible ont été stockées
au format UTC : "yyyy-mm-dd hh-mm-ss +00:00"
exemple :2019-11-15 12:57:46 +00:00 - externalType: integer | null Format: int64
_links _count nombre de liens externes sur la page
calculé comme la somme des liens externes sur les pages de latargetindiquée - infoType: object | null · Response36Afe1097B20_TargetInfo
informations sur la
target- cmsType: string | null
système de gestion de contenu
- countryType: string | null
code du pays auquel appartient le domaine
target - ipType: string | null
_address adresse IP de la
target - isType: boolean | null
_ip indique si la
targetest une IP
sitrue, le domaine, sous-domaine ou page web fait office d'adresse IP et n'a pas de nom de domaine - platformType: array (string | null)[] | null
_type type de plateforme
- serverType: string | null
serveur
- targetType: integer | null
_spam _score
- internalType: integer | null Format: int64
_links _count nombre de liens internes
calculé comme la somme des liens internes sur les pages de latargetindiquée - lostType: integer | null Format: int64
_backlinks nombre de backlinks perdus pour la
target
les données sont fournies sur la base d'une comparaison avec la période précédente
Remarque : ces données sont disponibles depuis mai 2021 ;
si la plage de dates indiquée dans la requête POST précède mai 2021, le champ sera égal à0 - lostType: integer | null Format: int64
_referring _domains nombre de domaines référents perdus pour la
target
les données sont fournies sur la base d'une comparaison avec la période précédente
Remarque : ces données sont disponibles depuis mai 2021 ;
si la plage de dates indiquée dans la requête POST précède mai 2021, le champ sera égal à0 - newType: integer | null Format: int64
_backlinks nombre de nouveaux backlinks pour la
target
les données sont fournies sur la base d'une comparaison avec la période précédente
Remarque : ces données sont disponibles depuis mai 2021 ;
si la plage de dates indiquée dans la requête POST précède mai 2021, le champ sera égal à0 - newType: integer | null Format: int64
_referring _domains nombre de nouveaux domaines référents pour la
target
les données sont fournies sur la base d'une comparaison avec la période précédente
Remarque : ces données sont disponibles depuis mai 2021 ;
si la plage de dates indiquée dans la requête POST précède mai 2021, le champ sera égal à0 - rankType: integer | null
- referringType: integer | null Format: int64
_domains nombre de domaines référents
les domaines référents incluent les sous-domaines comptés comme des domaines distincts pour cette métrique - referringType: integer | null Format: int64
_domains _nofollow nombre de domaines pointant au moins un lien nofollow vers la
target - referringType: integer | null Format: int64
_ips nombre d'adresses IP référentes
nombre d'adresses IP pointant vers cette page - referringType: object | null
_links _attributes attributs de lien des liens référents
indique les attributs de lien des liens référents et le nombre de liens par attribut- propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringType: object | null
_links _countries codes pays ISO des liens référents
indique les codes pays ISO des domaines où se trouvent les liens référents et le nombre de liens par pays- propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringType: object | null
_links _platform _types types de plateformes référentes
indique les types de plateformes référentes et le nombre de liens par plateformevaleurs possibles :
cms,blogs,ecommerce,message-boards,wikis,news,organization- propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringType: object | null
_links _semantic _locations - propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringType: object | null
_links _tld domaines de premier niveau des liens référents
contient les domaines de premier niveau et le nombre de liens référents pour chacun- propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringType: object | null
_links _types types de liens référents
indique les types des liens référents et le nombre de liens par type
valeurs possibles :anchor,image,link,meta,canonical,alternate,redirect- propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringType: integer | null Format: int64
_main _domains nombre de domaines principaux référents
- referringType: integer | null Format: int64
_main _domains _nofollow nombre de domaines principaux pointant au moins un lien nofollow vers la
target - referringType: integer | null Format: int64
_pages nombre de pages pointant vers la
target - referringType: integer | null Format: int64
_pages _nofollow nombre de pages référentes pointant au moins un lien nofollow vers la
target - referringType: integer | null Format: int64
_subnets nombre de sous-réseaux référents
- typeType: string | null
type d'élément
- itemsType: integer | null Format: int64
_count le nombre de résultats renvoyés dans le tableau
items - targetType: string | null
targetdu tableau POST
- 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/backlinks/history/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "cnn.com",
"date_from": "2020-01-01",
"date_to": "2021-01-01"
}
]'
{
"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": [
{
"target": null,
"date_from": null,
"date_to": null,
"items_count": null,
"items": [
{
"type": null,
"date": null,
"rank": null,
"backlinks": null,
"new_backlinks": null,
"lost_backlinks": null,
"new_referring_domains": null,
"lost_referring_domains": null,
"crawled_pages": null,
"info": "[Max Depth Exceeded]",
"internal_links_count": null,
"external_links_count": null,
"broken_backlinks": null,
"broken_pages": null,
"referring_domains": null,
"referring_domains_nofollow": null,
"referring_main_domains": null,
"referring_main_domains_nofollow": null,
"referring_ips": null,
"referring_subnets": null,
"referring_pages": null,
"referring_pages_nofollow": null,
"referring_links_tld": null,
"referring_links_types": null,
"referring_links_attributes": null,
"referring_links_platform_types": null,
"referring_links_semantic_locations": null,
"referring_links_countries": null
}
]
}
]
}
]
}