Naar hoofdinhoud gaan
POST
Resultaatbewaring: Geef storage.expires_in door om de opgeslagen bestanden van deze kaart langer dan de standaard 7 dagen te bewaren. Waarden: 7d, 10d, 30d, 60d, 90d, 180d, 365d, of never. Zie Opslag voor details.

Autorisaties

Authorization
string
header
vereist

Bearer authenticatie header in de vorm Bearer , waar jouw auth token is.

Body

application/json
url
string<uri>
vereist

De URL van de website waarvoor je de links wilt

storage
object

Bepaalt hoe lang de opgeslagen bestanden van deze kaart (het resultaat en de pagina's die tijdens de ontdekking zijn gescraped) worden bewaard. Als dit wordt weggelaten, worden ze 7 dagen bewaard. De waarde die van kracht is, wordt in de respons geretourneerd als storage.expires_in. Zie de Storage-sectie in de functiedocumentatie. Een ongeldige waarde retourneert 400 met code invalid_storage_expires_in.

search_query
string

Een optionele zoekopdracht om de links te sorteren op zoekrelevantie.

top_n
number

Een optioneel nummer om te beperken tot alleen de top n links voor een zoekopdracht.

include_subdomain
boolean

Inclusief subdomeinen van de gegeven URL. true standaard.

include_urls
string[]

URL-padpatronen om op te nemen met behulp van glob-syntaxis. Bijvoorbeeld: /blog/** om alleen blog-URLs op te nemen. Alleen URLs die aan deze patronen voldoen, worden geretourneerd.

exclude_urls
string[]

URL-padpatronen om uit te sluiten met behulp van glob-syntaxis. Bijvoorbeeld: /careers/**. Uitgesloten URLs hebben voorrang op opgenomen URLs.

cursor
string

OPTIONEEL: Paginering cursor van een vorige reactie. Wanneer meegegeven, retourneert het de volgende set van URLs vanaf waar het vorige verzoek stopte vanwege de limiet op de grootte van de reactie.

Respons

Succesvolle reactie met URLs gevonden op de pagina

urls_count
integer
vereist

Aantal URLs in de huidige respons

urls
string[]
vereist

Array van URLs gevonden op de pagina

storage
object

Retentie toegepast op de opgeslagen bestanden van deze kaart.

id
string

Unieke identificatie voor deze kaart

cursor
string

Paginering cursor om de volgende set van URLs op te halen die beperkt zijn door de 10MB grootte limiet. Als null of niet aanwezig, zijn alle URLs opgehaald.

credits_consumed
integer | null

Aantal credits verbruikt door dit verzoek. Wordt ingevuld nadat de uitvoering is voltooid. Credits zijn de bron van waarheid voor facturering.

cost_usd
number | null

Geschatte kosten in USD voor dit verzoek. Wordt ingevuld nadat de uitvoering is voltooid. Berekend op basis van verbruikte credits en je abonnementsprijs — 99% nauwkeurig, maar credits_consumed is de gezaghebbende waarde.