Data Hub API

Data Hub のすべての機能は、公開 REST API として提供されます。Web ポータル、MCP、Python / JavaScript クライアントは、同じデータと課金ルールへの異なる入り口です。

REST API

ベース URL は https://api-datahub.octoparse.com です。エンドポイントはすべて /v1 で始まり、リクエストとレスポンスは JSON です。認証が必要なエンドポイントは Authorization: Bearer <API Key> を使います。API キーは Octoparse アカウントセンターで作成します。実行を開始して結果を待つ例:

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"

API リファレンス

認証、レスポンス形式、ページネーション、エラーなど共通規約と、リソース別の全エンドポイント。

OpenAPI 仕様

Postman、コード生成、AI コーディング支援に取り込める機械可読な契約ファイル。

クライアントライブラリ

公式クライアントは呼び出し側向け REST エンドポイントをラップします。メソッドはエンドポイントと 1 対 1 で、戻り値はレスポンスの data そのものです。

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)

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

JavaScript クライアントのドキュメント

MCP

コードを書かずにエージェントへ Data App を使わせる場合は、Data Hub 汎用 MCP に接続します。検索、詳細、実行、状態、結果、キャンセル、一覧の 7 ツールがあり、特定 App を専用ツールとして固定できます。Data Hub MCP の機能と汎用接続ガイドを参照してください。

AI向け

サイト全体の索引: https://www.octoparse.jp/docs/llms.txt
任意のドキュメント URL に .md を付けると Markdown 原文を取得できます。
契約作成 Skill: GET /v1/skills/dataapp-contract-json.zip（Claude Code、Codex などが Data App 契約を生成するため）

はじめに

クイックスタート

リファレンス

Data Hub API

REST API

API リファレンス

OpenAPI 仕様

クライアントライブラリ

MCP

AI向け

​REST API

API リファレンス

OpenAPI 仕様

​クライアントライブラリ

​MCP

​AI向け

REST API

クライアントライブラリ

MCP

AI向け