DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Intersection de domaines
Les domaines liant plusieurs cibles à la fois. ⚠️ Ici, targets est un objet indexé par position — {"1": "a.com", "2": "b.com"} — et non le tableau qu'attendent les endpoints en masse. exclude_targets retire des sites de la comparaison. Chaque ligne contient domain_intersection et un summary par cible. Utilisez-le pour trouver qui lie vos concurrents mais pas vous. L'équivalent au niveau de la page est post_dataforseo_backlinks_page_intersection_live.
Référence tarifaire
- Facturation : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.06.
- 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: array (object | null)[] | null
_filters filtrez les backlinks de votre
target
champ facultatif
vous pouvez utiliser ce champ pour filtrer les backlinks initiaux qui seront inclus dans le jeu de données des métriques agrégées de votretarget
vous pouvez filtrer les backlinks par tous les champs disponibles dans la réponse de ce point de terminaison
avec ce paramètre, vous pouvez inclure uniquement les backlinks dofollow dans la réponse et créer un jeu de données de backlinks flexible pour calculer les métriques
exemple :"backlinks_filters": [["dofollow", "=", true]]Objet vide - 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 des sous-domaines du
targetsont exclus
champ facultatif
s'il est défini surfalse, les backlinks des sous-domaines dutargetsont omis et vous ne recevrez pas le même domaine dans la réponse ;
valeur par défaut :true - excludeType: array string[] | null
_targets domaines, sous-domaines ou pages web que vous souhaitez exclure
champ facultatif
vous pouvez indiquer jusqu'à 10 domaines, sous-domaines ou pages web
si vous utilisez ce tableau, les résultats contiendront les domaines référents 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.internal_links_count",">","1"][["2.referring_pages",">","2"],
"and",
["1.backlinks",">","10"]][["1.first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["2.target","like","%dataforseo.com%"],"or",["1.referring_domains",">","10"]]]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 du
targetsont 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 :referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locationsvaleur 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 domaines indiqués
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 résultats renvoyés
champ facultatif
valeur par défaut :100
valeur maximale :1000 - offsetType: integer | null
décalage dans le tableau de résultats renvoyés
champ facultatif
valeur 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 :["backlinks,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 :["backlinks,desc","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_BacklinksDomainIntersectionLiveResponseInfo200
- 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_BacklinksDomainIntersectionLiveTaskInfo
- 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 domaines qui lient toutes les
targetsdu tableau POST- domainType: object | null
_intersection contient des données sur les domaines qui lient les cibles correspondantes indiquées dans le tableau POST
les données sont fournies dans des objets distincts correspondant aux domaines, sous-domaines ou pages indiqués dans l'objettargets- propertyType: object | null · Response36Afe1097B20_BacklinksDomainIntersection
Name - backlinksType: integer | null Format: int64
indique le nombre de backlinks
- backlinksType: integer | null Format: int64
_spam _score - brokenType: integer | null Format: int64
_backlinks nombre de backlinks brisés
- brokenType: integer | null
_pages nombre de pages brisées
- firstType: string | null
_seen date et heure auxquelles notre robot d'exploration a trouvé le backlink de cette
targetpour la première fois
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - lostType: string | null
_date date et heure auxquelles le dernier backlink de cette
targeta été perdu
indique la date et heure auxquelles notre robot d'exploration a visité la page et où celle-ci a répondu avec un code de statut 4xx ou 5xx, ou auxquelles le dernier backlink a été supprimé
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - rankType: integer | null
rang transmis à la
targetdepuis le tableau POST
indique le rang que le domaine référent (targetci-dessus) transmet à votre cible du tableau POST ;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 - referringType: integer | null Format: int64
_domains nombre de domaines référents
- referringType: integer | null Format: int64
_domains _nofollow nombre de domaines pointant au moins un lien nofollow vers la cible correspondante
- referringType: integer | null Format: int64
_ips nombre d'adresses IP référentes
- 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
Name Integer numbers.
- 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 - 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
Name Integer numbers.
- referringType: object | null
_links _semantic _locations - propertyType: integer | null
Name Integer numbers.
- 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
Name Integer numbers.
- referringType: object | null
_links _types types des liens référents
indique les types de liens référents et le nombre de liens par type
valeurs possibles :anchor,image,link,meta,canonical,alternate,redirect- propertyType: integer | null
Name Integer numbers.
- 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 indique le 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
- targetType: string | null
domaine qui lie la cible correspondante du tableau POST
- typeType: string | null
type d'élément
- summaryType: object | null · Response36Afe1097B20_IntersectionSummaryInfo
contient le résumé des intersections de domaines
- 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
domaines, sous-domaines ou pages web cibles dans un tableau POST
- propertyType: string | null
Name
- totalType: integer | null Format: int64
_count quantité totale de résultats 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/backlinks/domain_intersection/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"targets": {
"1": "moz.com",
"2": "ahrefs.com"
},
"include_subdomains": false,
"exclude_targets": [
"semrush.com"
],
"limit": 5,
"order_by": [
"1.backlinks,desc"
],
"exclude_internal_backlinks": 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": [
{
"domain_intersection": null,
"summary": "[Max Depth Exceeded]"
}
]
}
]
}
]
}