v0.2.0-beta

OpenAPI 3.1.0

Résumé 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

get/v1/beta/dataforseo/on_page/summary/{id}

Résumé de l'API OnPage

L'état et les métriques clés d'un crawl, par id. Renvoie crawl_progress, crawl_status, crawl_gateway_address, crawl_stop_reason, domain_info et page_metrics. Enveloppé dans l'enveloppe DataForSEO : les données dans tasks[0].result, l'issue dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. C'est aussi le moyen de savoir qu'un crawl est terminé — interrogez-le en boucle jusqu'à ce que crawl_progress vaille finished avant de lire tout autre point de terminaison de cette famille, sinon vous lirez des résultats partiels qui ressemblent à de vrais résultats. 💰 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.

Paramètres de chemin

id
Type: string
obligatoire

identifiant 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”

Réponses

200
Type: object | null · Response36Afe1097B20_OnPageSummaryResponseInfo
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_OnPageSummaryTaskInfo
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_gateway_address
Type: string | null

adresse IP du robot d'exploration
affiche l'adresse IP utilisée par le robot d'exploration pour lancer la session d'exploration actuelle
vous trouverez la liste complète des IP utilisées par notre robot d'exploration dans la section Présentation

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

crawl_stop_reason
Type: string | null

raison de l'arrêt de l'exploration
informations sur la raison pour laquelle le processus d'exploration s'est arrêté ;
valeurs possibles :
limit_exceeded - la limite définie dans max_crawl_pages a été dépassée ;
empty_queue - toutes les URL de la file d'attente ont été explorées ;
force_stopped - le processus d'exploration a été interrompu à l'aide de la fonction On Page API Force Stop ;
unexpected_exception - une erreur interne s'est produite pendant l'exploration de la target, contactez le support pour plus d'informations

domain_info
Type: object | null · Response36Afe1097B20_DomainInfo

informations sur l'ensemble du domaine
informations on-page sur le domaine cible et le processus d'exploration

canonicalization_status_code
Type: integer | null

code de statut renvoyé par une page canonicalisée
la vérification du comportement du serveur lorsque notre robot d'exploration tente d'accéder au site web via IP ;
dans la plupart des cas, il est recommandé que les pages canonicalisées répondent avec un code de statut 301 ou 302

checks
Type: object | null

vérifications du site web
autres vérifications sur la page liées au site web

propertyName
Type: boolean | null
cms
Type: string | null

système de gestion de contenu
système de gestion de contenu identifié sur un site web
le contenu de la balise meta generator
les données sont extraites de la première page aléatoire qui renvoie le code de réponse 200
si notre robot d'exploration n'a pas pu identifier le CMS, la valeur serait nulln

crawl_end
Type: string | null

heure de fin de l'exploration
date et heure auxquelles l'exploration s'est terminée
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :
2019-11-15 12:57:46 +00:00
Remarque : informatif uniquement si "crawl_progress" est "finished"
si "crawl_progress" est in_progress, la valeur sera null

crawl_start
Type: string | null

heure de début de l'exploration
date et heure auxquelles le site web a été envoyé pour exploration
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :
2019-11-15 12:57:46 +00:00

directory_browsing_status_code
Type: integer | null

code de statut renvoyé par un répertoire
le code de statut renvoyé par une page de répertoire sur un site web cible
dans la plupart des cas, il est recommandé que les répertoires répondent avec un code de statut 403 ou 401

extended_crawl_status
Type: string | null

statut et erreurs d'exploration
indique la raison pour laquelle un site web n'a pas été exploré ;
peut prendre les valeurs suivantes :
no_errors - aucune erreur d'exploration n'a été détectée ;
site_unreachable - notre robot d'exploration n'a pas pu atteindre un site web et n'a donc pas pu obtenir de code de statut ;
invalid_page_status_code - code de statut de la première page explorée >= 400 ;
forbidden_meta_tag - la première page explorée contient la balise <meta robots="noindex"> ;
forbidden_robots - robots.txt interdit l'exploration de la page ;
forbidden_http_header - l'en-tête HTTP de la page contient "X-Robots-Tag: noindex" ;
too_many_redirects - la première page explorée a plus de 10 redirections ;
unknown - la raison est inconnue

ip
Type: string | null

adresse IP du domaine

main_domain
Type: string | null

nom de domaine racine

name
Type: string | null

nom de domaine

page_not_found_status_code
Type: integer | null

code de statut renvoyé par une page inexistante
dans la plupart des cas, il est recommandé qu'un serveur renvoie un code de réponse 404

server
Type: string | null

serveur du site web
la version du serveur détectée sur un site web
le contenu de l'en-tête server
les informations sont extraites de la première page dont le code de réponse est 200

ssl_info
Type: object | null · Response36Afe1097B20_SslInfo

informations sur le certificat SSL
informations sur le protocole Secure Sockets Layer détecté sur un site web

