Zum Hauptinhalt springen
POST
Ergebnisaufbewahrung: Übergebe storage.expires_in, um die gespeicherten Dateien dieser Karte länger als die Standarddauer von 7 Tagen aufzubewahren. Werte: 7d, 10d, 30d, 60d, 90d, 180d, 365d oder never. Siehe Speicherung für Details.

Autorisierungen

​
Authorization
string
header
erforderlich

Bearer-Authentifizierungs-Header in der Form Bearer , wobei dein Authentifizierungs-Token ist.

Body

application/json
​
url
string<uri>
erforderlich

Die URL der Website, für die du die Links möchtest

​
storage
object

Bestimmt, wie lange die gespeicherten Dateien dieser Karte (ihr Ergebnis und die während der Entdeckung gescrapten Seiten) aufbewahrt werden. Wenn weggelassen, werden sie 7 Tage lang aufbewahrt. Der tatsächlich angewendete Wert wird in der Antwort als storage.expires_in zurückgegeben. Siehe den Abschnitt Speicher in den Funktionsdokumenten. Ein ungültiger Wert gibt 400 mit dem Code invalid_storage_expires_in zurück.

​
search_query
string

Eine optionale Suchanfrage, um die Links nach Suchrelevanz zu sortieren.

​
top_n
number

Eine optionale Zahl, um die Anzahl der Links für eine Suchanfrage auf die obersten n zu begrenzen.

​
include_subdomain
boolean

Subdomains der angegebenen URL einbeziehen. Standardmäßig true.

​
include_urls
string[]

URL-Pfadmuster, die mit Glob-Syntax einbezogen werden sollen. Zum Beispiel: /blog/**, um nur Blog-URLs einzubeziehen. Es werden nur URLs zurückgegeben, die diesen Mustern entsprechen.

​
exclude_urls
string[]

URL-Pfadmuster, die mit Glob-Syntax ausgeschlossen werden sollen. Zum Beispiel: /careers/**. Ausgeschlossene URLs haben Vorrang vor einbezogenen URLs.

​
cursor
string

OPTIONAL: Paginierungscursor aus einer vorherigen Antwort. Wenn angegeben, werden die nächsten URLs zurückgegeben, ab dem Punkt, an dem die vorherige Anfrage aufgrund des Größenlimits der Antwort endete.

Antwort

Erfolgreiche Antwort mit URLs, die auf der Seite gefunden wurden

​
urls_count
integer
erforderlich

Anzahl der URLs in der aktuellen Antwort

​
urls
string[]
erforderlich

Array von URLs, die auf der Seite gefunden wurden

​
storage
object

Auf die gespeicherten Dateien dieser Karte angewendete Aufbewahrung.

​
id
string

Eindeutiger Bezeichner für diese Karte

​
cursor
string

Paginierungscursor, um das nächste Set von URLs abzurufen, das aufgrund des 10MB Größenlimits eingeschränkt ist. Wenn null oder nicht vorhanden, wurden alle URLs abgerufen.

​
credits_consumed
integer | null

Anzahl der durch diese Anfrage verbrauchten Credits. Wird nach Abschluss der Ausführung ausgefüllt. Credits sind die Grundlage für die Abrechnung.

​
cost_usd
number | null

Geschätzte Kosten in USD für diese Anfrage. Wird nach Abschluss der Ausführung ausgefüllt. Berechnet aus den verbrauchten Credits und deinem Tarif — 99% genau, aber credits_consumed ist der maßgebliche Wert.