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

# FastAPI

> Usa Evocrawl con FastAPI para crear APIs asíncronas de scraping y búsqueda web en Python.

<div id="prerequisites">
  ## Requisitos previos
</div>

* Python 3.8+
* Una clave de la API de Evocrawl — [consigue una gratis](https://www.evocrawl.com/app/api-keys)

<div id="setup">
  ## Configuración
</div>

```bash theme={null}
pip install fastapi uvicorn evocrawl-py
```

Añade tu clave de API a `.env`:

```bash theme={null}
EVOCRAWL_API_KEY=fc-YOUR-API-KEY
```

<div id="create-the-api">
  ## Crea la API
</div>

Crea `main.py`:

```python theme={null}
import os
from fastapi import FastAPI
from pydantic import BaseModel
from evocrawl import Evocrawl

app = FastAPI()
evocrawl = Evocrawl(api_key=os.environ["EVOCRAWL_API_KEY"])


class SearchRequest(BaseModel):
    query: str
    limit: int = 5


class ScrapeRequest(BaseModel):
    url: str


class InteractRequest(BaseModel):
    scrape_id: str
    prompt: str


@app.post("/search")
async def search(req: SearchRequest):
    results = evocrawl.search(req.query, limit=req.limit)
    return [{"title": r.title, "url": r.url} for r in results.web]


@app.post("/scrape")
async def scrape(req: ScrapeRequest):
    result = evocrawl.scrape(req.url)
    return {"markdown": result.markdown, "metadata": result.metadata}


@app.post("/interact/start")
async def interact_start(req: ScrapeRequest):
    result = evocrawl.scrape(req.url, formats=["markdown"])
    return {"scrape_id": result.metadata.scrape_id}


@app.post("/interact")
async def interact(req: InteractRequest):
    response = evocrawl.interact(req.scrape_id, prompt=req.prompt)
    return {"output": response.output}


@app.post("/interact/stop")
async def interact_stop(req: InteractRequest):
    evocrawl.stop_interaction(req.scrape_id)
    return {"status": "stopped"}
```

<div id="run-it">
  ## Ejecútalo
</div>

```bash theme={null}
uvicorn main:app --reload
```

<div id="test-it">
  ## Pruébalo
</div>

```bash theme={null}
# Buscar en la web
curl -X POST http://localhost:8000/search \
  -H "Content-Type: application/json" \
  -d '{"query": "evocrawl web scraping", "limit": 5}'

# Hacer scraping de una página
curl -X POST http://localhost:8000/scrape \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# Iniciar una sesión interactiva y luego enviar prompts
curl -X POST http://localhost:8000/interact/start \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.amazon.com"}'
```

FastAPI genera automáticamente documentación interactiva en `http://localhost:8000/docs`.

<div id="async-variant">
  ## Variante asíncrona
</div>

Para mejorar la concurrencia con carga, usa `AsyncEvocrawl`:

```python theme={null}
from evocrawl import AsyncEvocrawl

async_evocrawl = AsyncEvocrawl(api_key=os.environ["EVOCRAWL_API_KEY"])

@app.post("/scrape-async")
async def scrape_async(req: ScrapeRequest):
    result = await async_evocrawl.scrape(req.url)
    return {"markdown": result.markdown}
```

<div id="next-steps">
  ## Siguientes pasos
</div>

<CardGroup cols={2}>
  <Card title="Documentación de scraping" icon="file-lines" href="/es/features/scrape">
    Todas las opciones de scraping, incluidos los formatos, las acciones y los proxies
  </Card>

  <Card title="Documentación de Search" icon="magnifying-glass" href="/es/features/search">
    Buscar en la web y obtener el contenido completo de la página
  </Card>

  <Card title="Documentación de Interact" icon="hand-pointer" href="/es/features/interact">
    Haz clic, completa formularios y extrae contenido dinámico
  </Card>

  <Card title="Referencia del SDK de Python" icon="python" href="/es/sdks/python">
    Referencia completa del SDK con crawl, map, async y más
  </Card>
</CardGroup>