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

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/backlinks/timeseries_new_lost_summary/live`

**Tags:** DataForSEO

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.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "target": {
            "type": "string",
            "description": "<em>domaine pour obtenir des données</em><br><strong>champ obligatoire</strong><br>un domaine doit être indiqué sans <code>https://</code> ni <code>www.</code><br>exemple :<br><code>\"forbes.com\"</code>"
          },
          "date_from": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>date de début de la plage temporelle</em><br>champ facultatif<br>ce champ indique la date utilisée comme seuil pour les backlinks et domaines référents nouveaux et perdus ;<br>les backlinks et domaines référents apparus dans notre index après la date indiquée sont considérés comme nouveaux ;<br>les backlinks et domaines référents introuvables après la date indiquée, mais présents auparavant, sont considérés comme perdus ;<p>valeur minimale : <code>2019-01-30</code><br>la valeur maximale ne doit pas dépasser la date indiquée dans <code>date_to</code><br>format de date : <code>\"yyyy-mm-dd\"</code><br>exemple :<br><code>\"2021-01-01\"</code>"
          },
          "date_to": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>date de fin de la plage temporelle</em><br>champ facultatif<br>si vous n'indiquez pas ce champ, la date du jour est utilisée par défaut<br>la valeur minimale ne doit pas précéder la date indiquée dans <code>date_from</code><br>valeur maximale : date du jour<br>format de date : <code>\"yyyy-mm-dd\"</code><br>exemple :<br><code>\"2021-01-15\"</code>"
          },
          "group_range": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>plage temporelle utilisée pour regrouper les résultats</em><br>champ facultatif<br>valeur par défaut : <code>month</code><br>valeurs possibles : <code>day</code>, <code>week</code>, <code>month</code>, <code>year</code><p><strong>remarque :</strong> pour <code>day</code>, nous renvoyons les éléments correspondant à toutes les dates comprises entre <code>date_from</code> et <code>date_to</code>, incluses ;<br>pour <code>week</code>/<code>month</code>/<code>year</code>, 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<p>par exemple, si vous indiquez : <br><code>\"group_range\": \"month\",<br>\"date_from\": \"2022-03-23\",<br>\"date_to\": \"2022-05-13\"</code><br>nous renvoyons les éléments compris entre 2022-03-01 et 2022-05-31, soit trois éléments correspondant aux dates suivantes : <code>2022-03-31</code>, <code>2022-04-30</code>, <code>2022-05-31</code><p>s'il n'y a pas de données pour un <code>day</code>/<code>week</code>/<code>month</code>/<code>year</code> donné, nous renvoyons <code>0</code>"
          },
          "include_subdomains": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>indique si les sous-domaines du <code>target</code> sont inclus dans la recherche</em><br>champ facultatif<br>s'il est défini sur <code>false</code>, les sous-domaines sont ignorés<br>valeur par défaut : <code>true</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>identifiant de tâche défini par l'utilisateur</em><br>champ facultatif<br><em>la limite est de 255 caractères</em><br>vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat<br>vous trouverez la valeur <code>tag</code> spécifiée dans l'objet <code>data</code> de la réponse"
          }
        },
        "example": [
          {
            "target": "dataforseo.com",
            "date_from": "2021-12-01",
            "date_to": "2022-02-01",
            "group_range": "month"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "target": "dataforseo.com",
      "date_from": "2021-12-01",
      "date_to": "2022-02-01",
      "group_range": "month"
    }
  ]
}
```

## Responses

### 200 — Opération réussie

Headers:
- `X-Request-Id` (string) — Identifiant de requête à inclure lorsque vous contactez le support Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveResponseInfo"
    }
  ]
}
```

### 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**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveItem

`#/components/schemas/Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveItem`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "type d'élément"
    },
    "date": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>date et heure auxquelles les données de la cible ont été stockées</em><br>au format UTC : \"yyyy-mm-dd hh-mm-ss +00:00\"<br>exemple :<br><code>2019-11-15 12:57:46 +00:00</code>"
    },
    "new_backlinks": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre de nouveaux backlinks</code></em><br>nombre de nouveaux backlinks pointant vers la <code>target</code>",
      "format": "int64"
    },
    "lost_backlinks": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre de backlinks perdus</code></em><br>nombre de backlinks perdus de la <code>target</code>",
      "format": "int64"
    },
    "new_referring_domains": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre de nouveaux domaines référents</code></em><br>nombre de nouveaux domaines référents pointant vers la <code>target</code>",
      "format": "int64"
    },
    "lost_referring_domains": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre de domaines référents perdus</code></em><br>nombre de domaines référents perdus de la <code>target</code>",
      "format": "int64"
    },
    "new_referring_main_domains": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre de nouveaux domaines principaux référents</code></em><br>nombre de nouveaux domaines principaux référents pointant vers la <code>target</code>",
      "format": "int64"
    },
    "lost_referring_main_domains": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre de domaines principaux référents perdus</code></em><br>nombre de domaines principaux référents perdus de la <code>target</code>",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveTaskInfo"
              }
            ]
          },
          "description": "<em>tableau de tâches</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveResultInfo

`#/components/schemas/Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "target": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em><code>target</code> d'un tableau POST</em>"
    },
    "date_from": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>date de début de la plage temporelle</em><br>au format UTC : “yyyy-mm-dd”<br>exemple :<br><code>2019-01-01</code>"
    },
    "date_to": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>date de fin de la plage temporelle</em><br>au format UTC : <code>\"yyyy-mm-dd\"</code><br>exemple :<br><code>\"2019-01-15\"</code>"
    },
    "group_range": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em><code>group_range</code> du tableau POST</em>"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>le nombre de résultats renvoyés dans le tableau <code>items</code></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveItem"
          }
        ]
      },
      "description": "<em>contient les backlinks pertinents et les données des domaines référents</em>"
    }
  }
}
```

### Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveResultInfo"
              }
            ]
          },
          "description": "<em>tableau de résultats</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "la version actuelle de l'API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "code d'état général\nvous pouvez trouver la liste complète des codes de réponse ici"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "message d'information général\nvous pouvez trouver la liste complète des messages d'information généraux ici"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "temps d'exécution total, en secondes"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "coût total des tâches, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "le nombre de tâches dans le tableau de tâches",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "le nombre de tâches dans le tableau de tâches renvoyées avec une erreur",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "identifiant de la tâche\nidentifiant unique de la tâche dans notre système au format UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "code d'état de la tâche\ngénéré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000\nvous pouvez trouver la liste complète des codes de réponse ici"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "message d'information de la tâche\nvous pouvez trouver la liste complète des messages d'information généraux ici"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "temps d'exécution, en secondes"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "coût total des tâches, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "nombre d'éléments dans le tableau de résultats",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "chemin de l'URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "contient les mêmes paramètres que ceux spécifiés dans la requête POST"
    }
  }
}
```
