> ## 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

> Scopri, esegui e fattura Data App tramite API REST, client ufficiali o MCP.

Tutte le capacità di Data Hub sono esposte con un’API REST pubblica. Portale web, MCP e librerie client Python/JavaScript sono modi diversi per chiamare gli stessi dati e le stesse regole di fatturazione.

## REST API

URL di base `https://api-datahub.octoparse.com`. Ogni endpoint inizia con `/v1`. Richieste e risposte in JSON. Gli endpoint autenticati usano `Authorization: Bearer <API Key>`. Crea una API key nel centro account Octoparse.

Avvia un’esecuzione e attendi il risultato:

```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="Riferimento API" href="/docs/it/datahub/api/reference/introduction">
    Convenzioni condivise su auth, forma della risposta, paginazione ed errori, più ogni endpoint per risorsa.
  </Card>

  <Card title="Spec OpenAPI" href="/docs/it/datahub/api/openapi.yaml">
    Contratto machine-readable da importare in Postman, tool di codegen o assistenti di coding AI.
  </Card>
</CardGroup>

## Librerie client

Le librerie client ufficiali wrappano ogni endpoint REST rivolto al caller. I metodi mappano 1:1 sugli endpoint e restituiscono il payload grezzo `data` della response.

<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/it/datahub/api/clients/python">Documentazione libreria client 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/it/datahub/api/clients/javascript">Documentazione libreria client JavaScript</a>
  </Tab>
</Tabs>

## MCP

Per far usare a un agent le Data App senza scrivere codice, collega il MCP generale di Data Hub. Espone sette tool per search, detail, run, status, result, cancel e list, e può pinnare un’app specifica come tool dedicato. Vedi <a href="/docs/it/datahub/mcp-capabilities">Capability MCP Data Hub</a> e la <a href="/docs/it/datahub/quick-start/agent-connection/general">guida di connessione generale</a>.

## Per l’AI

* Indice full-site: `https://www.octoparse.it/docs/llms.txt`
* Aggiungi `.md` a qualsiasi URL docs per ottenere la sorgente Markdown.
* Skill di authoring contratto: `GET /v1/skills/dataapp-contract-json.zip` per Claude Code, Codex e assistenti simili che generano contratti Data App.