v0.2.0-beta

OpenAPI 3.1.0

Concurrents

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/competitors/live

Concurrents

Sites partageant des domaines référents avec une target, classés par nombre de partages. Chaque ligne donne target, rank et intersections : le nombre de domaines liants partagés. main_domain, exclude_large_domains et exclude_internal_backlinks déterminent ce qui compte. Ce sont des concurrents dans le graphe de liens, pas des concurrents de recherche ; pour ces derniers, utilisez post_dataforseo_labs_google_serp_competitors_live. Pour voir les domaines réellement partagés, utilisez post_dataforseo_backlinks_domain_intersection_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.

Corps

application/json

Type: array (object | null)[]
- 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
- exclude_large_domains
  Type: boolean | null
  
  indique si les domaines volumineux apparaissent dans les résultats
  champ facultatif
  s'il est défini sur true, les résultats du domaine volumineux (google.com, amazon.com, etc.) sont omis ;
  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)
  définissez un opérateur logique and ou 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 caractère ou plus
  exemple :
  ["rank",">","100"]
  
  [["target","like","%forbes%"], "and", [["rank",">","100"],"or",["intersections",">","5"]]]
  
  La liste complète des filtres possibles est disponible ici.
  
  Objet vide
- limit
  Type: integer | null
  
  nombre maximal de domaines renvoyés
  champ facultatif
  valeur par défaut : 100
  valeur maximale : 1000
- main_domain
  Type: boolean | null
  
  indique si seul le domaine principal du target est inclus dans la recherche
  champ facultatif
  s'il est défini sur true, seul le domaine principal est inclus dans la recherche ;
  valeur par défaut : true
- offset
  Type: integer | null
  
  décalage dans le tableau de résultats des domaines renvoyés
  champ facultatif
  valeur par défaut : 0
  si vous indiquez la valeur 10, les dix premiers domaines du tableau de résultats sont omis et les données sont fournies pour les pages 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 un paramètre 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 :
  ["intersections,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 domaines concurrents
  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_BacklinksCompetitorsLiveResponseInfo
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_BacklinksCompetitorsLiveTaskInfo
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

intersections
Type: integer | null

indique le nombre d'intersections de backlinks avec la target indiquée dans le tableau POST

rank
Type: integer | null

rang de domaine
rang de domaine sur l'ensemble des domaines de la base de données
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

target
Type: string | null

domaine concurrent

type
Type: string | null

type d'élément

items_count
Type: integer | null Format: int64

nombre d'éléments du tableau items

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/competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "filters": [
      "rank",
      ">",
      100
    ],
    "order_by": [
      "rank,desc"
    ],
    "limit": 5
  }
]'

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": [
        {
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "target": null,
              "rank": null,
              "intersections": null
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Concurrents

AuthentificationRequired

DataForSEO

Concurrents

Référence tarifaire