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

# Data Hub API

> Descubre, ejecuta y factura Data Apps por la API REST, las librerías oficiales o MCP.

Todas las capacidades de Data Hub se exponen con una API REST pública. El portal web, MCP y las librerías Python y JavaScript son formas distintas de llamar a los mismos datos y a las mismas reglas de facturación.

## REST API

URL base `https://api-datahub.octoparse.com`. Todos los endpoints empiezan por `/v1`. Peticiones y respuestas en JSON. Los endpoints autenticados usan `Authorization: Bearer <API Key>`. Cree una API key en el centro de cuentas de Octoparse.

Inicie una ejecución y espere el resultado:

```bash theme={null}
curl -X POST \
  -H "Authorization: Bearer $OCTOPARSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product": "p-9001"}' \
  "https://api-datahub.octoparse.com/v1/data-apps/carol/reviews-query/runs?wait=60"
```

<CardGroup cols={2}>
  <Card title="Referencia de la API" href="/docs/es/datahub/api/reference/introduction">
    Convenciones compartidas de auth, forma de respuesta, paginación y errores, más cada endpoint por recurso.
  </Card>

  <Card title="OpenAPI spec" href="/docs/es/datahub/api/openapi.yaml">
    Contrato legible por máquina que puede importar en Postman, generadores de código o asistentes de IA.
  </Card>
</CardGroup>

## Bibliotecas cliente

Las bibliotecas cliente oficiales encapsulan todos los endpoints REST orientados al llamador. Los métodos se corresponden 1:1 y devuelven el `data` crudo.

<Tabs>
  <Tab title="Python">
    ```bash theme={null}
    pip install octoparse-client
    ```

    ```python theme={null}
    from octoparse_client import Client

    with Client(api_key="<your API key>") as client:
        result = client.search("reviews", limit=5)
        run = client.call("carol/reviews-query", {"product": "p-9001"})
        for record in client.iterate_records(run["run_id"]):
            print(record)
    ```

    <a href="/docs/es/datahub/api/clients/python">Documentación de la biblioteca cliente de Python</a>
  </Tab>

  <Tab title="JavaScript">
    ```bash theme={null}
    npm install octoparse-client
    ```

    ```js theme={null}
    import { Client } from "octoparse-client";

    const client = new Client({ apiKey: "<your API key>" });
    const result = await client.search("reviews", { limit: 5 });
    const run = await client.call("carol/reviews-query", { product: "p-9001" });
    for await (const record of client.iterateRecords(run.run_id)) {
      console.log(record);
    }
    ```

    <a href="/docs/es/datahub/api/clients/javascript">Documentación de la biblioteca cliente de JavaScript</a>
  </Tab>
</Tabs>

## MCP

Para que un agente use Data Apps sin escribir código, conecte el MCP general de Data Hub. Expone descubrimiento, ejecución y facturación como tools; la autenticación y el alcance coinciden con esta API REST.

## Para la IA

* Índice del sitio completo: `https://www.octoparse.es/docs/llms.txt`
* Añada `.md` a cualquier URL de docs para obtener el Markdown.
* Skill de autoría de contratos: `GET /v1/skills/dataapp-contract-json.zip` para Claude Code, Codex y asistentes similares que generan contratos de Data App.