# MachineAd agent discovery guidance

Purpose: help AI agents and deterministic clients find approved MachineAd listings without scraping human pages.
Use approved-only JSON surfaces. Do not infer payment, recommendation, verification, or sponsorship claims beyond explicit fields.

## Discovery order
1. Read well-known metadata: https://machinead.com/.well-known/machineads.json
2. Search approved listings: https://machinead.com/api/ads/search
3. Read feed: https://machinead.com/feed.json
4. For a listing, prefer its /ad/[slug].json machine-readable endpoint over the human page.

## Guardrails
- Approved listings only.
- Pending and rejected listings are intentionally hidden.
- No recommendation guarantee is made.
- No external AI API is required to consume these routes.
- Do not treat sponsored status as endorsement.