Felo API PlatformFelo API Platform
Tous les endpoints DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Résumé des liens entrants

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

Résumé des liens entrants

​

Le profil de liens entrants complet d'une target en un seul appel : first_seen, lost_date, rank, backlinks, backlinks_spam_score, crawled_pages, internal_links_count et un bloc info, avec les comptages de domaines référents et d'ancres à côté. C'est le point central de la famille : commencez ici, puis approfondissez la partie qui compte : post_dataforseo_backlinks_backlinks_live pour les liens individuels, post_dataforseo_backlinks_referring_domains_live pour savoir qui lie, post_dataforseo_backlinks_anchors_live pour le texte utilisé. Ce point de terminaison n'accepte pas de paramètre de limite : le seul levier est de l'appeler moins souvent.

Référence tarifaire

  • Facturation : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.024.
  • 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

      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 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 données de backlinks flexible pour 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 internes des sous-domaines vers le target sont exclus des résultats
      champ facultatif
      s'il est défini sur true, les résultats n'incluent pas de données sur les backlinks internes provenant de sous-domaines du même domaine que le target
      s'il est défini sur false, les liens internes sont inclus dans les résultats
      valeur par défaut : true

    • 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

    • 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 données
      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_BacklinksSummaryLiveResponseInfo
    • 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_BacklinksSummaryLiveTaskInfo
        • 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

          • backlinks
            Type: integer | null Format: int64

            indique le nombre de backlinks

          • backlinks_spam_score
            Type: integer | null Format: int64

            score de spam des backlinks
            affiche le score de spam total de tous les backlinks pointant vers le domaine, sous-domaine ou page web de la target ;
            pour en savoir plus sur le calcul de la métrique, consultez 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 de la target qui répondent avec des codes de statut 4xx ou 5xx

            notez que le nombre de pages brisées inclut les pages de la target découvertes en suivant des liens externes, mais peut aussi inclure des pages découvertes en suivant le sitemap de la cible

          • crawled_pages
            Type: integer | null

            nombre de pages crawlées pour la target

          • external_links_count
            Type: integer | null Format: int64

            nombre de liens externes sur la page
            calculé comme la somme des liens externes sur les pages de la target indiquée

          • first_seen
            Type: string | null

            date et heure auxquelles notre robot d'exploration a trouvé le backlink de la target 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

          • info
            Type: object | null · Response36Afe1097B20_TargetInfo

            informations sur la target

            • cms
              Type: string | null

              système de gestion de contenu

            • country
              Type: string | null

              code du pays auquel appartient le domaine target

            • ip_address
              Type: string | null

              adresse IP de la target

            • is_ip
              Type: boolean | null

              indique si la target est une IP
              si true, le domaine, sous-domaine ou page web fait office d'adresse IP et n'a pas de nom de domaine

            • platform_type
              Type: array (string | null)[] | null

              type de plateforme

            • server
              Type: string | null

              serveur

            • target_spam_score
              Type: integer | null

              score de spam de la target
              si la target est un domaine/sous-domaine, ce champ indique le score de spam moyen de toutes les pages de ce domaine/sous-domaine ;
              en savoir plus sur le calcul de cette métrique sur cette page du centre d'aide

          • internal_links_count
            Type: integer | null Format: int64

            nombre de liens internes
            calculé comme la somme des liens internes sur les pages de la target indiquée

          • lost_date
            Type: string | null

            date et heure auxquelles le backlink a été perdu
            indique la date et heure auxquelles notre robot d'exploration a visité la cible et où celle-ci a répondu avec un code de statut 4xx ou 5xx, ou auxquelles son 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

          • rank
            Type: integer | null

            rang de la target
            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
            les domaines référents incluent les sous-domaines comptés comme des domaines distincts pour cette métrique

          • 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
            valeurs d'exemple :
            nofollow, noopener, noreferrer, external, ugc, sponsored

            • 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
            valeurs d'exemple :
            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 cible

          • referring_pages_nofollow
            Type: integer | null Format: int64

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

          • referring_subnets
            Type: integer | null Format: int64

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

          • target
            Type: string | null

            target dans un tableau POST

        • 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
Request Example for post/v1/beta/dataforseo/backlinks/summary/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "explodingtopics.com",
    "internal_list_limit": 10,
    "include_subdomains": true,
    "backlinks_filters": [
      "dofollow",
      "=",
      true
    ],
    "backlinks_status_type": "all"
  }
]'

{
  "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,
          "first_seen": null,
          "lost_date": null,
          "rank": null,
          "backlinks": null,
          "backlinks_spam_score": null,
          "crawled_pages": null,
          "info": {
            "server": null,
            "cms": null,
            "platform_type": [
              "[Max Depth Exceeded]"
            ],
            "ip_address": null,
            "country": null,
            "is_ip": null,
            "target_spam_score": null
          },
          "internal_links_count": null,
          "external_links_count": 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

Backlinks Summary