v0.2.0-beta

OpenAPI 3.1.0

Résumé des séries temporelles de liens entrants nouveaux et perdus

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

Résumé des séries temporelles de liens entrants nouveaux et perdus

Liens entrants et domaines référents nouveaux et perdus pour une target par période, regroupés par group_range. C'est la dérivée de post_dataforseo_backlinks_timeseries_summary_live : l'un donne le niveau, l'autre la variation. Un total stable qui masque une forte rotation n'apparaît qu'ici. Pour les mêmes chiffres sur de nombreuses cibles à la fois, utilisez post_dataforseo_backlinks_bulk_new_lost_backlinks_live. 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.0372.
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 backlinks et domaines référents nouveaux et perdus ;
  les backlinks et domaines référents apparus dans notre index après la date indiquée sont considérés comme nouveaux ;
  les backlinks et domaines référents introuvables après la date indiquée, mais présents auparavant, sont considérés comme perdus ;
  
  valeur minimale : 2019-01-30
  la valeur maximale ne doit pas dépasser la date indiquée dans date_to
  format de date : "yyyy-mm-dd"
  exemple :
  "2021-01-01"
- date_to
  Type: string | null
  
  date de fin de la plage temporelle
  champ facultatif
  si vous n'indiquez pas ce champ, la date du jour est utilisée par défaut
  la valeur minimale ne doit pas précéder la date indiquée dans date_from
  valeur maximale : date du jour
  format de date : "yyyy-mm-dd"
  exemple :
  "2021-01-15"
- group_range
  Type: string | null
  
  plage temporelle utilisée pour regrouper les résultats
  champ facultatif
  valeur par défaut : month
  valeurs possibles : day, week, month, year
  
  remarque : pour day, nous renvoyons les éléments correspondant à toutes les dates comprises entre date_from et date_to, incluses ;
  pour week/month/year, nous renvoyons les éléments correspondant à des semaines/mois/années complètes, chaque élément indiquant le dernier jour de la semaine/du mois/de l'année
  
  par exemple, si vous indiquez :
  "group_range": "month", "date_from": "2022-03-23", "date_to": "2022-05-13"
  nous renvoyons les éléments compris entre 2022-03-01 et 2022-05-31, soit trois éléments correspondant aux dates suivantes : 2022-03-31, 2022-04-30, 2022-05-31
  
  s'il n'y a pas de données pour un day/week/month/year donné, nous renvoyons 0
- 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
- 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 pour obtenir des données
  champ obligatoire
  un domaine doit être indiqué sans https:// ni www.
  exemple :
  "forbes.com"

Réponses

200
Type: object | null · Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveResponseInfo
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_BacklinksTimeseriesNewLostSummaryLiveTaskInfo
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

date_from
Type: string | null

date de début de la plage temporelle
au format UTC : “yyyy-mm-dd”
exemple :
2019-01-01

date_to
Type: string | null

date de fin de la plage temporelle
au format UTC : "yyyy-mm-dd"
exemple :
"2019-01-15"

group_range
Type: string | null

group_range du tableau POST

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

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

date
Type: string | null

date et heure auxquelles les données de la cible ont été stockées
au format UTC : "yyyy-mm-dd hh-mm-ss +00:00"
exemple :
2019-11-15 12:57:46 +00:00

lost_backlinks
Type: integer | null Format: int64

nombre de backlinks perdus
nombre de backlinks perdus de la target

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
nombre de domaines principaux référents perdus de la target

new_backlinks
Type: integer | null Format: int64

nombre de nouveaux backlinks
nombre de nouveaux backlinks 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
nombre de nouveaux domaines principaux référents pointant vers la target

type
Type: string | null

type d'élément

items_count
Type: integer | null Format: int64

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

target
Type: string | null

target d'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

post/v1/beta/dataforseo/backlinks/timeseries_new_lost_summary/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/timeseries_new_lost_summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "date_from": "2021-12-01",
    "date_to": "2022-02-01",
    "group_range": "month"
  }
]'

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,
          "date_from": null,
          "date_to": null,
          "group_range": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "date": null,
              "new_backlinks": null,
              "lost_backlinks": null,
              "new_referring_domains": null,
              "lost_referring_domains": null,
              "new_referring_main_domains": null,
              "lost_referring_main_domains": null
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Résumé des séries temporelles de liens entrants nouveaux et perdus

AuthentificationRequired

DataForSEO

Résumé des séries temporelles de liens entrants nouveaux et perdus

Référence tarifaire