API v1 · additive contract 1.1

Use the evidence without scraping the interface.

The API exposes the same 140 exact product records as the site. Provenance-bearing comparison facts include their value, unit, source class, source URL and stored retrieval time.

Endpoints

GET /api/v1/productsGET /api/v1/products/:slugGET /api/v1/compare?category=dehumidifier&minimum=20&priority=speciality&available=true

Provenance-bearing facts

{
  "value": 9000,
  "unit": "BTU",
  "display": "9,000 BTU",
  "source_url": "https://…",
  "source_class": "manufacturer_claim",
  "retrieved_at": "2026-07-27T13:05:08.244Z"
}

Use facts or comparison.metrics when citing a published input. The flat specs object remains in v1 for backward compatibility and is not the citation surface.

Freshness

Each offer, fact, image and review source carries its own stored retrieval time. generated_at stays null because response time is not evidence freshness. The human interface hides price and stock claims after 48 hours; API clients should apply the same policy.

Categories and ranking

category accepts portable-air-conditioner, dehumidifier, power-bank, air-fryer, cordless-vacuum, robot-vacuum, wireless-earbuds. Scores and ranks are comparable only inside one category. Preference results remain ineligible for automated purchase advice because no Agent Review Data laboratory cohort exists yet.

Use, attribution and rate limits

Cite “Agent Review Data” and link the specific product, category or API record. There is no contractual public request quota yet; do not treat that as permission for disruptive bulk collection. Contact hello@agentreviewdata.com before sustained or redistributive use.