DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Liens entrants
Les liens entrants individuels d'une target, une ligne par lien. Renvoie total_count, items_count, items et un search_after_token pour la pagination : utilisez-le plutôt que offset au-delà des premières pages. mode et custom_mode contrôlent le regroupement, backlinks_status_type sélectionne live, lost ou all. Pour des comptages plutôt que des lignes, utilisez post_dataforseo_backlinks_summary_live ; pour les domaines liants regroupés, post_dataforseo_backlinks_referring_domains_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: string | null
_status _type définir 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 votretarget;
valeurs possibles :all- tous les backlinks seront renvoyés et comptés ;live- les backlinks trouvés lors de la dernière vérification seront renvoyés et comptés ;lost- les backlinks perdus seront renvoyés et comptés ;valeur par défaut :
live - customType: object | null
_mode type de regroupement détaillé des résultats
champ facultatif
utilisez cet objet pour obtenir un nombre précis de backlinks parfield
si vous utilisezcustom_mode,modeest ignoré
exemple :"custom_mode": {"field": "domain", "value": 100}- propertyType: object | null
Name
- 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 :=,<>,in,not_in,like,not_like,ilike,not_ilike,regex,not_regex,match,not_match
vous pouvez utiliser l'opérateur%aveclikeetnot_likepour correspondre à toute chaîne de zéro caractère ou plus
exemple :["rank",">","80"][["page_from_rank",">","55"],
"and",
["dofollow","=",true]][["first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]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 - limitType: integer | null
le nombre maximal de backlinks renvoyés
champ facultatifvaleur par défaut :
100
valeur maximale :1000 - modeType: string | null
type de regroupement des résultats
champ facultatif
types de regroupement possibles :as_is- renvoie tous les backlinksone_per_domain- renvoie un backlink par domaineone_per_anchor- renvoie un backlink par ancrevaleur par défaut :
as_is - 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 ;
Remarque : la valeur maximale est20,000, utilisez lesearch_after_tokensi vous souhaitez décaler davantage de résultats - 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
- searchType: string | null
_after _token jeton pour les requêtes suivantes
champ facultatif
fourni dans le champ identique de la réponse à chaque requête ;
utilisez ce paramètre pour éviter les délais d'attente lorsque vous essayez d'obtenir plus de20,000résultats en une seule requête ;
en indiquant la valeur uniquesearch_after_tokendu tableau de réponse, vous obtiendrez les résultats suivants de la tâche initiale ;
les valeurssearch_after_tokensont uniques pour chaque tâche suivante ;
Remarque : si lesearch_after_tokenest indiqué dans la requête, tous les autres paramètres doivent être identiques à ceux de la requête précédente - 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, sous-domaine ou page web pour obtenir des backlinks
champ obligatoire
un domaine ou un sous-domaine doit être indiqué sanshttps://niwww.
une page doit être indiquée avec une URL absolue (y comprishttp://ouhttps://)
- Type: object | null · Response36Afe1097B20_BacklinksBacklinksLiveResponseInfo200
- 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_BacklinksBacklinksLiveTaskInfo
- 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
- customType: object | null
_mode mode personnalisé indiqué dans un tableau POST
- propertyType: object | null
Name
- itemsType: array (object | null)[] | null
contient les backlinks pertinents et les données des domaines référents
- 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 - 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 - imageType: string | null
_url URL de l'image
l'URL menant à l'image sur la ressource d'origine ou dans le stockage DataForSEO (si la source d'origine n'est pas disponible) - 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,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
- rankedType: object | null · Response36Afe1097B20_RankedKeywordsInfo
_keywords _info - pageType: integer | null Format: int64
_from _keywords _count _top _10 Signed 64-bit integers (long type).
- pageType: integer | null Format: int64
_from _keywords _count _top _100 Signed 64-bit integers (long type).
- pageType: integer | null Format: int64
_from _keywords _count _top _3 Signed 64-bit integers (long type).
- semanticType: string | null
_location - textType: string | null
_post extrait après le texte d'ancre
- textType: string | null
_pre extrait 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
- itemsType: integer | null Format: int64
_count le nombre de résultats renvoyés dans le tableau
items - modeType: string | null
mode indiqué dans un tableau POST
- searchType: string | null
_after _token jeton pour les requêtes suivantes
en indiquant lesearch_after_tokenunique lors de la définition d'une nouvelle tâche, vous obtiendrez les résultats suivants de la tâche initiale ;
les valeurs desearch_after_tokensont uniques pour chaque tâche suivante - targetType: string | null
domaine cible dans un tableau POST
- 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/backlinks/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"mode": "as_is",
"filters": [
"dofollow",
"=",
true
],
"limit": 5
}
]'
{
"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,
"mode": null,
"custom_mode": null,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"domain_from": null,
"url_from": null,
"url_from_https": null,
"domain_to": null,
"url_to": null,
"url_to_https": null,
"tld_from": null,
"is_new": null,
"is_lost": null,
"backlink_spam_score": null,
"rank": null,
"page_from_rank": null,
"domain_from_rank": null,
"domain_from_platform_type": [
"[Max Depth Exceeded]"
],
"domain_from_is_ip": null,
"domain_from_ip": null,
"domain_from_country": null,
"page_from_external_links": null,
"page_from_internal_links": null,
"page_from_size": null,
"page_from_encoding": null,
"page_from_language": null,
"page_from_title": null,
"page_from_status_code": null,
"first_seen": null,
"prev_seen": null,
"last_seen": null,
"item_type": null,
"attributes": [
"[Max Depth Exceeded]"
],
"dofollow": null,
"original": null,
"alt": null,
"image_url": null,
"anchor": null,
"text_pre": null,
"text_post": null,
"semantic_location": null,
"links_count": null,
"group_count": null,
"is_broken": null,
"url_to_status_code": null,
"url_to_spam_score": null,
"url_to_redirect_target": null,
"ranked_keywords_info": "[Max Depth Exceeded]",
"is_indirect_link": null,
"indirect_link_path": [
"[Max Depth Exceeded]"
]
}
],
"search_after_token": null
}
]
}
]
}