# Ressources non explorables

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/on_page/uncrawlable_resources`

**Tags:** DataForSEO

Les ressources qu'un crawl n'a pas pu récupérer, et pourquoi. Renvoie `total_items_count`, `items_count` et `items`. Lit un crawl terminé : il lui faut l'`id` renvoyé par `post_dataforseo_on_page_submit` et il renvoie `crawl_progress` ainsi qu'un `crawl_status` composé de `max_crawl_pages`, `pages_in_queue` et `pages_crawled` — vérifiez ces valeurs avant de faire confiance à un petit résultat, car un crawl encore en cours a simplement moins à signaler. Ce sont les références cassées qu'un propriétaire de site veut voir en premier ; celles qui ont bien chargé se trouvent dans `post_dataforseo_on_page_resources`. 💰 Gratuit en amont : interroger un crawl terminé ne coûte rien, seul le crawl lui-même est facturé.

### Référence tarifaire

- Mesure : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.012.
- Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à 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.

## Related links

- [Task POST](<https://docs.dataforseo.com/v3/on_page/task_post/>)
- [via ce lien.](<https://docs.dataforseo.com/v3/on_page/filters_and_thresholds/?bash>)
- [ici](<https://docs.dataforseo.com/v3/appendix/errors>)

## 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": {
          "id": {
            "type": "string",
            "description": "<em>ID de la tâche</em><br><strong>champ obligatoire</strong><br>vous pouvez obtenir cet ID dans la réponse du point de terminaison Task POST<br>exemple :<br>\"07131248-1535-0216-1000-17384017ad04\""
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>le nombre maximal de ressources non explorables renvoyées</em><br>champ facultatif<br>valeur par défaut : <code>100</code><br>valeur maximale : <code>1000</code>"
          },
          "offset": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>décalage dans le tableau de résultats des ressources non explorables renvoyées</em><br>champ facultatif<br>valeur par défaut : <code>0</code><br> valeur maximale : <code>2000000</code><br>si vous indiquez la valeur <code>10</code>, les dix premières ressources non valides du tableau de résultats seront omises et les données seront fournies pour les ressources non valides suivantes"
          },
          "order_by": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>règles de tri des résultats</em><br>champ facultatif<br>vous pouvez utiliser les mêmes valeurs que dans le tableau <code>filters</code> pour trier les résultats<br>types de tri possibles :<br><code>asc</code> - les résultats seront triés par ordre croissant<br><code>desc</code> - les résultats seront triés par ordre décroissant<br>vous devez utiliser une virgule pour définir un type de tri<br>exemple :<br><code>[\"meta.content_type,desc\"]</code><br><strong>notez que vous pouvez définir au maximum trois règles de tri dans une seule requête</strong><br>vous devez utiliser une virgule pour séparer plusieurs règles de tri<br>exemple :<br><code>[\"meta.content_type,asc\",\"fetch_time,desc\"]</code>"
          },
          "filters": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "object",
                "null"
              ]
            },
            "description": "<em>tableau de paramètres de filtrage des résultats</em><br>champ facultatif<br><strong>vous pouvez ajouter plusieurs filtres à la fois (8 filtres maximum)</strong><br>vous devez définir un opérateur logique <code>and</code>, <code>or</code> entre les conditions<br>les opérateurs suivants sont pris en charge :<br><code>regex</code>, <code>not_regex</code>, <code>&lt;</code>, <code>&lt;=</code>, <code>&gt;</code>, <code>&gt;=</code>, <code>=</code>, <code>&lt;&gt;</code>, <code>in</code>, <code>not_in</code>, <code>like</code>, <code>not_like</code><br>vous pouvez utiliser l'opérateur <code>%</code> avec <code>like</code> et <code>not_like</code> pour correspondre à toute chaîne de zéro ou plusieurs caractères<br>exemple :<br><code> [[\"meta.content_type\",\"=\",\"image/jpeg\"],<br>\"and\",<br>[\"url\",\"not_like\",\"%/help-center/%\"]]</code><p>La liste complète des filtres possibles est disponible via ce lien."
          }
        },
        "example": [
          {
            "id": "07281559-0695-0216-0000-c269be8b7592",
            "filters": [
              [
                "meta.content_type",
                "=",
                "image/jpeg"
              ],
              "and",
              [
                "url",
                "like",
                "%go%"
              ]
            ],
            "limit": 10
          }
        ]
      }
    ]
  },
  "example": [
    {
      "id": "07281559-0695-0216-0000-c269be8b7592",
      "filters": [
        [
          "meta.content_type",
          "=",
          "image/jpeg"
        ],
        "and",
        [
          "url",
          "like",
          "%go%"
        ]
      ],
      "limit": 10
    }
  ]
}
```

