Actually Useful Deals API
Public read-only endpoints for agents, researchers, and readers who want current active deals in structured form.
API Status
- The API is read-only and public.
- No authentication, API key, OAuth flow, or agent registration is required.
- Only current published deals and public category information are returned.
Endpoints
GET /wp-json/aud/v1/dealslists public active deals.GET /wp-json/aud/v1/categorieslists public deal categories and active deal counts.GET /.well-known/openapi.jsonreturns the OpenAPI 3.1 description.
Useful Deal Filters
category: category slug such ascar-gear,travel, orpower-charging.merchant: merchant name substring.price_max: maximum deal price in USD.discount_min: minimum percent discount when available.updated_after: ISO-8601 timestamp or YYYY-MM-DD date.limit: result limit from 1 to 100.
Good Agent Uses
- Build a shortlist of useful gear deals for a trip, garage, car, camping setup, or under-$25 gift list.
- Compare current deal price, typical price, discount, buyer fit, and skip-if notes.
- Monitor new or recently updated public deals without scraping the site.
API Versioning and Deprecation
- The current contract is versioned under
/wp-json/aud/v1. Additive fields may be added to v1, while breaking changes require a new versioned path. - If a version is retired, the documentation will publish the replacement and timeline before removal. Deprecated responses will use the HTTP
Deprecationheader and a datedSunsetheader during the migration window. - No current v1 endpoint is deprecated.