Data Hub API

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:

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"

Riferimento API

Convenzioni condivise su auth, forma della risposta, paginazione ed errori, più ogni endpoint per risorsa.

Spec OpenAPI

Contratto machine-readable da importare in Postman, tool di codegen o assistenti di coding AI.

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.

Python
JavaScript

pip install octoparse-client

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)

Documentazione libreria client Python

npm install octoparse-client

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);
}

Documentazione libreria client JavaScript

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 Capability MCP Data Hub e la guida di connessione generale.

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.

PER INIZIARE

GUIDA RAPIDA

RIFERIMENTO

Data Hub API

REST API

Riferimento API

Spec OpenAPI

Librerie client

MCP

Per l’AI

​REST API

Riferimento API

Spec OpenAPI

​Librerie client

​MCP

​Per l’AI

REST API

Librerie client

MCP

Per l’AI