## 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_OnPageUncrawlableResourcesResponseInfo"
    }
  ]
}
```

### 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_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"
    }
  }
}
```

### Response36Afe1097B20_CrawlStatusInfo

`#/components/schemas/Response36Afe1097B20_CrawlStatusInfo`

```json
{
  "type": "object",
  "properties": {
    "max_crawl_pages": {
      "type": [
        "integer",
        "null"
      ],
      "description": "nombre maximal de pages à explorer\nindique la limite max_crawl_pages que vous avez définie lors de la configuration d'une tâche",
      "format": "int64"
    },
    "pages_in_queue": {
      "type": [
        "integer",
        "null"
      ],
      "description": "nombre de pages actuellement dans la file d'exploration",
      "format": "int64"
    },
    "pages_crawled": {
      "type": [
        "integer",
        "null"
      ],
      "description": "nombre de pages explorées",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_OnPageUncrawlableResourcesItem

`#/components/schemas/Response36Afe1097B20_OnPageUncrawlableResourcesItem`

```json
{
  "type": "object",
  "properties": {
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL de la ressource non explorable</em>"
    },
    "reason": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>raison pour laquelle la ressource n'est pas explorable</em><br>peut prendre la valeur suivante : <code>content_type_inconsistency</code>"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<i>code de statut général</i><br>vous trouverez la liste complète des codes de réponse ici<br><strong>Remarque :</strong> nous vous recommandons vivement de concevoir un système nécessaire pour gérer les conditions exceptionnelles ou d'erreur associées"
    },
    "fetch_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>date et heure auxquelles la ressource a été récupérée</em><br>au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”<br>exemple :<br><code>2026-03-09 18:20:32 +00:00</code>"
    },
    "meta": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_UncrawlableResourcesMeta"
        }
      ],
      "description": "<em>métadonnées de la ressource non explorable</em>"
    }
  }
}
```

### Response36Afe1097B20_OnPageUncrawlableResourcesResponseInfo

`#/components/schemas/Response36Afe1097B20_OnPageUncrawlableResourcesResponseInfo`

```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_OnPageUncrawlableResourcesTaskInfo"
              }
            ]
          },
          "description": "<em>tableau de tâches</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_OnPageUncrawlableResourcesResultInfo

`#/components/schemas/Response36Afe1097B20_OnPageUncrawlableResourcesResultInfo`

```json
{
  "type": "object",
  "properties": {
    "crawl_progress": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>état de la session d'exploration</em><br>valeurs possibles : <code>in_progress</code>, <code>finished</code>"
    },
    "crawl_status": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_CrawlStatusInfo"
        }
      ],
      "description": "<em>détails de la session d'exploration</em>"
    },
    "current_offset": {
      "type": [
        "integer",
        "null"
      ]
    },
    "total_items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre total de ressources non explorables trouvées</em><br> nombre total de ressources non explorables trouvées lors de l'exploration du domaine cible",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>nombre de ressources non explorables dans le tableau <code>items</code></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_OnPageUncrawlableResourcesItem"
          }
        ]
      },
      "description": "<em>tableau des ressources non explorables</em>"
    }
  }
}
```

### Response36Afe1097B20_OnPageUncrawlableResourcesTaskInfo

`#/components/schemas/Response36Afe1097B20_OnPageUncrawlableResourcesTaskInfo`

```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_OnPageUncrawlableResourcesResultInfo"
              }
            ]
          },
          "description": "<em>tableau de résultats</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_UncrawlableResourcesMeta

`#/components/schemas/Response36Afe1097B20_UncrawlableResourcesMeta`

```json
{
  "type": "object",
  "properties": {
    "content_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>type de contenu réel de la ressource</em>"
    },
    "expected_content_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>types de contenu attendus pour la ressource</em><br>liste des types de contenu attendus par le robot d'exploration selon la manière dont la ressource est référencée sur la page"
    }
  }
}
```
