---
title: "batch_download tool call"
method: POST
path: "/api/tools/batch_download"
tags: ["Tools"]
---

# batch_download tool call

`POST /api/tools/batch_download`

## Request

- Base URL: `https://studiomcphub.com`
- URL: `https://studiomcphub.com/api/tools/batch_download`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Stripe-Payment-Intent`

Cost: 50 GCX ($5.00). Payment: GCX credits (Bearer token) or Stripe (X-Stripe-Payment-Intent header).

## Request body

- object
  - `dataset_id` string: Dataset ID
  - `offset` integer: Start offset for pagination
  - `quantity` integer: Number of artworks (min 100)

## Response `200`

Tool result

## Other responses

- `402`: Payment required — returns GCX credit info and Stripe checkout link

---

[API](https://skmtc.dev/studiomcphub/apis/studiomcphub-api.md) · [All operations](https://skmtc.dev/studiomcphub/apis/studiomcphub-api/llms.txt) · [OpenAPI document](https://skmtc.dev/studiomcphub/apis/studiomcphub-api/revisions/15995bc5ee2e?raw)