Passer au contenu principal
POST
Rétention des résultats : Passe storage.expires_in pour conserver les fichiers stockés de cette recherche plus longtemps que la durée par défaut de 7 jours. Valeurs : 7d, 10d, 30d, 60d, 90d, 180d, 365d, ou never. Voir Stockage pour plus de détails.

Autorisations

Authorization
string
header
requis

En-tête d'authentification Bearer sous la forme Bearer , où est ton jeton d'authentification.

Corps

application/json
query
string
requis

La requête de recherche en langage naturel.

Exemple:

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

storage
object

Contrôle la durée de conservation des fichiers stockés de cette recherche (son fichier et tout contenu de lien extrait). Lorsqu'omise, ils sont conservés pendant 7 jours. La valeur en vigueur est retournée dans la réponse sous storage.expires_in. Voir la section Stockage dans la documentation des fonctionnalités. Une valeur invalide retourne 400 avec le code invalid_storage_expires_in.

limit
integer
défaut:12

Nombre maximum de liens à retourner après déduplication.

Plage requise: 1 <= x <= 25
Exemple:

10

include_domains
string[]

Restreindre les résultats à ces domaines. Hôtes nus uniquement — les http(s):// initiaux et les barres obliques finales sont automatiquement supprimés.

Exemple:
exclude_domains
string[]

Exclure les résultats de ces domaines. Hôtes nus uniquement — les http(s):// initiaux et les barres obliques finales sont automatiquement supprimés.

Exemple:
fast_mode
boolean
défaut:false

Demande une recherche directe et à faible latence en utilisant ta requête telle quelle. Le mode par défaut effectue une recherche plus large pour une couverture de résultats plus étendue.

scrape_options
object

Optionnel. Lorsqu'il est fourni, chaque lien retourné est également exploré et son contenu est intégré dans la réponse. Les crédits d'exploration par page sont facturés automatiquement par le point de terminaison /v1/scrapes sous-jacent.

Réponse

Réponse réussie avec les résultats de recherche.

storage
object

Rétention appliquée aux fichiers stockés de cette recherche.

id
string
Exemple:

"search_9bi0sbj9xa"

object
string
Exemple:

"search"

created
integer
Exemple:

1760327323

metadata
object
query
string
Exemple:

"Best Answer Engine Optimization startups"

credits_consumed
integer

Total des crédits consommés par cette requête : 5 crédits de recherche de base + somme des crédits par page extraite lorsque scrape_options a été utilisé.

Exemple:

10

result
object