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

Autorizzazioni

Authorization
string
header
obbligatorio

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

Corpo

application/json
query
string
obbligatorio

La query di ricerca in linguaggio naturale.

Esempio:

"What's going on with OpenAI's Sora shutting down?"

storage
object

Controlla per quanto tempo i file memorizzati di questa ricerca (il suo file e qualsiasi contenuto di link scrappato) vengono conservati. Se omesso, vengono conservati per 7 giorni. Il valore effettivo viene 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.

limit
integer
predefinito:12

Numero massimo di link da restituire dopo la deduplicazione.

Intervallo richiesto: 1 <= x <= 25
Esempio:

10

include_domains
string[]

Restringi i risultati a questi domini. Solo host nudi — http(s):// iniziali e barre finali vengono automaticamente rimossi.

Esempio:
exclude_domains
string[]

Escludi i risultati da questi domini. Solo host nudi — http(s):// iniziali e barre finali vengono automaticamente rimossi.

Esempio:
fast_mode
boolean
predefinito:false

Richiedi una ricerca diretta e a bassa latenza utilizzando la tua query alla lettera. La modalità predefinita esegue un passaggio di ricerca più ampio per una copertura dei risultati più ampia.

scrape_options
object

Facoltativo. Quando fornito, ogni link restituito viene anche analizzato e il suo contenuto incorporato nella risposta. I crediti per pagina analizzata vengono addebitati automaticamente dall'endpoint sottostante /v1/scrapes.

Risposta

Risposta riuscita con risultati di ricerca.

storage
object

Conservazione applicata ai file memorizzati di questa ricerca.

id
string
Esempio:

"search_9bi0sbj9xa"

object
string
Esempio:

"search"

created
integer
Esempio:

1760327323

metadata
object
query
string
Esempio:

"Best Answer Engine Optimization startups"

credits_consumed
integer

Crediti totali consumati da questa richiesta: 5 crediti di ricerca base + somma dei crediti di scraping per pagina quando sono state utilizzate scrape_options.

Esempio:

10

result
object