v0.2.0-beta

OpenAPI 3.1.0

Ancres

Felo API Support

MIT

Serveur

https://openapi.felo.ai

Bibliothèques clientes

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Opérations

post/v1/beta/dataforseo/backlinks/anchors/live

Ancres

Les textes d'ancre pointant vers une target, une ligne par ancre distincte avec anchor, rank, backlinks, first_seen, lost_date, backlinks_spam_score, broken_backlinks et broken_pages. Utilisez-le pour voir comment le web décrit un site : les ancres sur-optimisées ressortent ici. La vue au niveau du lien est post_dataforseo_backlinks_backlinks_live ; celle au niveau du domaine est 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.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.

Corps

application/json

Type: array (object | null)[]
- backlinks_filters
  Type: array (object | null)[] | null
  
  filtrer 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 votre target
  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 backlinks flexible sur lequel calculer les métriques
  exemple :
  "backlinks_filters": [["dofollow", "=", true]]
  
  Objet vide
- backlinks_status_type
  Type: string | null
  
  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 votre target ;
  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
- exclude_internal_backlinks
  Type: boolean | null
  
  indique si les backlinks des sous-domaines du target sont exclus
  champ facultatif
  s'il est défini sur false, les backlinks des sous-domaines du target seront omis et vous ne recevrez pas le même domaine dans la réponse ;
  valeur par défaut : true
- filters
  Type: 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)
  vous devez définir un opérateur logique and, or entre 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 % avec like et not_like pour correspondre à toute chaîne de zéro ou plusieurs caractères
  exemple :
  ["referring_links_types.anchors",">","1"]
  
  [["broken_pages",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["anchor","like","%seo%"],"or",["referring_domains",">","10"]]]
  
  La liste complète des filtres possibles est disponible ici.
  
  Objet vide
- include_indirect_links
  Type: boolean | null
  
  indique si les liens indirects vers le target seront inclus dans les résultats
  champ facultatif
  s'il est défini sur true, les résultats incluront des données sur les liens indirects pointant vers une page qui redirige vers la cible ou pointe vers une page canonique
  s'il est défini sur false, les liens indirects seront ignorés
  valeur par défaut : true
- include_subdomains
  Type: boolean | null
  
  indique si les sous-domaines du target sont inclus dans la recherche
  champ facultatif
  s'il est défini sur false, les sous-domaines sont ignorés
  valeur par défaut : true
- internal_list_limit
  Type: integer | null
  
  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_tld
  referring_links_types
  referring_links_attributes
  referring_links_platform_types
  referring_links_semantic_locations
  
  valeur par défaut : 10
  valeur maximale : 1000
- limit
  Type: integer | null
  
  le nombre maximal d'ancres renvoyées
  champ facultatif
  valeur par défaut : 100
  valeur maximale : 1000
- offset
  Type: integer | null
  
  décalage dans le tableau de résultats des ancres renvoyées
  champ facultatif
  valeur par défaut : 0
  si vous indiquez la valeur 10, les dix premières ancres du tableau de résultats sont omises et les données sont fournies pour les ancres suivantes
- order_by
  Type: array string[] | null
  
  règles de tri des résultats
  champ facultatif
  vous pouvez utiliser les mêmes valeurs que dans le tableau filters pour trier les résultats
  types de tri possibles :
  asc - les résultats sont triés par ordre croissant
  desc - 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"]
- rank_scale
  Type: string | null
  
  définit l'échelle utilisée pour calculer et afficher les valeurs rank, domain_from_rank et page_from_rank
  champ facultatif
  
  vous 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–100
  one_thousand — les valeurs de rang sont affichées sur une échelle de 0–1000
  
  valeur par défaut : one_thousand
  
  en savoir plus sur le fonctionnement de ce paramètre et le calcul des métriques de classement dans cet article du centre d'aide
- tag
  Type: 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 valeur tag spécifiée dans l'objet data de la réponse
