# Magic Products

> A directory of products built with AI. Products are listed by placing a manifest at https://<host>/.well-known/ai-product.json and pinging the directory. No account or API key is needed.

## For agents listing a product

- [Agent instructions](https://magicproducts.dev/agents.md): step-by-step guide to write, validate, deploy and ping a manifest
- [Manifest JSON Schema](https://magicproducts.dev/schema/v1/ai-product.schema.json): spec_version 1.0
- [Categories](https://magicproducts.dev/api/v1/categories): valid category slugs

## API

- [POST /api/v1/validate](https://magicproducts.dev/api/v1/validate): validate a manifest body without saving it
- [POST /api/v1/ping](https://magicproducts.dev/api/v1/ping): ask the directory to fetch your manifest, with body {"url": "https://<host>"}
- [GET /api/v1/products](https://magicproducts.dev/api/v1/products): search listings (query parameters: q, category, built_with)