v0.2.0-beta

OpenAPI 3.1.0

Résumé des séries temporelles de 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

post/v1/beta/dataforseo/backlinks/timeseries_summary/live

Résumé des séries temporelles de liens entrants

Les métriques de liens entrants essentielles d'une target au fil du temps, regroupées par group_range (jour, semaine, mois). Renvoie date_from, date_to, group_range et un élément par période. Pour les gains et pertes plutôt que les totaux, utilisez post_dataforseo_backlinks_timeseries_new_lost_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.0273.
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 données de synthèse ;
  
  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
- 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 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_BacklinksTimeseriesSummaryLiveResponseInfo
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_BacklinksTimeseriesSummaryLiveTaskInfo
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 d'un tableau POST

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

contient les données de résumé pertinentes

backlinks
Type: integer | null Format: int64

nombre de backlinks pour la date indiquée

backlinks_nofollow
Type: integer | null Format: int64

nombre de backlinks nofollow pour la date indiquée

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

rank
Type: integer | null

rang de la target pour la date indiquée
en savoir plus sur la métrique et son calcul dans cet article du centre d'aide

referring_domains
Type: integer | null Format: int64

nombre de domaines référents pour la date indiquée
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 pour la date indiquée

referring_ips
Type: integer | null Format: int64

nombre d'adresses IP référentes pour la date indiquée
nombre d'adresses IP pointant vers cette page

referring_main_domains
Type: integer | null Format: int64

nombre de domaines principaux référents pour la date indiquée

referring_main_domains_nofollow
Type: integer | null Format: int64

nombre de domaines principaux pointant au moins un lien nofollow vers la target pour la date indiquée

referring_pages
Type: integer | null Format: int64

nombre de pages pointant vers la target pour la date indiquée

referring_pages_nofollow
Type: integer | null Format: int64

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

referring_subnets
Type: integer | null Format: int64

nombre de sous-réseaux référents pour la date indiquée

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

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/timeseries_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,
              "rank": null,
              "backlinks": null,
              "backlinks_nofollow": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Résumé des séries temporelles de liens entrants

AuthentificationRequired

DataForSEO

Résumé des séries temporelles de liens entrants

Référence tarifaire