- target
  Type: string
  
  domaine, sous-domaine ou page web pour obtenir des ancres
  champ obligatoire
  un domaine ou un sous-domaine doit être indiqué sans https:// ni www.
  une page doit être indiquée avec une URL absolue (y compris http:// ou https://)

Réponses

200
Type: object | null · Response36Afe1097B20_BacklinksAnchorsLiveResponseInfo
cost
Type: number | null Format: double

coût total des tâches, USD

status_code
Type: integer | null

code d'état général vous pouvez trouver la liste complète des codes de réponse ici

status_message
Type: string | null

message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici

tasks
Type: array (object | null)[] | null

tableau de tâches

Type: object | null · Response36Afe1097B20_BacklinksAnchorsLiveTaskInfo
cost
Type: number | null Format: double

coût total des tâches, USD

data
Type: object | null

contient les mêmes paramètres que ceux spécifiés dans la requête POST

propertyName
Type: object | null
id
Type: string | null

identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID

path
Type: array (string | null)[] | null

chemin de l'URL

result
Type: array (object | null)[] | null

tableau de résultats

items
Type: array (object | null)[] | null

tableau items

anchor
Type: string | null

ancre du backlink

backlinks
Type: integer | null Format: int64

indique le nombre de backlinks

backlinks_spam_score
Type: integer | null Format: int64

score de spam moyen de tous les backlinks portant cette ancre
en savoir plus sur le calcul de la métrique sur cette page du centre d'aide

broken_backlinks
Type: integer | null Format: int64

nombre de backlinks brisés
nombre de backlinks brisés pointant vers la target

broken_pages
Type: integer | null

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

first_seen
Type: string | null

date et heure auxquelles notre robot d'exploration a trouvé le backlink portant cette ancre 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

lost_date
Type: string | null

date et heure auxquelles le dernier backlink portant cette ancre a é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 :
2017-01-24 13:20:59 +00:00

rank
Type: integer | null

rang des liens d'ancre
volume de rang que les sites référents transmettent à la target via des liens portant une ancre donnée
rank est 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

referring_domains
Type: integer | null Format: int64

indique le nombre de domaines référents

referring_domains_nofollow
Type: integer | null Format: int64

nombre de domaines pointant au moins un lien nofollow vers la target

referring_ips
Type: integer | null Format: int64

nombre d'adresses IP référentes
nombre d'adresses IP pointant vers cette page

referring_links_attributes
Type: object | null

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

propertyName
Type: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_countries
Type: object | null

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

propertyName
Type: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_platform_types
Type: object | null

types de plateformes référentes
indique les types de plateformes référentes et le nombre de liens par plateforme

valeurs possibles : cms, blogs, ecommerce, message-boards, wikis, news, organization

propertyName
Type: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
Type: object | null

emplacements sémantiques des liens référents
indique les éléments sémantiques HTML où se trouvent les liens référents et le nombre de liens par emplacement sémantique

vous pouvez obtenir la liste complète des éléments sémantiques ici
exemples :
article, section, summary

propertyName
Type: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_tld
Type: object | null

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

propertyName
Type: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_types
Type: object | null

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

propertyName
Type: integer | null Format: int64

Signed 64-bit integers (long type).

referring_main_domains
Type: integer | null Format: int64

indique le nombre de domaines principaux référents

referring_main_domains_nofollow
Type: integer | null Format: int64

nombre de domaines principaux pointant au moins un lien nofollow vers la target

referring_pages
Type: integer | null Format: int64

indique le nombre de pages pointant vers la target avec cette ancre

referring_pages_nofollow
Type: integer | null Format: int64

nombre de pages référentes pointant au moins un lien nofollow vers la target avec cette ancre

referring_subnets
Type: integer | null Format: int64

nombre de sous-réseaux référents

type
Type: string | null

type d'élément

items_count
Type: integer | null Format: int64

nombre d'éléments du tableau de résultats

target
Type: string | null

target dans le tableau POST

total_count
Type: integer | null Format: int64

nombre total d'éléments pertinents dans la base de données

result_count
Type: integer | null Format: int64

nombre d'éléments dans le tableau de résultats

status_code
Type: integer | null

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

status_message
Type: string | null

message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici

time
Type: string | null

temps d'exécution, en secondes

tasks_count
Type: integer | null Format: int64

le nombre de tâches dans le tableau de tâches

tasks_error
Type: integer | null Format: int64

le nombre de tâches dans le tableau de tâches renvoyées avec une erreur

time
Type: string | null

temps d'exécution total, en secondes

version
Type: string | null

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

post/v1/beta/dataforseo/backlinks/anchors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/anchors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 4,
    "order_by": [
      "backlinks,desc"
    ],
    "filters": [
      "anchor",
      "like",
      "%news%"
    ]
  }
]'

Afficher le schéma

{
  "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,
              "anchor": null,
              "rank": null,
              "backlinks": null,
              "first_seen": null,
              "lost_date": null,
              "backlinks_spam_score": 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
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Ancres

AuthentificationRequired

DataForSEO

Ancres

Référence tarifaire