# Parameter

# Zeichen

  • Erforderlich
  • Höhe string

Dieser Parameter ist für alle Anrufe erforderlich

Dies ist Ihr Authentifizierungstoken. Alle Ihre Anfragen müssen mit Ihrem privaten Token autorisiert werden.

Privater Token

_USER_TOKEN_

# URL

  • Erforderlich
  • Höhe string

Sie benötigen eine URL, um einen Screenshot der Webseite zu erstellen. Stellen Sie sicher, dass sie mit http oder https beginnt und vollständig kodiert.

Beispielsweise in der folgenden URL: https://www.apple.com/us/search/iphonex?src=globalnav Die URL sollte beim Aufruf der Screenshots-API wie folgt codiert werden: https%3A%2F%2Fwww.apple.com%2Fus%2Fsearch%2Fiphonex%3Fsrc%3Dglobalnav

  • curl
  • Rubin
  • Knoten
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&url=https%3A%2F%2Fapple.com%2F"

# Gerät

  • Nein
  • Höhe string

Wenn Sie keinen user_agent angeben möchten, aber die Anfragen von einem bestimmten Gerät erhalten möchten, können Sie diesen Parameter optional verwenden. Es stehen zwei Optionen zur Verfügung: desktop und mobile.

  • curl
  • Rubin
  • Knoten
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&device=mobile&url=https%3A%2F%2Fapple.com%2F"

# user_agent

  • Nein
  • Höhe string

Wenn Sie die Anfrage mit einem benutzerdefinierten Benutzeragenten stellen möchten, können Sie ihn hier übergeben und unser Server leiten ihn über die angeforderte URL weiter.

  • curl
  • Rubin
  • Knoten
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&user_agent=Mozilla%2F5.0+%28Macintosh%3B+Intel+Mac+OS+X+10_12_5%29+AppleWebKit%2F603.2.4+%28KHTML%2C+like+Gecko%29+Version%2F10.1.1+Safari%2F603.2.4&url=https%3A%2F%2Fapple.com%2F"

# CSS-Klickselektor

  • Nein
  • Höhe string

Optional weitergeben css_click_selector Parameter, um auf ein Element auf der Seite zu klicken, bevor der Browser die entsprechenden HTML-Seiten erfasst.

Es muss sich beispielsweise um einen vollständigen und gültigen CSS-Selektor handeln #some-button or .some-other-button und richtig codiert.

  • curl
  • Rubin
  • Knoten
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&css_click_selector=%23some-nice-button&url=https%3A%2F%2Fapple.com%2F"

# blattern

  • Nein
  • Höhe boolean

Optional weitergeben &scroll=true Parameter, um durch die gesamte Seite zu scrollen, bevor der Screenshot aufgenommen wird. Dies ist der Standard-Scroll für eine &scroll_interval von 10 Sekunden.

Wenn Sie länger als 10 Sekunden scrollen möchten, senden Sie bitte die Nachricht &scroll=true&scroll_interval=20.

Eine &scroll_interval beträgt mindestens 10 Sekunden und höchstens 60.

  • curl
  • Rubin
  • Knoten
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&scroll=true&url=https%3A%2F%2Fapple.com%2F"

# Kaufen Sie ein

  • Nein
  • Höhe boolean

Optional weitergeben &store=true Parameter zum Speichern einer Kopie des Screenshots im Crawlbase Cloud-Speicher (neues Fenster öffnen) (öffnet neues Fenster).

Crawlbase sendet Ihnen die screenshot_url des gespeicherten Screenshots in den Antwortheadern.

  • curl
  • Rubin
  • Knoten
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&store=true&url=https%3A%2F%2Fapple.com%2F"

# modus

  • Nein
  • Höhe String

Optional weitergeben &mode=viewport Parameter, Standard ist fullpage um einen Screenshot des Ansichtsfensters zu machen. Die Standardbreite ist die Bildschirmbreite und die Höhe beträgt maximal 800 Pixel.

  • curl
  • Rubin
  • Knoten
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&mode=viewport&url=https%3A%2F%2Fapple.com%2F"

# Breite

  • Nein
  • Höhe Integer

Optional weitergeben &width=1200 in Pixelparametern, um die Größe des Screenshots auf diese maximale Breite zu ändern. Die Standardbreite ist die Bildschirmbreite und wird nur wirksam, wenn sie mit kombiniert wird mode=viewport.

  • curl
  • Rubin
  • Knoten
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&width=1200&url=https%3A%2F%2Fapple.com%2F"

# Höhe

  • Nein
  • Höhe Integer

Optional weitergeben &height=1800 in Pixelparameter, um die Größe des Screenshots auf diese maximale Höhe zu ändern. Die Standardhöhe ist die Bildschirmhöhe und wird nur wirksam, wenn sie mit kombiniert wird mode=viewport.

  • curl
  • Rubin
  • Knoten
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&height=1800&url=https%3A%2F%2Fapple.com%2F"