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

> Découvrez, exécutez et facturez des Data Apps via l’API REST, les clients officiels ou MCP.

Toutes les capacités de Data Hub passent par une API REST publique. Le portail web, MCP et les clients Python et JavaScript sont des portes d’entrée différentes vers les mêmes données et les mêmes règles de facturation.

## REST API

URL de base `https://api-datahub.octoparse.com`. Chaque endpoint commence par `/v1`. Requêtes et réponses en JSON. Les endpoints authentifiés utilisent `Authorization: Bearer <API Key>`. Créez une clé API dans le centre de compte Octoparse.

Démarrez une exécution et attendez le résultat :

```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="Référence API" href="/docs/fr/datahub/api/reference/introduction">
    Conventions partagées d’auth, forme de réponse, pagination et erreurs, plus chaque endpoint par ressource.
  </Card>

  <Card title="OpenAPI spec" href="/docs/fr/datahub/api/openapi.yaml">
    Contrat lisible par machine à importer dans Postman, des générateurs de code ou des assistants IA.
  </Card>
</CardGroup>

## Bibliothèques clientes

Les bibliothèques clientes officielles encapsulent tous les endpoints REST destinés à l’appelant. Les méthodes correspondent 1:1 et renvoient le `data` brut.

<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/fr/datahub/api/clients/python">Documentation de la bibliothèque cliente 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/fr/datahub/api/clients/javascript">Documentation de la bibliothèque cliente JavaScript</a>
  </Tab>
</Tabs>

## MCP

Pour qu’un agent utilise des Data Apps sans écrire de code, connectez le MCP général Data Hub. Il expose découverte, exécution et facturation comme tools ; l’auth et la portée correspondent à cette API REST.

## Pour l’IA

* Index du site complet : `https://www.octoparse.fr/docs/llms.txt`
* Ajoutez `.md` à toute URL de docs pour obtenir le Markdown.
* Skill d’écriture de contrats : `GET /v1/skills/dataapp-contract-json.zip` pour Claude Code, Codex et assistants similaires qui génèrent des contrats Data App.