# OpenVibe.Coupons

> Coupon codes for online shops with merchant/domain matching, restrictions, honest expiry and validity reports by people; new codes from members and DealNews every hour.

A code's status is exactly one of unknown, reported_working, reported_failed, expired or disabled. Only recent reports by people can make a code reported_working or reported_failed; a submission, a source or a model cannot. An expiry that nobody stated is "unknown" (null in JSON), and restrictions that were not stated are absent, not "none". Every shop page has a JSON twin at /m/<slug>.json and every code at /c/<id>.json with the same content. Expired and taken-down codes are not in lists, feeds or sitemaps.

## Start here

- [All shops](https://openvibe.coupons/): with recently added codes
- [How codes are labelled](https://openvibe.coupons/about): statuses, the confidence formula, expiry, privacy
- [The OpenVibe Companion](https://openvibe.coupons/companion): the open-source browser extension: codes for the shop you are on, tried when you ask; never rewrites referral links
- [Sitemap](https://openvibe.coupons/sitemap.xml)

## Feeds

- [RSS](https://openvibe.coupons/feed.xml)
- [Atom](https://openvibe.coupons/atom.xml)
- [JSON Feed](https://openvibe.coupons/feed.json)

## Data

- [Shop JSON](https://openvibe.coupons/): append .json to a shop URL (/m/<slug>.json)
- [Merchant lookup API](https://openvibe.coupons/api/v1/merchants/resolve?host=amazon.com): GET /api/v1/merchants/resolve?host=<shop host> (a worked example above) and GET /api/v1/merchants/<id>/coupons; anonymous, rate-limited