certificate_expiration_date
Type: string | null

date d'expiration du certificat SSL
date et heure d'expiration du certificat SSL
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :
2019-11-15 12:57:46 +00:00

certificate_hash
Type: string | null

hachage du certificat SSL
version de la fonction de hachage du certificat SSL

certificate_issuer
Type: string | null

autorité du certificat SSL
l'entité qui a émis le certificat SSL détecté

certificate_subject
Type: string | null

sujet du certificat SSL
l'entité associée à la clé publique

certificate_version
Type: integer | null

version du certificat SSL
indique la version de X.509 utilisée par un certificat SSL

valid_certificate
Type: boolean | null

validité du certificat SSL
indique si le certificat SSL détecté sur un site web n'est pas expiré, suspendu, révoqué ou invalide

total_pages
Type: integer | null Format: int64

total des pages explorées
le nombre total de pages explorées

total_uncrawlable_resources
Type: integer | null Format: int64

total des ressources non explorables
le nombre total de ressources qui n'ont pas pu être explorées ;
la ressource est considérée comme non explorable lorsque le type de contenu réel de la ressource ne correspond pas au type de contenu attendu par le robot d'exploration

www_redirect_status_code
Type: integer | null

code de statut de la redirection
le code de statut de la redirection de www vers non-www
dans la plupart des cas, il est recommandé que la redirection renvoie un code de statut 301

page_metrics
Type: object | null · Response36Afe1097B20_PageMetrics

informations spécifiques à la page
métriques des pages du site web cible

broken_links
Type: integer | null

nombre de liens brisés
nombre de liens brisés sur toutes les pages explorées d'un site web cible

broken_resources
Type: integer | null

nombre de ressources cassées
le nombre d'images et d'autres ressources avec des liens brisés

checks
Type: object | null

contrôles on-page spécifiques à la page

propertyName
Type: integer | null Format: int64

Signed 64-bit integers (long type).

duplicate_content
Type: integer | null

nombre de pages au contenu dupliqué

duplicate_description
Type: integer | null

nombre de pages avec des descriptions dupliquées

duplicate_title
Type: integer | null

nombre de pages avec des titres dupliqués

links_external
Type: integer | null

nombre de liens externes
le nombre de liens pointant vers d'autres sites web

links_internal
Type: integer | null

nombre de liens internes
le nombre de liens pointant vers d'autres pages du site web cible

links_relation_conflict
Type: integer | null

nombre de liens présents sur le site web cible qui peuvent être en conflit
par exemple, si "links_relation_conflict": 2, le site web cible fait référence à la même source par au moins un lien interne avec l'attribut rel="nofollow" et par au moins un lien dofollow

non_indexable
Type: integer | null

nombre de pages non indexables
nombre de pages bloquées pour l'indexation par Google et les autres moteurs de recherche via robots.txt, des en-têtes HTTP ou des paramètres de balises meta ;
vous pouvez recevoir une liste d'URL non indexables avec ce point de terminaison

onpage_score
Type: number | null

montre à quel point le site web est optimisé sur une échelle de 100 points
ce champ montre à quel point le site web est optimisé en tenant compte des problèmes critiques et des avertissements détectés sur la page ;
100 est le score maximal possible, ce qui signifie que le site web ne présente aucun problème critique ni aucun avertissement important ;
notez que cette valeur dépend du nombre de pages explorées ;
en savoir plus sur le calcul de cette métrique dans cet article du centre d'aide

redirect_loop
Type: integer | null

nombre de chaînes de redirection qui commencent et se terminent à la même URL
nombre de chaînes de redirection où l'URL de destination redirige vers l'URL d'origine

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

get/v1/beta/dataforseo/on_page/summary/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/summary/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

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
          },
          "crawl_gateway_address": null,
          "crawl_stop_reason": null,
          "domain_info": {
            "name": null,
            "cms": null,
            "ip": null,
            "server": null,
            "crawl_start": null,
            "crawl_end": null,
            "extended_crawl_status": null,
            "ssl_info": "[Max Depth Exceeded]",
            "checks": null,
            "total_pages": null,
            "total_uncrawlable_resources": null,
            "page_not_found_status_code": null,
            "canonicalization_status_code": null,
            "directory_browsing_status_code": null,
            "www_redirect_status_code": null,
            "main_domain": null
          },
          "page_metrics": {
            "links_external": null,
            "links_internal": null,
            "duplicate_title": null,
            "duplicate_description": null,
            "duplicate_content": null,
            "broken_links": null,
            "broken_resources": null,
            "links_relation_conflict": null,
            "redirect_loop": null,
            "onpage_score": null,
            "non_indexable": null,
            "checks": null
          }
        }
      ]
    }
  ]
}

Opération réussie

Résumé de l'API OnPage

AuthentificationRequired

DataForSEO

Résumé de l'API OnPage

Référence tarifaire