Felo API PlatformFelo API Platform
Tous les endpoints DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Capture d'écran de page 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

Capture d'écran de page de l'API OnPage

​

Effectue le rendu d'une url et renvoie une capture d'écran, avec full_page_screenshot pour toute la hauteur de défilement et browser_screen_width et browser_screen_height pour définir la fenêtre d'affichage. Autonome — aucun crawl nécessaire. 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. ⚠️ Une image constitue un résultat d'outil volumineux avant même qu'un agent puisse en faire quoi que ce soit ; ne demandez une capture que lorsque le visuel est l'essentiel, et utilisez post_dataforseo_on_page_content_parsing_live lorsque c'est le texte qui l'est.

Référence tarifaire

  • Mesure : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.0051.
  • 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)[]
    • accept_language
      Type: string | null

      en-tête de langue pour accéder au site web
      champ facultatif
      tous les formats de paramètres régionaux sont pris en charge (xx, xx-XX, xxx-XX, etc.)
      remarque : si vous ne spécifiez pas ce paramètre, certains sites web peuvent refuser l'accès ; dans ce cas, vous obtiendrez "error_message":"Screenshot is empty" dans le tableau de réponse

    • browser_preset
      Type: string | null

      préréglage des paramètres d'écran du navigateur
      champ facultatif
      si vous utilisez ce champ, vous n'avez pas besoin d'indiquer browser_screen_width, browser_screen_height, browser_screen_scale_factor

      valeurs possibles :
      desktop, mobile, tablet

      le préréglage desktop applique les valeurs suivantes :

      browser_screen_width: 1920
      browser_screen_height: 1080
      browser_screen_scale_factor: 1

      le préréglage mobile applique les valeurs suivantes :

      browser_screen_width: 390
      browser_screen_height: 844
      browser_screen_scale_factor: 3

      le préréglage tablet applique les valeurs suivantes :

      browser_screen_width: 1024
      browser_screen_height: 1366
      browser_screen_scale_factor: 2

      Remarque : dans ce point de terminaison, les paramètres enable_browser_rendering, enable_javascript, load_resources et enable_xhr sont toujours activés.

    • browser_screen_height
      Type: integer | null

      hauteur d'écran du navigateur
      champ facultatif
      vous pouvez définir une hauteur d'écran de navigateur personnalisée pour auditer un appareil particulier ;
      si vous utilisez ce champ, vous n'avez pas besoin d'indiquer browser_preset, car il sera ignoré ;

      valeur minimale, en pixels : 240
      valeur maximale, en pixels : 9999

    • browser_screen_scale_factor
      Type: number | null

      facteur d'échelle d'écran du navigateur
      champ facultatif
      vous pouvez définir un ratio de résolution d'écran de navigateur personnalisé pour auditer un appareil particulier ;
      si vous utilisez ce champ, vous n'avez pas besoin d'indiquer browser_preset, car il sera ignoré ;

      valeur minimale : 0.5
      valeur maximale : 3

    • browser_screen_width
      Type: integer | null Format: int64

      largeur d'écran du navigateur
      champ facultatif
      vous pouvez définir une largeur d'écran de navigateur personnalisée pour auditer un appareil particulier ;
      si vous utilisez ce champ, vous n'avez pas besoin d'indiquer browser_preset, car il sera ignoré ;

      valeur minimale, en pixels : 240
      valeur maximale, en pixels : 9999

    • custom_user_agent
      Type: string | null

      user agent personnalisé
      champ facultatif
      user agent personnalisé pour explorer un site web
      exemple : Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36

      valeur par défaut : Mozilla/5.0 (compatible; RSiteAuditor)

    • disable_cookie_popup
      Type: boolean | null

      désactiver le pop-up de cookies
      champ facultatif
      définissez sur true si vous voulez désactiver le pop-up demandant le consentement aux cookies de l'utilisateur ;
      valeur par défaut :
      false

    • full_page_screenshot
      Type: boolean | null

      prendre une capture d'écran de la page entière
      champ facultatif
      définissez sur false si vous voulez capturer uniquement la partie de la page affichée avant le défilement
      valeur par défaut : true

    • ip_pool_for_scan
      Type: string | null

      pool de proxys
      champ facultatif
      vous pouvez choisir l'emplacement du pool de proxys qui sera utilisé pour obtenir les données demandées ;
      ce paramètre peut être utilisé si le contenu de la page est inaccessible dans l'un des emplacements, ce qui entraîne des erreurs site_unreachable occasionnelles
      valeurs possibles : us, de

    • switch_pool
      Type: boolean | null

      changer de pool de proxys
      champ facultatif
      si la valeur est true, des pools de proxys supplémentaires seront utilisés pour obtenir les données demandées ;
      ce paramètre peut être utilisé si un grand nombre de tâches est défini simultanément, ce qui entraîne des erreurs rate-limit et/ou site_unreachable occasionnelles

    • url
      Type: string

      URL de la page
      champ obligatoire
      URL absolue de la page à capturer
      remarque : si l'URL que vous indiquez ici renvoie un code d'état 404 ou si la valeur indiquée n'est pas une URL valide, vous obtiendrez "error_message":"Screenshot is empty" dans le tableau de réponse

Réponses
  • 200
    Type: object | null · Response36Afe1097B20_OnPagePageScreenshotResponseInfo
    • 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_OnPagePageScreenshotTaskInfo
        • 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

          • error_message
            Type: string | null

            message d'erreur
            si l'url indiquée renvoie un code de statut 404 ou n'est pas une URL valide, vous obtiendrez "error_message":"Screenshot is empty"
            si aucune erreur ne se produit, la valeur sera null

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

            tableau items

            • image
              Type: string | null

              capture d'écran de la page demandée
              URL de la capture d'écran de la page sur le stockage DataForSEO
              remarque : la capture d'écran enregistrée sur le stockage DataForSEO reste accessible un jour seulement après l'exécution de la requête

          • items_count
            Type: integer | null Format: int64

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

        • 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
Request Example for post/v1/beta/dataforseo/on_page/page_screenshot
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/page_screenshot \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "url": "https://dataforseo.com/apis"
  }
]'

{
  "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,
          "error_message": null,
          "items_count": null,
          "items": [
            {
              "image": null
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

OnPage API Page Screenshot