> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ¿Qué herramienta uso?

> Elige el endpoint de Olostep adecuado para tu objetivo: una URL, un sitio completo, una lista de URLs, una búsqueda web o una respuesta investigada.

Empieza con lo que tienes y lo que quieres obtener. Cada endpoint utiliza la URL base `https://api.olostep.com` y el encabezado `Authorization: Bearer <YOUR_API_KEY>` (ver [Autenticación](https://docs.olostep.com/get-started/authentication.md)).

## Por objetivo

| Tienes | Quieres | Usar | Endpoint | Sincrónico o asincrónico |
| - | - | - | - | - |
| Una URL | Su contenido como Markdown, HTML, texto o JSON | [Scrape](https://docs.olostep.com/features/scrapes.md) | `POST /v1/scrapes` | Sincrónico |
| Una consulta, sin URLs | Una lista de enlaces relevantes y fragmentos | [Search](https://docs.olostep.com/features/search.md) | `POST /v1/searches` | Sincrónico |
| Una pregunta | Una respuesta investigada con fuentes | [Answers](https://docs.olostep.com/features/answers.md) | `POST /v1/answers` | Sincrónico |
| Un sitio web | Cada URL en él, sin contenido | [Map](https://docs.olostep.com/features/maps.md) | `POST /v1/maps` | Sincrónico |
| Un sitio web | El contenido de cada página (o un subconjunto filtrado) | [Crawl](https://docs.olostep.com/features/crawls.md) | `POST /v1/crawls` | Asincrónico |
| Una lista de URLs conocidas | El contenido de todas ellas | [Batch](https://docs.olostep.com/features/batches.md) | `POST /v1/batches` | Asincrónico |
| Una página que cambia | Una alerta cuando cambia | [Monitor](https://docs.olostep.com/features/monitors.md) | `POST /v1/monitors` | Se ejecuta en un horario |
| Cualquier llamada API | La misma llamada en un temporizador | [Schedule](https://docs.olostep.com/features/schedules.md) | `POST /v1/schedules` | Se ejecuta en un horario |
| Un sitio compatible (Google, LinkedIn, Amazon…) | Campos JSON estructurados y limpios | [Parsers](https://docs.olostep.com/features/structured-content/parsers.md) | opción `parser` en scrapes y batches | Igual que la llamada en la que está |
| Cualquier página | Campos JSON personalizados que describes | [LLM extraction](https://docs.olostep.com/features/structured-content/llm-extraction.md) | opción `llm_extract` en scrapes | Igual que la llamada en la que está |

## Decisiones comunes

* **Scrape vs. Crawl:** usa scrape cuando conoces la URL exacta. Usa crawl cuando quieres muchas páginas de un sitio y no quieres listarlas tú mismo.
* **Map vs. Crawl:** map devuelve solo URLs y es rápido. Úsalo para elegir páginas primero, luego scrapea o procesa por lotes solo esas.
* **Crawl vs. Batch:** crawl descubre páginas siguiendo enlaces. Batch toma una lista de URLs que ya tienes, hasta miles a la vez.
* **Search vs. Answers:** search devuelve enlaces para que tú (o tu agente) los leas. Answers lee las páginas por ti y devuelve una sola respuesta con citas.
* **Parsers vs. LLM extraction:** usa un parser cuando existe uno para el sitio. Es más rápido y devuelve los mismos campos cada vez. Usa LLM extraction para cualquier otra cosa.

## Endpoints asincrónicos

Crawls y batches se ejecutan en segundo plano. Cada uno devuelve un `id` de inmediato. Haz polling a `GET /v1/crawls/{id}` o `GET /v1/batches/{id}` hasta que el `status` sea `completed`, luego obtén los resultados. Deja de hacer polling si el `status` es `failed`. Un crawl aún puede terminar como `completed` con 0 páginas (verifica `pages_count`), y un batch puede terminar como `completed` con algunos elementos fallidos (listalos con `?status=failed`). Cada página de características muestra el flujo completo.

## Otras formas de llamar a Olostep

* **Agentes de IA y herramientas de codificación:** el [servidor MCP](https://docs.olostep.com/integrations/mcp-server.md) y [habilidades de agentes](https://docs.olostep.com/features/skills.md) proporcionan estas herramientas directamente a los agentes.
* **Terminal y scripts:** el [CLI de Olostep](https://docs.olostep.com/cli/overview.md) envuelve cada endpoint y devuelve JSON.
* **Código:** los [SDKs de Python y Node](https://docs.olostep.com/sdks/overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.