# AmzDownloader

> Extract Amazon product images and videos through the AmzDownloader API and MCP tools.

- [AmzDownloader API and MCP](https://amzdownloader.mintlify.dev/docs/index.md): Extract Amazon product images and videos with one account. Use REST requests or MCP tools to retrieve media, check freshness and track credits.
- [Extract your first product media](https://amzdownloader.mintlify.dev/docs/quickstart.md): Create an AmzDownloader extraction request, recognize cached results, poll an owned job, and fetch the completed media with your API key.
- [Authenticate with an API key](https://amzdownloader.mintlify.dev/docs/authentication.md): Use an AmzDownloader API key safely with REST and MCP, keep credentials on your server, and understand rejected or revoked key responses.
- [Select the media you need](https://amzdownloader.mintlify.dev/docs/extraction.md): Choose Amazon product and variant images, product videos, related videos and creator videos while preserving warnings and bounded job polling.
- [Understand cache and freshness](https://amzdownloader.mintlify.dev/docs/cache.md): Read cached Amazon media, inspect retrieval time and warnings, and choose when to request a fresh extraction without unbounded retries.
- [Convert a supported video to MP4](https://amzdownloader.mintlify.dev/docs/conversion.md): Convert an Amazon video playlist to an MP4 URL, handle unsupported media and errors, and keep AmzDownloader credentials off download hosts.
- [Connect an agent through MCP](https://amzdownloader.mintlify.dev/docs/mcp-guide.md): Connect an AI agent to AmzDownloader using its hosted MCP endpoint, configure an API key, and run bounded extraction, cache and conversion tools.
- [Run API examples in your language](https://amzdownloader.mintlify.dev/docs/examples.md): Use cURL, JavaScript, Python and Go examples to submit a product extraction, poll with a deadline, read cached media and inspect usage safely.
- [Download Amazon product images with Python](https://amzdownloader.mintlify.dev/docs/tutorials/amazon-images-python.md): Extract product and variant images with Python, handle cached responses and queued jobs, and download source files without exposing your API key.
- [Download Amazon product videos with Node.js](https://amzdownloader.mintlify.dev/docs/tutorials/amazon-videos-nodejs.md): Extract Amazon product videos with Node.js, poll queued jobs safely, inspect source metadata, and optionally convert one HLS playlist into MP4.
- [Process multiple Amazon product URLs](https://amzdownloader.mintlify.dev/docs/tutorials/multiple-product-urls.md): Process a short list of Amazon URLs sequentially, preserve a retry key per product, save checkpoints, and keep request counts and credit use bounded.
- [Connect Claude Code to AmzDownloader MCP](https://amzdownloader.mintlify.dev/docs/clients/claude-code.md): Configure Claude Code with AmzDownloader HTTP MCP, keep the API key in an environment variable, and run a bounded Amazon product-media workflow.
- [Connect Cursor to AmzDownloader MCP](https://amzdownloader.mintlify.dev/docs/clients/cursor.md): Configure Cursor with the AmzDownloader HTTP MCP server, load your API key through its environment syntax, and inspect product-media tool results.
- [Connect VS Code to AmzDownloader MCP](https://amzdownloader.mintlify.dev/docs/clients/vscode.md): Configure an AmzDownloader HTTP MCP server in VS Code, enter your API key through a masked input, and verify local agent access before extraction.
- [Connect Codex to AmzDownloader MCP](https://amzdownloader.mintlify.dev/docs/clients/codex.md): Configure Codex with the AmzDownloader HTTP MCP endpoint, reference your API key through a bearer-token environment variable, and inspect tools.
- [Track usage and credits](https://amzdownloader.mintlify.dev/docs/usage.md): Check your shared AmzDownloader credit balance and understand charges for media retrieval and conversion, free polling, failures and idempotent replays.
- [Handle errors and safe retries](https://amzdownloader.mintlify.dev/docs/errors.md): Interpret AmzDownloader HTTP errors and terminal job states, honor retry timing, preserve request IDs, and retry charged work with idempotency.
- [API and MCP changelog](https://amzdownloader.mintlify.dev/docs/changelog.md): Review the initial AmzDownloader REST and MCP contract, including extraction jobs, cached product media, playlist conversion and shared account credits.
- [Extract product media](https://amzdownloader.mintlify.dev/docs/api-reference/extraction/extract-product-media.md): Extract product images, variant images, and videos. Returns a cached result or an asynchronous job. Costs 1 credit on success, including cache hits. Polling is free. Use an idempotency key for retries.
- [Get extraction status](https://amzdownloader.mintlify.dev/docs/api-reference/extraction/get-extraction-status.md)
- [Get extraction result](https://amzdownloader.mintlify.dev/docs/api-reference/extraction/get-extraction-result.md)
- [Get cached product media](https://amzdownloader.mintlify.dev/docs/api-reference/media/get-cached-product-media.md): Read cached product media without starting extraction. Costs 1 credit on success. Use create scrape to refresh.
- [Convert Amazon video](https://amzdownloader.mintlify.dev/docs/api-reference/media/convert-amazon-video.md): Convert an Amazon media HLS URL into an MP4 URL. Costs 1 credit on success, including cached conversion results. Use an idempotency key for retries.
- [Get account API usage](https://amzdownloader.mintlify.dev/docs/api-reference/account/get-account-api-usage.md)
- [Service health](https://amzdownloader.mintlify.dev/docs/api-reference/discovery/service-health.md)
- [Supported capabilities](https://amzdownloader.mintlify.dev/docs/api-reference/discovery/supported-capabilities.md)
- [OpenAPI specification](https://amzdownloader.mintlify.dev/docs/api-reference/discovery/openapi-specification.md)

## OpenAPI Specs

- [openapi](/docs/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.