DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Pages du domaine
Les pages d'une target qui ont des liens entrants, avec la vision du robot d'exploration pour chacune : main_domain, domain, tld, page, ip, first_visited, prev_visited et fetch_time. Utilisez-le pour savoir quelles pages gagnent réellement des liens. Pour des comptages de liens par page plutôt que des métadonnées d'exploration, utilisez post_dataforseo_backlinks_domain_pages_summary_live.
Référence tarifaire
- Facturation : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.0276.
- 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 ;
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 les résultats
valeur par défaut :true - 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 :["meta.internal_links_count",">","1"][["meta.external_links_count",">","2"],
"and",
["backlinks",">","10"]][["first_visited",">","2017-10-23 11:31:45 +00:00"],
"and",
[["title","like","%seo%"],"or",["referring_domains",">","10"]]]Objet vide - 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 - limitType: integer | null
le nombre maximal de pages renvoyées
champ facultatif
valeur par défaut :100
valeur maximale :1000 - offsetType: integer | null
décalage dans le tableau de résultats des pages renvoyées
champ facultatif
valeur par défaut :0
si vous spécifiez la valeur10, les dix premières pages du tableau de résultats seront omises et les données seront fournies pour les pages suivantes - 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 :["page_summary.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 :["page_summary.backlinks,desc","page_summary.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 - targetType: string
domaine ou sous-domaine
champ obligatoire
un domaine ou un sous-domaine doit être indiqué sanshttps://niwww.
exemple :forbes.com
- Type: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveResponseInfo200
- 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_BacklinksDomainPagesLiveTaskInfo
- 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
tableau items
- contentType: string | null
_encoding type d'encodage
- domainType: string | null
domaine
domaine où la page a été trouvée - encodedType: integer | null
_size taille de la page après encodage
indique la taille de la page encodée, en octets - fetchType: string | null
_time date et heure les plus récentes auxquelles notre robot d'exploration a visité la page
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2017-01-24 13:20:59 +00:00 - firstType: string | null
_visited date et heure de la première visite de la page
date et heure auxquelles notre robot d'exploration a visité cette page pour la première fois
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2017-01-24 13:20:59 +00:00 - ipType: string | null
adresse IP
- locationType: string | null
en-tête de localisation
indique l'URL vers laquelle rediriger une page, si elle existe - mainType: string | null
_domain domaine principal du site web
le domaine principal du site web n'inclut pas les sous-domaines - mediaType: string | null
_type types de médias utilisés pour afficher une page
- metaType: object | null · Response36Afe1097B20_BacklinksPageMeta
métadonnées de la page
- canonicalType: string | null
page canonique
- charsetType: string | null
encodage de caractères
exemples :utf-8 - externalType: integer | null Format: int64
_links _count nombre de liens externes sur la page
- h1Type: array (string | null)[] | null
balise h1
contenu des balisesh1 - h2Type: array (string | null)[] | null
balise h2
contenu des balisesh2 - h3Type: array (string | null)[] | null
balise h3
contenu des balisesh3 - imagesType: array (string | null)[] | null
_alt contenu des balises
alt - imagesType: integer | null Format: int64
_count nombre d'images sur la page
- internalType: integer | null Format: int64
_links _count nombre de liens internes sur la page
- languageType: string | null
langue du contenu de la page
exemple :en - pageType: integer | null
_spam _score - platformType: array (string | null)[] | null
_type type de plateforme
- poweredType: array (string | null)[] | null
_by détails du CMS
- socialType: object | null
_media _tags - propertyType: string | null
Name
- technologiesType: object | null
technologies du site web
- propertyType: string | null
Name
- titleType: string | null
titre de la page
- wordsType: integer | null Format: int64
_count nombre de mots sur la page
- pageType: string | null
URL de la page
URL de la page concernée - pageType: object | null · Response36Afe1097B20_PageSummary
_summary contient les données de backlinks de cette page
- 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 liens entrants brisés
nombre de liens entrants brisés pointant vers lapage - brokenType: integer | null
_pages nombre de pages brisées
nombre de pages qui répondent avec des codes de statut 4xx ou 5xx et vers lesquelles pointent les backlinks - 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 - lostType: string | null
_date date et heure auxquelles le dernier lien entrant de cette page a été perdu
indique la date et l'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 lien entrant a été supprimé
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2017-01-24 13:20:59 +00:00 - rankType: integer | null
- referringType: integer | null Format: int64
_domains indique le nombre de domaines référents
- referringType: integer | null Format: int64
_domains _nofollow nombre de domaines pointant au moins un lien nofollow vers la
page - 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 - propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringType: object | null
_links _countries - propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringType: object | null
_links _platform _types - 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 - propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringType: object | null
_links _types - propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringType: integer | null Format: int64
_main _domains indique le nombre de domaines principaux référents
- referringType: integer | null Format: int64
_main _domains _nofollow Signed 64-bit integers (long type).
- referringType: integer | null Format: int64
_pages indique le nombre de pages pointant vers la
page - referringType: integer | null Format: int64
_pages _nofollow nombre de pages référentes pointant au moins un lien nofollow vers la
page - referringType: integer | null Format: int64
_subnets nombre de sous-réseaux référents
- prevType: string | null
_visited date précédant la plus récente à laquelle notre robot d'exploration a visité la page
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2017-01-24 13:20:59 +00:00 - serverType: string | null
version du serveur
- sizeType: integer | null
indique la taille de la page, en octets
- 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 - tldType: string | null
- typeType: string | null
type d'élément
- itemsType: integer | null Format: int64
_count nombre d'éléments du tableau
items - targetType: string | null
targetdans un tableau POST - totalType: integer | null Format: int64
_count nombre total d'éléments pertinents dans la base de données
- 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_pages/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"limit": 5,
"filters": [
[
"page_summary.backlinks",
">",
5
],
"and",
[
"page",
"like",
"%sites%"
]
]
}
]'
{
"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,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"main_domain": null,
"domain": null,
"tld": null,
"page": null,
"ip": null,
"first_visited": null,
"prev_visited": null,
"fetch_time": null,
"status_code": null,
"location": null,
"size": null,
"encoded_size": null,
"content_encoding": null,
"media_type": null,
"server": null,
"meta": {
"0": "[",
"1": "M",
"2": "a",
"3": "x",
"4": " ",
"5": "D",
"6": "e",
"7": "p",
"8": "t",
"9": "h",
"10": " ",
"11": "E",
"12": "x",
"13": "c",
"14": "e",
"15": "e",
"16": "d",
"17": "e",
"18": "d",
"19": "]",
"social_media_tags": "[Max Depth Exceeded]"
},
"page_summary": {
"0": "[",
"1": "M",
"2": "a",
"3": "x",
"4": " ",
"5": "D",
"6": "e",
"7": "p",
"8": "t",
"9": "h",
"10": " ",
"11": "E",
"12": "x",
"13": "c",
"14": "e",
"15": "e",
"16": "d",
"17": "e",
"18": "d",
"19": "]",
"referring_main_domains_nofollow": "[Max Depth Exceeded]",
"referring_links_tld": "[Max Depth Exceeded]",
"referring_links_types": "[Max Depth Exceeded]",
"referring_links_attributes": "[Max Depth Exceeded]",
"referring_links_platform_types": "[Max Depth Exceeded]",
"referring_links_semantic_locations": "[Max Depth Exceeded]",
"referring_links_countries": "[Max Depth Exceeded]"
}
}
]
}
]
}
]
}