v0.2.0-beta

OpenAPI 3.1.0

Domaines référents nouveaux et perdus en masse

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

Domaines référents nouveaux et perdus en masse

Domaines référents nouveaux et perdus pour de nombreuses targets depuis date_from : new_referring_domains, lost_referring_domains, new_referring_main_domains et lost_referring_main_domains par cible. Préférez ceci à post_dataforseo_backlinks_bulk_new_lost_backlinks_live pour juger si un site gagne réellement des relations : les domaines changent moins que les liens. 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.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.

Corps

application/json

Type: array (object | null)[]
- date_from
 Type: string | null
 
 date de début de la plage temporelle
 champ facultatif
 ce champ indique la date utilisée comme seuil pour les domaines référents nouveaux et perdus ;
 les domaines référents apparus dans notre index après la date indiquée sont considérés comme nouveaux ;
 les domaines référents introuvables après la date indiquée, mais présents auparavant, sont considérés comme perdus ;
 
 valeur par défaut : date du jour -(moins) un mois ;
 par ex., si aujourd'hui est le 2021-10-13, le date_from par défaut sera 2021-09-13.
 la valeur minimale correspond à la date du jour -(moins) un an ;
 par ex., si aujourd'hui est le 2021-10-13, le date_from minimal sera 2020-10-13.
 
 format de date : "yyyy-mm-dd"
 exemple :
 "2021-01-01"
- 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
- targets
 Type: array string[]
 
 domaines, sous-domaines ou pages web pour obtenir les nouveaux domaines référents et les domaines référents perdus
 champ obligatoire
 vous pouvez définir jusqu'à 1000 domaines, sous-domaines ou pages web
 le domaine ou le sous-domaine doit être indiqué sans https:// ni www.
 la page doit être indiquée avec une URL absolue (y compris http:// ou https://)
 exemple :
 "targets": [ "forbes.com", "cnn.com", "bbc.com", "yelp.com", "https://www.apple.com/iphone/", "https://ahrefs.com/blog/", "ibm.com", "https://variety.com/", "https://stackoverflow.com/", "www.trustpilot.com" ]

Réponses

200
Type: object | null · Response36Afe1097B20_BacklinksBulkNewLostReferringDomainsLiveResponseInfo
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_BacklinksBulkNewLostReferringDomainsLiveTaskInfo
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

contient les backlinks pertinents et les données des domaines référents

lost_referring_domains
Type: integer | null Format: int64

nombre de domaines référents perdus
nombre de domaines référents perdus de la target

lost_referring_main_domains
Type: integer | null Format: int64

nombre de domaines principaux référents perdus pointant vers la target

new_referring_domains
Type: integer | null Format: int64

nombre de nouveaux domaines référents
nombre de nouveaux domaines référents pointant vers la target

new_referring_main_domains
Type: integer | null Format: int64

nombre de nouveaux domaines principaux référents pointant vers la target

target
Type: string | null

domaine, sous-domaine ou page web d'un tableau POST

items_count
Type: integer | null Format: int64

le nombre de résultats renvoyés dans le tableau items

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

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/bulk_new_lost_referring_domains/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      "forbes.com",
      "cnn.com",
      "bbc.com",
      "yelp.com",
      "https://www.apple.com/iphone/",
      "https://ahrefs.com/blog/",
      "ibm.com",
      "https://variety.com/",
      "https://stackoverflow.com/",
      "www.trustpilot.com"
    ],
    "datetime_from": "2026-12-31"
  }
]'

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": [
        {
          "items_count": null,
          "items": [
            {
              "target": null,
              "new_referring_domains": null,
              "lost_referring_domains": null,
              "new_referring_main_domains": null,
              "lost_referring_main_domains": null
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Domaines référents nouveaux et perdus en masse

AuthentificationRequired

DataForSEO

Domaines référents nouveaux et perdus en masse

Référence tarifaire