DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Intersection de pages
Les pages liant plusieurs URL cibles à la fois, plutôt que les domaines. ⚠️ targets est un objet indexé par position et accepte des URL complètes, pas des domaines nus. Chaque ligne contient page_intersection et un summary par cible. L'équivalent au niveau du domaine est post_dataforseo_backlinks_domain_intersection_live, à consulter en premier.
Référence tarifaire
- Facturation : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.033.
- 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)[]
- backlinksType: string | null
_status _type définit les backlinks à renvoyer et à compter
champ facultatif
vous pouvez utiliser ce champ pour choisir les backlinks qui seront renvoyés et utilisés pour les métriques agrégées de vostargets;
valeurs possibles :all- tous les backlinks sont renvoyés et comptés ;live- les backlinks trouvés lors de la dernière vérification sont renvoyés et comptés ;lost- les backlinks perdus sont renvoyés et comptés ;valeur par défaut :
live - excludeType: boolean | null
_internal _backlinks indique si les backlinks internes des sous-domaines vers le
targetsont exclus des résultats
champ facultatif
s'il est défini surtrue, les résultats n'incluent pas de données sur les backlinks internes provenant de sous-domaines du même domaine que letarget
s'il est défini surfalse, les liens internes sont inclus dans le résultat
valeur par défaut :true - excludeType: array string[] | null
_targets domaines, sous-domaines ou pages web que vous souhaitez exclure
champ facultatif
vous pouvez définir jusqu'à 10 domaines, sous-domaines ou pages web
si vous utilisez ce tableau, les résultats contiendront les pages référentes qui pointent verstargetsmais pas versexclude_targets
exemple :"exclude_targets": [<br>"bbc.com",<br>"https://www.apple.com/iphone/*",<br>"https://dataforseo.com/apis/*"] - 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)
définissez un opérateur logiqueandouorentre les conditions
les opérateurs suivants sont pris en charge :regex,not_regex,=,<>,in,not_in,like,not_like,ilike,not_ilike,match,not_match
vous pouvez utiliser l'opérateur%aveclikeetnot_likepour correspondre à toute chaîne de zéro caractère ou plus
exemple :["1.rank",">","80"][["2.page_from_rank",">","55"],
"and",
["1.original","=","true"]][["1.first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["1.acnhor","like","%seo%"],"or",["1.text_pre","not_like","%seo%"]]]Objet vide - includeType: boolean | null
_indirect _links indique si les liens indirects vers les
targetssont inclus dans les résultats
champ facultatif
s'il est défini surtrue, les résultats incluent des données sur les liens indirects pointant vers une page qui redirige vers une cible ou pointe vers une page canonique
s'il est défini surfalse, les liens indirects sont ignorés
valeur par défaut :true - includeType: boolean | null
_subdomains indique si les sous-domaines des
targetssont inclus dans la recherche
champ facultatif
s'il est défini surfalse, les sous-domaines sont ignorés
valeur par défaut :true - internalType: integer | null
_list _limit nombre maximal d'éléments dans les tableaux internes
champ facultatif
vous pouvez utiliser ce champ pour limiter le nombre d'éléments dans les tableaux suivants :attributesdomain_from_platform_typevaleur par défaut :
10
valeur maximale :1000 - intersectionType: string | null
_mode indique s'il faut intersecter les backlinks
champ facultatif
utilisez ce champ pour intersecter ou fusionner les résultats des URL indiquées
valeurs possibles :all,partialall- les résultats reposent sur tous les backlinks ;partial- les résultats reposent uniquement sur les backlinks en intersection ;
valeur par défaut :all - limitType: integer | null
le nombre maximal de backlinks renvoyés
champ facultatifvaleur par défaut :
100
valeur maximale :1000 - offsetType: integer | null
décalage dans le tableau de résultats des backlinks renvoyés
champ facultatifvaleur par défaut :
0
si vous indiquez la valeur10, les dix premiers backlinks du tableau de résultats sont omis et les données sont fournies pour les backlinks suivants - 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 sont triés par ordre croissantdesc- les résultats sont triés par ordre décroissant
utilisez une virgule pour définir le type de tri
exemple :["rank,desc"]
notez que vous pouvez définir au maximum trois règles de tri dans une même requête
utilisez une virgule pour séparer plusieurs règles de tri
exemple :["domain_from_rank,desc","page_from_rank,asc"] - 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 - targetsType: object | null
domaines, sous-domaines ou pages web pour obtenir des liens
champ obligatoire
vous pouvez définir jusqu'à 20 domaines, sous-domaines ou pages web
un domaine ou un sous-domaine doit être indiqué sanshttps://niwww.
une page doit être indiquée avec une URL absolue (y comprishttp://ouhttps://)
exemple :"targets": {<br>"1": "http://planet.postgresql.org/",<br>"2": "http://gborg.postgresql.org/"<br>}- propertyType: string | null
Name
- Type: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo200
- 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_BacklinksPageIntersectionLiveTaskInfo
- 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 backlinks pertinents et les données des domaines référents
- pageType: object | null
_intersection contient des données sur les pages qui lient les cibles correspondantes indiquées dans le tableau POST
les données sont fournies dans des objets distincts correspondant aux pages indiquées dans l'objettargets- propertyType: array (object | null)[] | null
Name - altType: string | null
texte alternatif de l'image
ce champ vaudranullsi letypedu backlink n'est pas image - anchorType: string | null
texte d'ancre du backlink
- attributesType: array (string | null)[] | null
attributs de lien des liens référents
exemple :nofollow - backlinkType: integer | null
_spam _score - dofollowType: boolean | null
indique si le backlink est dofollow
s'il vautfalse, le backlink est nofollow - domainType: string | null
_from domaine faisant référence au domaine ou à la page web cible
- domainType: string | null
_from _country code pays ISO du domaine référent
- domainType: string | null
_from _ip adresse IP du domaine référent
- domainType: boolean | null
_from _is _ip indique si le domaine est une IP
s'il vauttrue, le domaine fonctionne comme une adresse IP et n'a pas de nom de domaine - domainType: array (string | null)[] | null
_from _platform _type types de plateforme du domaine référent
valeurs possibles :
cms,blogs,ecommerce,message-boards,wikis,news,organization - domainType: integer | null
_from _rank rang de domaine du domaine référent
indique le rang du domaine au moment où notre robot d'exploration a vu le backlink pour la dernière fois ;domain_from_rankest calculé selon la méthode de classement des nœuds dans une base de données liée — un principe utilisé dans l'algorithme PageRank original de Google
en savoir plus sur la métrique et son calcul dans cet article du centre d'aide - domainType: string | null
_to domaine vers lequel pointe le backlink
- firstType: string | null
_seen date et heure auxquelles notre robot d'exploration a trouvé le backlink 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 - groupType: integer | null Format: int64
_count indique le nombre total de backlinks provenant de ce domaine
par exemple, simodeest défini surone_per_domain, ce champ indiquera le nombre total de backlinks provenant de ce domaine - indirectType: array (object | null)[] | null
_link _path chemin du lien indirect
indique une URL ou une suite d'URL menant àurl_to- statusType: integer | null
_code code de statut général
vous trouverez la liste complète des codes de réponse ici
Remarque : nous vous recommandons vivement de concevoir un système nécessaire pour gérer les conditions exceptionnelles ou d'erreur associées - typeType: string | null
type d'élément
- urlType: string | null
URL du lien indirect
- isType: boolean | null
_broken indique si le backlink est brisé
s'il vauttrue, le backlink pointe vers une page qui répond avec un code de statut 4xx ou 5xx - isType: boolean | null
_indirect _link indique si le backlink est un lien indirect
s'il vauttrue, le backlink est un lien indirect pointant vers une page qui redirige versurl_toou pointe vers une page canonique - isType: boolean | null
_lost indique si le backlink a été supprimé
s'il vauttrue, le backlink ou la page entière a été supprimé - isType: boolean | null
_new indique si le backlink est nouveau
s'il vauttrue, le backlink a été trouvé sur la page lors de la dernière visite de notre robot d'exploration - itemType: string | null
_type type de lien
valeurs possibles :anchor,image,link,meta,canonical,alternate,redirect - lastType: string | null
_seen date la plus récente à laquelle notre robot d'exploration a visité le backlink
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - linksType: integer | null Format: int64
_count nombre de backlinks identiques trouvés sur la page référente
- originalType: boolean | null
indique si le backlink était présent sur la page référente lors de la première visite de notre robot d'exploration
- pageType: string | null
_from _encoding encodage de caractères de la page référente
exemple :utf-8 - pageType: integer | null
_from _external _links nombre de liens externes trouvés sur la page référente
- pageType: integer | null
_from _internal _links nombre de liens internes trouvés sur la page référente
- pageType: string | null
_from _language langue de la page référente
au format ISO 639-1
exemple :en - pageType: integer | null
_from _rank - pageType: integer | null
_from _size taille de la page référente, en octets
exemple :63357 - pageType: integer | null
_from _status _code code de statut HTTP renvoyé par la page référente
exemple :200 - pageType: string | null
_from _title titre de la page référente
- prevType: string | null
_seen date précédant la plus récente à laquelle notre robot d'exploration a visité le backlink
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - rankType: integer | null
- semanticType: string | null
_location - textType: string | null
_post extrait après le texte d'ancre
- textType: string | null
_pre extrait de texte avant le texte d'ancre
- tldType: string | null
_from domaine de premier niveau de l'URL référente
- typeType: string | null
type d'élément
- urlType: string | null
_from URL de la page où se trouve le backlink
- urlType: boolean | null
_from _https indique si l'URL référente est sécurisée par HTTPS
s'il vauttrue, l'URL référente est sécurisée par HTTPS - urlType: string | null
_to URL vers laquelle pointe le backlink
- urlType: boolean | null
_to _https indique si l'URL vers laquelle pointe le backlink est sécurisée par HTTPS
s'il vauttrue, l'URL est sécurisée par HTTPS - urlType: string | null
_to _redirect _target URL cible de la redirection
page cible vers laquelle la redirection pointe - urlType: integer | null
_to _spam _score - urlType: integer | null
_to _status _code code de statut de la page référencée
si la valeur estnull, notre robot d'exploration n'a pas encore visité la page web vers laquelle pointe le lien
exemple :200
- summaryType: object | null · Response36Afe1097B20_IntersectionSummaryInfo
contient le résumé des intersections de pages
- intersectionsType: integer | null Format: int64
_count nombre total d'intersections
- itemsType: integer | null Format: int64
_count le nombre de résultats renvoyés dans le tableau
items - targetsType: object | null
targetsd'un tableau POST- propertyType: string | null
Name
- totalType: integer | null Format: int64
_count quantité totale de résultats correspondant à la 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/backlinks/page_intersection/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"targets": {
"1": "football.com",
"2": "fifa.com"
},
"exclude_targets": [
"skysports.com"
],
"limit": 5,
"order_by": [
"1.rank,desc"
],
"filters": [
[
"2.domain_from_rank",
">",
400
],
"and",
[
"1.dofollow",
"=",
true
]
]
}
]'
{
"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": [
{
"targets": null,
"total_count": null,
"items_count": null,
"items": [
{
"page_intersection": null,
"summary": "[Max Depth Exceeded]"
}
]
}
]
}
]
}