curl --request POST \
--url https://api.olostep.com/v1/searches \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "Best Answer Engine Optimization startups"
}
'{
"storage": {
"expires_in": "7d"
},
"id": "search_9bi0sbj9xa",
"object": "search",
"created": 1760327323,
"metadata": {},
"query": "Best Answer Engine Optimization startups",
"credits_consumed": 10,
"result": {
"json_content": "<string>",
"json_hosted_url": "<string>",
"links": [
{
"url": "<string>",
"title": "<string>",
"description": "<string>",
"markdown_content": "<string>",
"html_content": "<string>"
}
],
"size_exceeded": true,
"credits_consumed": 123
}
}Crear búsqueda
Busca en la web con una consulta en lenguaje natural y obtén una lista deduplicada de enlaces relevantes con títulos y descripciones. Buscará la consulta semánticamente en toda la web y devolverá resultados. Opcionalmente, pasa scrape_options para también extraer cada URL devuelta e incrustar markdown_content / html_content directamente en cada enlace. Las extracciones de páginas se facturan automáticamente a tu equipo a través del endpoint subyacente /v1/scrapes. Consulta Función de búsqueda.
curl --request POST \
--url https://api.olostep.com/v1/searches \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "Best Answer Engine Optimization startups"
}
'{
"storage": {
"expires_in": "7d"
},
"id": "search_9bi0sbj9xa",
"object": "search",
"created": 1760327323,
"metadata": {},
"query": "Best Answer Engine Optimization startups",
"credits_consumed": 10,
"result": {
"json_content": "<string>",
"json_hosted_url": "<string>",
"links": [
{
"url": "<string>",
"title": "<string>",
"description": "<string>",
"markdown_content": "<string>",
"html_content": "<string>"
}
],
"size_exceeded": true,
"credits_consumed": 123
}
}storage.expires_in para mantener los archivos almacenados de esta búsqueda por más tiempo que el valor predeterminado de 7 días. Valores: 7d, 10d, 30d, 60d, 90d, 180d, 365d, o never. Consulta Almacenamiento para más detalles.Autorizaciones
Encabezado de autenticación Bearer del formulario Bearer , donde es tu token de autenticación.
Cuerpo
La consulta de búsqueda en lenguaje natural.
"What's going on with OpenAI's Sora shutting down?"
Controla cuánto tiempo se retienen los archivos almacenados de esta búsqueda (su archivo y cualquier contenido de enlace extraído). Si se omite, se mantienen durante 7 días. El valor en efecto se devuelve en la respuesta como storage.expires_in. Consulta la sección de Almacenamiento en la documentación de la función. Un valor inválido devuelve 400 con el código invalid_storage_expires_in.
Show child attributes
Show child attributes
Número máximo de enlaces a devolver después de la deduplicación.
1 <= x <= 2510
Restringe los resultados a estos dominios. Solo hosts básicos: los http(s):// iniciales y las barras finales se eliminan automáticamente.
["nytimes.com", "wsj.com"]
Excluye resultados de estos dominios. Solo hosts básicos: los http(s):// iniciales y las barras finales se eliminan automáticamente.
["reddit.com"]
Solicita una búsqueda directa y de baja latencia usando tu consulta literalmente. El modo predeterminado realiza una búsqueda más amplia para una mayor cobertura de resultados.
Opcional. Cuando se proporciona, cada enlace devuelto también se raspa y su contenido se incrusta en la respuesta. Los créditos de raspado por página se facturan automáticamente por el endpoint subyacente /v1/scrapes.
Show child attributes
Show child attributes
Respuesta
Respuesta exitosa con resultados de búsqueda.
Retención aplicada a los archivos almacenados de esta búsqueda.
Show child attributes
Show child attributes
"search_9bi0sbj9xa"
"search"
1760327323
"Best Answer Engine Optimization startups"
Créditos totales consumidos por esta solicitud: 5 créditos base de búsqueda + suma de créditos por página extraída cuando se usó scrape_options.
10
Show child attributes
Show child attributes
¿Esta página le ayudó?