# Parameter

# Zeichen

  • Erforderlich
  • Typ 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
  • Typ 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
  • ruby
  • node
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&url=https%3A%2F%2Fapple.com%2F"

# Gerät

  • Nein
  • Typ 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
  • ruby
  • node
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&device=mobile&url=https%3A%2F%2Fapple.com%2F"

# user_agent

  • Nein
  • Typ string

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

  • curl
  • ruby
  • node
  • 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
  • Typ string

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

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

  • curl
  • ruby
  • node
  • 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"

# blättern

  • Nein
  • Typ 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 &scroll=true&scroll_interval=20.

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

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

# Shop an

  • Nein
  • Typ boolean

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

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

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

# Modus

  • Nein
  • Typ 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
  • ruby
  • node
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&mode=viewport&url=https%3A%2F%2Fapple.com%2F"

# Breite

  • Nein
  • Typ Integer

Optional weitergeben &width=1200 in Pixelparameter, 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
  • ruby
  • node
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&width=1200&url=https%3A%2F%2Fapple.com%2F"

# Höhe

  • Nein
  • Typ 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
  • ruby
  • node
  • php
  • python
  • go
curl "https://api.crawlbase.com/screenshots?token=_USER_TOKEN_&height=1800&url=https%3A%2F%2Fapple.com%2F"