v0.2.0-beta

OpenAPI 3.1.0

Ressources de l'API OnPage

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/on_page/resources

Ressources de l'API OnPage

Les ressources hors pages trouvées par un crawl — images, scripts, feuilles de style — avec leurs codes de statut et leurs tailles. Paginé avec search_after_token. 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. Pour les ressources totalement inaccessibles au crawler, utilisez post_dataforseo_on_page_uncrawlable_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.

Corps

application/json

Type: array (object | null)[]
- filters
  Type: array (object | null)[] | null
  
  tableau de paramètres de filtrage des résultats
  champ facultatif
  vous pouvez ajouter plusieurs filtres à la fois (8 filtres maximum)
  vous devez définir un opérateur logique and, or entre les conditions
  les opérateurs suivants sont pris en charge :
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  vous pouvez utiliser l'opérateur % avec like et not_like pour correspondre à toute chaîne de zéro caractère ou plus
  exemple :
  ["resource_type","=","stylesheet"]
  
  [["resource_type","=","image"], "and",["checks.is_https","=",false]]
  
  [["fetch_timing.duration_time",">",1],"and",[["total_transfer_size",">",100],"or",["checks.high_loading_time","=",true]]]
  
  La liste complète des filtres possibles est disponible via ce lien.
  
  Objet vide
- id
  Type: string
  
  ID de la tâche
  champ obligatoire
  vous pouvez obtenir cet ID dans la réponse du point de terminaison Task POST
  exemple :
  "07131248-1535-0216-1000-17384017ad04"
- limit
  Type: integer | null
  
  le nombre maximal de ressources renvoyées
  champ facultatif
  valeur par défaut : 100
  valeur maximale : 1000
- offset
  Type: integer | null
  
  décalage dans le tableau de résultats des ressources renvoyées
  champ facultatif
  valeur par défaut : 0
  valeur maximale : 2000000
  si vous spécifiez la valeur 10, les dix premières ressources du tableau de résultats seront omises et les données seront fournies pour les ressources suivantes
- order_by
  Type: array string[] | null
  
  règles de tri des résultats
  champ facultatif
  vous pouvez utiliser les mêmes valeurs que dans le tableau filters pour trier les résultats
  types de tri possibles :
  asc - les résultats seront triés par ordre croissant
  desc - les résultats seront triés par ordre décroissant
  vous devez utiliser une virgule pour définir un type de tri
  exemple :
  ["size,desc"]
  notez que vous pouvez définir au maximum trois règles de tri dans une seule requête
  vous devez utiliser une virgule pour séparer plusieurs règles de tri
  exemple :
  ["size,desc","fetch_timing.fetch_end,desc"]
- relevant_pages_filters
  Type: array string[] | null
  
  filtrer les ressources par pages pertinentes
  champ facultatif
  vous pouvez utiliser ce champ pour obtenir les ressources des pages correspondant aux paramètres définis
  vous pouvez appliquer ici les mêmes filtres que ceux disponibles pour le point de terminaison pages
  vous pouvez ajouter plusieurs filtres à la fois (8 filtres maximum)
  vous devez définir un opérateur logique and, or entre les conditions
  les opérateurs suivants sont pris en charge :
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  vous pouvez utiliser l'opérateur % avec like et not_like pour correspondre à toute chaîne de zéro caractère ou plus
  exemple :
  ["checks.no_image_title","=",true]
- search_after_token
  Type: string | null
  
  jeton pour les requêtes suivantes
  champ facultatif
  fourni dans le champ identique de la réponse à chaque requête ;
  utilisez ce paramètre pour éviter les délais d'attente lorsque vous essayez d'obtenir plus de 20,000 résultats en une seule requête ;
  en indiquant la valeur unique search_after_token du tableau de réponse, vous obtiendrez les résultats suivants de la tâche initiale ;
  les valeurs search_after_token sont uniques pour chaque tâche suivante ;
  Remarque : si le search_after_token est indiqué dans la requête, tous les autres paramètres doivent être identiques à ceux de la requête précédente
- 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
- url
  Type: string | null
  
  URL de la page
  champ facultatif
  indiquez ce champ si vous voulez obtenir les ressources d'une page particulière
  notez que pour obtenir le meta d'une ressource à partir d'une URL particulière, vous devez indiquer l'URL dans ce champ ;
  si vous n'indiquez pas d'url lors de la définition d'une tâche, le meta de la ressource dans les résultats sera renvoyé à partir des données de la page où notre crawler a vu la ressource pour la première fois

Réponses

200
Type: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo
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_OnPageResourcesTaskInfo
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

crawl_progress
Type: string | null

état de la session d'exploration
valeurs possibles : in_progress, finished

crawl_status
Type: object | null · Response36Afe1097B20_CrawlStatusInfo

détails de la session d'exploration

max_crawl_pages
Type: integer | null Format: int64

nombre maximal de pages à explorer indique la limite max_crawl_pages que vous avez définie lors de la configuration d'une tâche

