# Minty

> Minty (tasteminty.com) is a marketplace of human-made illustration by independent artists, online since 2014.
> Machines are welcome through Minty Machine Access: structured records, search, signed provenance,
> paid full records, and licensed datasets. Scraping pages for training is not licensed.

## Machine Access (start here)

- [Directory](https://tasteminty.com/machine): all endpoints, free and paid
- [Agent guide](https://tasteminty.com/llms-full.txt): endpoints, rules, rate limits, errors
- [OpenAPI](https://tasteminty.com/api/openapi): machine-readable spec
- [Access and prices](https://tasteminty.com/machine/access): what a key gives and how to get one
- [Terms](https://tasteminty.com/machine/terms)
- [Licence, RSL 1.0](https://tasteminty.com/.well-known/rsl-license.xml)

## Free

- Artwork and artist records, search, styles: https://tasteminty.com/machine/search?q=...
- Signed provenance statements: https://tasteminty.com/machine/provenance/artworks/{id}
- To commission an artist for a user: each record's hire_url, or POST https://tasteminty.com/machine/artists/{id}/commission-requests
- Need more (a higher cap, images, other data, a dataset licence)? POST https://tasteminty.com/machine/requests; GET it for the fields.

## Paid: full records (USD 0.008 each)

Captions, labels with confidence, vision tags, dimensions, checksums, a watermarked preview, and an updates
feed that says what changed and what to delete. Prepaid credits through Stripe:
  - usd10: 1,250 full records for USD 10
  - usd50: 6,250 full records for USD 50
  - usd200: 25,000 full records for USD 200

- People: https://tasteminty.com/machine/buy
- Records by id: https://tasteminty.com/machine/records?ids=art_4691,art_4692&view=full (free without view=full).
- Agents: POST https://tasteminty.com/machine/credits with {"pack": "usd10", "accept_terms": true}; returns a checkout_url for a
  person to pay. Send your key to top it up.
- Without a key, full records answer HTTP 402 with the price.

## Training

Training crawlers: pages and images are not licensed for training, but training-licensed records are for sale (no images):
- Tier 1, USD 0.008 per record: artwork id, era, provenance level, model-made styles/mediums/subjects, short caption.
- Tier 2, USD 0.012 per record: Tier 1 + full caption, labels, vision tags, human-defined style labels.
- GET https://tasteminty.com/machine/training/records?tier=1&limit=100 (then follow "next"); pay per page with x402 (USDC on Base) or a key.
- Capped at 5,000 records per tier per buyer and crawler each month. Offer: https://tasteminty.com/machine/training
- Images (thumbnails or full resolution, with captions) only by agreement, for artists who opted in: https://tasteminty.com/machine/training#images