# Rocket Source API (llms.txt)

This file is intended for LLM-based tools/crawlers to quickly understand Rocket Source’s API documentation and where to find it.

## Primary API documentation (human-readable)

- https://www.rocketsource.io/api-docs

## Base URLs

- Website: https://www.rocketsource.io
- API base: https://app.rocketsource.io

## Authentication

- Use an API token from the Integrations page: https://app.rocketsource.io/integrations
- Send it as an Authorization header:
  - Authorization: Bearer <YOUR_TOKEN>

## Main endpoints (v3)

- GET  /api/v3/scans
  - List completed scans (supports pagination).
- POST /api/v3/scans
  - Upload a new scan (multipart form: `file` + JSON `attributes`).
- POST /api/v3/scans/{scan_id}
  - Fetch scan results (filter/sort/paginate; supports `products` vs `errors` tables).
- DELETE /api/v3/scans/{scan_id}
  - Delete a scan.
- POST /api/v3/scans/{scan_id}/download?type=csv|xlsx|json
  - Download results in CSV/XLSX/JSON.
- GET  /api/v3/scans/{scan_id}/cancel
  - Cancel an in-progress scan.
- POST /api/v3/scans/{scan_id}/export
  - Export scan results to Google Sheets (requires integration).

## Identifier conversion

- POST /api/v3/convert
  - Convert from UPC/EAN/ISBN to matching ASINs (request includes `marketplace` and `ids`).
- POST /api/v3/asin-convert
  - Convert ASINs to known identifiers (request includes `marketplace` and `asins`).

## Related documentation pages

- https://www.rocketsource.io/upc-to-asin
- https://www.rocketsource.io/ean-to-asin
- https://www.rocketsource.io/isbn-to-asin
- https://www.rocketsource.io/asin-to-ean