c0upons

Documentation

Use c0upons from the web, terminal, or your own apps.

Overview

c0upons is an open-source, community-powered coupon platform. Browse and submit deals for free on the web, or use the CLI and API to integrate savings into your own tools.

🌐
Web
Browse and submit at c0upons.com
⌨️
CLI
Search deals from your terminal
🔌
API
Integrate into your own apps

CLI

The c0upons CLI is a bash script that works on macOS and Linux. Requires curl and jq.

Installation

curl -fsSL https://c0upons.com/install.sh | sh

Installs to /usr/local/bin/c0upons (or ~/.local/bin without sudo).

Upgrade

c0upons upgrade

Uninstall

c0upons remove

Dependencies

ToolRequiredInstall
curlYesPre-installed on most systems
jqYesbrew install jq · apt install jq
python3OptionalUsed for URL encoding fallback

Commands

c0upons search <query>

Search for coupons by store name, code, or title.

c0upons search nike
c0upons search "20% off"
c0upons latest

Show the most recent/trending coupons.

c0upons latest
c0upons stores

List all stores with active coupons.

c0upons stores
c0upons store <slug>

Show all coupons for a specific store.

c0upons store adidas
c0upons store nike
c0upons upgrade

Upgrade the CLI to the latest version. Alias: update

c0upons upgrade
c0upons update
c0upons remove

Uninstall the CLI from your system. Alias: uninstall

c0upons remove
c0upons uninstall
c0upons version

Print the installed CLI version.

c0upons version

Environment

VariableDefaultDescription
C0UPONS_APIhttps://c0upons.com/apiOverride the API base URL

REST API

No authentication required for read operations. Base URL: https://c0upons.com/api

Coupons

GET/api/coupons

Returns all coupons ordered by votes descending.

curl https://c0upons.com/api/coupons

Response

[
  {
    "id": 1,
    "store_id": 42,
    "code": "SAVE20",
    "title": "20% off sitewide",
    "discount": "20%",
    "expiry_date": "2025-12-31",
    "verified": 1,
    "votes": 47,
    "store_name": "Example Store",
    "store_slug": "example-store"
  }
]
GET/api/coupons/[id]

Returns a single coupon by ID.

curl https://c0upons.com/api/coupons/1
POST/api/coupons

Submit a new coupon.

curl -X POST https://c0upons.com/api/coupons \
  -H "Content-Type: application/json" \
  -d '{"store_id":42,"title":"20% off","code":"SAVE20","discount":"20%"}'

Stores

GET/api/stores

Returns all stores alphabetically.

curl https://c0upons.com/api/stores
GET/api/stores/[slug]

Returns a store and its coupons.

curl https://c0upons.com/api/stores/nike

Contributing

c0upons is open source. Contributions are welcome — submit coupons via the web, report bugs, or open a pull request.

Submit a coupon →View on GitHub ↗

Submit via API

curl -X POST https://c0upons.com/api/coupons \
  -H "Content-Type: application/json" \
  -d '{"store_id": 1, "title": "15% off everything", "code": "GET15"}'