Vai al contenuto principale
POST
Conservazione dei risultati: Passa storage.expires_in per conservare i file memorizzati di questa mappa più a lungo rispetto al valore predefinito di 7 giorni. Valori: 7d, 10d, 30d, 60d, 90d, 180d, 365d, o never. Vedi Storage per i dettagli.

Autorizzazioni

Authorization
string
header
obbligatorio

Intestazione di autenticazione Bearer del tipo Bearer , dove è il tuo token di autenticazione.

Corpo

application/json
url
string<uri>
obbligatorio

L'URL del sito web per cui vuoi i link

storage
object

Controlla per quanto tempo i file memorizzati di questa mappa (il suo risultato e le pagine scansionate durante la scoperta) sono conservati. Se omesso, vengono mantenuti per 7 giorni. Il valore effettivo è restituito nella risposta come storage.expires_in. Vedi la sezione Storage nei documenti delle funzionalità. Un valore non valido restituisce 400 con codice invalid_storage_expires_in.

search_query
string

Una query di ricerca opzionale per ordinare i link per rilevanza di ricerca.

top_n
number

Un numero opzionale per limitare solo ai primi n link per una query di ricerca.

include_subdomain
boolean

Includi i sottodomini dell'URL dato. true di default.

include_urls
string[]

Modelli di percorso URL da includere usando la sintassi glob. Per esempio: /blog/** per includere solo gli URL del blog. Saranno restituiti solo gli URL che corrispondono a questi modelli.

exclude_urls
string[]

Modelli di percorso URL da escludere usando la sintassi glob. Per esempio: /careers/**. Gli URL esclusi prevarranno sugli URL inclusi.

cursor
string

OPZIONALE: Cursore di paginazione da una risposta precedente. Quando fornito, restituisce il prossimo set di URL da dove la richiesta precedente si era interrotta a causa del limite di dimensione della risposta.

Risposta

Risposta riuscita con URL trovati sulla pagina

urls_count
integer
obbligatorio

Numero di URL nella risposta corrente

urls
string[]
obbligatorio

Array di URL trovati sulla pagina

storage
object

Conservazione applicata ai file memorizzati di questa mappa.

id
string

Identificatore univoco per questa mappa

cursor
string

Cursore di paginazione per recuperare il prossimo set di URL limitato a causa del limite di dimensione di 10MB. Se nullo o non presente, tutti gli URL sono stati recuperati.

credits_consumed
integer | null

Numero di crediti consumati da questa richiesta. Popolato dopo il completamento dell'esecuzione. I crediti sono la fonte di verità per la fatturazione.

cost_usd
number | null

Costo stimato in USD per questa richiesta. Popolato dopo il completamento dell'esecuzione. Calcolato dai crediti consumati e dal tuo piano tariffario — 99% accurato, ma credits_consumed è il valore autorevole.