pages_crawled
Type: integer | null Format: int64

nombre de pages explorées

pages_in_queue
Type: integer | null Format: int64

nombre de pages actuellement dans la file d'exploration

current_offset
Type: integer | null

Integer numbers.

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

tableau items

cache_control
Type: object | null · Response36Afe1097B20_CacheControl

instructions de mise en cache

cachable
Type: boolean | null

indique si la page peut être mise en cache

ttl
Type: integer | null

durée de vie la durée pendant laquelle le navigateur met une ressource en cache

checks
Type: object | null

contrôles du site contrôles on-page liés à la page

propertyName
Type: boolean | null
content_encoding
Type: string | null

type d'encodage

encoded_size
Type: integer | null

taille de la page après encodage indique la taille de la page encodée mesurée en octets

fetch_time
Type: string | null

date et heure auxquelles une ressource a été récupérée au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” exemple : 2019-11-15 12:57:46 +00:00

last_modified
Type: object | null · Response36Afe1097B20_LastModified

contient des données sur les modifications liées à la ressource s'il n'y a pas de données, la valeur sera null

header
Type: string | null

date et heure de la dernière modification de l'en-tête au format UTC : "yyyy-mm-dd hh-mm-ss +00:00" exemple : 2019-11-15 12:57:46 +00:00 s'il n'y a pas de données, la valeur sera null

meta_tag
Type: string | null

date et heure de la dernière modification de la balise meta au format UTC : "yyyy-mm-dd hh-mm-ss +00:00" exemple : 2019-11-15 12:57:46 +00:00 s'il n'y a pas de données, la valeur sera null

sitemap
Type: string | null

date et heure de la dernière modification du sitemap au format UTC : "yyyy-mm-dd hh-mm-ss +00:00" exemple : 2019-11-15 12:57:46 +00:00 s'il n'y a pas de données, la valeur sera null

location
Type: string | null

en-tête de localisation indique l'URL vers laquelle rediriger une page

media_type
Type: string | null

types de médias utilisés pour afficher une page

resource_errors
Type: object | null · Response36Afe1097B20_OnPageResourceIssueInfo

erreurs et avertissements de la ressource

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

erreurs de ressources

column
Type: integer | null

colonne où l'erreur a été trouvée

line
Type: integer | null

ligne où l'erreur a été trouvée

message
Type: string | null

message texte de l'erreur ; la liste complète des erreurs HTML possibles se trouve ici

status_code
Type: integer | null

code d'état général vous pouvez trouver la liste complète des codes de réponse ici Remarque : nous recommandons vivement de concevoir un système pour gérer les conditions exceptionnelles ou d'erreur associées

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

avertissements de ressources

column
Type: integer | null

colonne où l'erreur a été trouvée

line
Type: integer | null

ligne où l'erreur a été trouvée

message
Type: string | null

message texte de l'erreur ; la liste complète des erreurs HTML possibles se trouve ici

status_code
Type: integer | null

code d'état général vous pouvez trouver la liste complète des codes de réponse ici Remarque : nous recommandons vivement de concevoir un système pour gérer les conditions exceptionnelles ou d'erreur associées

resource_type
Type: string | null

type d'élément

server
Type: string | null

version du serveur

size
Type: integer | null

taille de la ressource indique la taille d'une page donnée mesurée en octets

status_code
Type: integer | null

code d'état général vous pouvez trouver la liste complète des codes de réponse ici Remarque : nous recommandons vivement de concevoir un système pour gérer les conditions exceptionnelles ou d'erreur associées

total_transfer_size
Type: integer | null Format: int64

taille de la page compressée indique la taille compressée d'une page donnée

url
Type: string | null

URL de la page

items_count
Type: integer | null Format: int64

nombre d'éléments du tableau de résultats

search_after_token
Type: string | null
total_items_count
Type: integer | null Format: int64

nombre total d'éléments pertinents explorés

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/on_page/resources

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/resources \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "id": "07281559-0695-0216-0000-c269be8b7592",
    "filters": [
      [
        "resource_type",
        "=",
        "image"
      ],
      "and",
      [
        "size",
        ">",
        100000
      ]
    ],
    "order_by": [
      "size,desc"
    ],
    "limit": 10
  }
]'

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": [
        {
          "crawl_progress": null,
          "crawl_status": {
            "max_crawl_pages": null,
            "pages_in_queue": null,
            "pages_crawled": null
          },
          "search_after_token": null,
          "current_offset": null,
          "total_items_count": null,
          "items_count": null,
          "items": [
            {
              "resource_type": null,
              "status_code": null,
              "location": null,
              "url": null,
              "resource_errors": "[Max Depth Exceeded]",
              "size": null,
              "encoded_size": null,
              "total_transfer_size": null,
              "fetch_time": null,
              "cache_control": "[Max Depth Exceeded]",
              "checks": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "last_modified": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Ressources de l'API OnPage

AuthentificationRequired

DataForSEO

Ressources de l'API OnPage

Référence tarifaire