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

> Data Apps per REST-API, offiziellen Clients oder MCP programmatisch finden, ausführen und abrechnen.

Alle Data-Hub-Fähigkeiten laufen über eine öffentliche REST-API. Webportal, MCP sowie Python- und JavaScript-Client-Bibliotheken sind unterschiedliche Wege, dieselben Daten und Abrechnungsregeln aufzurufen.

## REST API

Basis-URL `https://api-datahub.octoparse.com`. Jeder Endpoint beginnt mit `/v1`. Requests und Responses sind JSON. Authentifizierte Endpoints nutzen `Authorization: Bearer <API Key>`. API-Schlüssel im Octoparse-Account-Center erstellen.

Run starten und auf das Ergebnis warten:

```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="API-Referenz" href="/docs/de/datahub/api/reference/introduction">
    Gemeinsame Konventionen zu Auth, Antwortform, Paginierung und Fehlern sowie alle Endpoints nach Ressource.
  </Card>

  <Card title="OpenAPI-Spezifikation" href="/docs/de/datahub/api/openapi.yaml">
    Maschinenlesbarer Vertrag zum Import in Postman, Codegen-Tools oder KI-Coding-Assistenten.
  </Card>
</CardGroup>

## Client-Bibliotheken

Die offiziellen Client-Bibliotheken wrappen jeden caller-seitigen REST-Endpoint. Methoden mapen 1:1 auf Endpoints und geben den rohen `data`-Payload der Response zurück.

<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/de/datahub/api/clients/python">Python-Client-Bibliothek</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/de/datahub/api/clients/javascript">JavaScript-Client-Bibliothek</a>
  </Tab>
</Tabs>

## MCP

Damit ein Agent Data Apps ohne Code nutzen kann, verbinden Sie den Data-Hub-General-MCP. Er exponiert sieben Tools für Suche, Detail, Run, Status, Result, Cancel und List und kann eine bestimmte App als dediziertes Tool pinnen. Siehe <a href="/docs/de/datahub/mcp-capabilities">Data-Hub-MCP-Fähigkeiten</a> und den <a href="/docs/de/datahub/quick-start/agent-connection/general">allgemeinen Connection-Guide</a>.

## Für KI

* Full-Site-Index: `https://www.octoparse.de/docs/llms.txt`
* Hängen Sie `.md` an jede Docs-URL, um die Markdown-Quelle abzurufen.
* Contract-Authoring-Skill: `GET /v1/skills/dataapp-contract-json.zip` für Claude Code, Codex und ähnliche Assistenten, die Data-App-Verträge generieren.
