# 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"