REST API

The AliExpress Coupon API

Verified AliExpress promo codes, coupons, deals and free-shipping offers as clean JSON. Filter by type and country, get affiliate-ready links, and ship in minutes - from USD 1.99/month.

10,000 requests/month · all endpoints · cancel anytime

Quick start

One authenticated GET request returns live AliExpress coupons.

curl -H "Authorization: Bearer apc_live_YOUR_KEY" \
  "https://alipromocoupons.com/api/v1/coupons?type=promo-codes&country=US&limit=5"

Example response

Predictable JSON you can render straight away.

{
  "object": "list",
  "data": [
    {
      "id": "clx7a1b2c000",
      "slug": "aliexpress-8-off-orders-over-59",
      "title": "$8 OFF Orders Over $59",
      "code": "SAVE8",
      "type": "promo-codes",
      "discount_type": "fixed",
      "discount_value": 8,
      "currency": "USD",
      "min_spend": 59,
      "region": "US",
      "success_rate": 92,
      "url": "https://s.click.aliexpress.com/deep_link.htm?aff_short_key=...",
      "expires_at": "2026-08-31T23:59:59.000Z",
      "updated_at": "2026-07-21T09:00:00.000Z"
    }
  ],
  "pagination": { "total": 128, "count": 1, "limit": 1, "offset": 0, "has_more": true }
}

Why developers choose our AliExpress API

Verified, working codes

Sourced from official affiliate feeds, verified, with a live success rate. Dead codes are removed automatically.

Powerful filters

Filter by offer type, country, code vs no-code, and search - with pagination via limit and offset.

190+ countries

Region-aware coupons for the US, UK, Germany, Brazil, India and every major AliExpress market.

Clean JSON

Stable, well-documented fields. No scraping, no HTML parsing - just structured data you can trust.

Affiliate-ready links

Every coupon includes an AliExpress affiliate deep link, so you can monetise every click you send.

Always current

The dataset is refreshed regularly, so your integration serves fresh, in-date offers around the clock.

Endpoints

GET/v1/couponsList and filter verified AliExpress coupons and deals.
GET/v1/coupons/{slug}Fetch a single coupon by its slug.
GET/v1/metaList valid offer types and country codes for filtering.
Full API reference

Built for coupon apps, extensions and bots

Coupon and deal websites
Browser extensions
Cashback and rewards apps
Price-comparison tools
Telegram and WhatsApp bots
Affiliate marketing sites
Chrome/Firefox add-ons
AI shopping assistants

Try the API now

Paste your API key and send a live request. No key yet? Subscribe on Gumroad.

GET /api/v1/coupons?limit=5

Simple pricing

API subscription
USD 1.99/month
  • 10,000 requests per month
  • Access to every endpoint
  • Filter by type, country and more
  • Affiliate-ready deep links
  • Verified, regularly-updated coupons
  • Cancel anytime on Gumroad

What is the AliExpress Coupon API?

The AliExpress Coupon API is the fastest way to add live AliExpress promo codes and deals to any product. Instead of scraping pages or maintaining your own coupon database, you make a single authenticated request and receive verified coupons as structured JSON - each with its code, discount, minimum spend, country, success rate, expiry and an affiliate-ready link. It is the same trusted data that powers AliPromoCoupons, exposed as a clean REST API you can build on.

Whether you run a coupon website, a browser extension, a cashback app, a price-comparison tool or a shopping bot, the API removes the hardest part of the job: sourcing, verifying and refreshing AliExpress promo codes. Codes are pulled from official affiliate feeds, de-duplicated, checked and updated regularly, and dead codes drop off automatically - so your integration always serves working offers. With filters for offer type and 190+ countries, plus pagination and CORS support, you can ship a fully-featured AliExpress coupon experience in an afternoon, all for a flat USD 1.99 a month.

FAQ

AliExpress Coupon API - FAQ

Everything you need to know about the endpoints, pricing, data and integration.

What is the AliExpress Coupon API?

The AliExpress Coupon API is a simple REST API that returns verified AliExpress promo codes, coupons, vouchers, deals and free-shipping offers as JSON. You send an authenticated GET request and receive structured coupon data - code, discount, minimum spend, country, success rate, expiry and an affiliate-ready link - ready to display in your own app or site.

How much does the AliExpress coupon API cost?

It is a flat USD 1.99 per month subscription with 10,000 requests included and access to every endpoint. There are no per-call fees and you can cancel anytime from Gumroad.

How do I get an API key?

Subscribe on Gumroad, copy the license key from your receipt, then paste it into your AliPromoCoupons account under API access. Your API key is generated instantly and works immediately with the Authorization: Bearer header.

What data does the AliExpress API return?

Each coupon includes its title, code (or null for no-code deals), offer type, discount type and value, currency, minimum spend, country/region, community success rate, expiry date, last-updated timestamp and an affiliate deep link. Everything is returned as clean, predictable JSON.

Can I filter AliExpress coupons by country and type?

Yes. The /coupons endpoint accepts type (coupons, promo-codes, vouchers, deals, discounts, free-shipping, new-user-coupons), country (US, UK, DE, and 190+ more), a code flag, a search query, plus limit and offset for pagination.

Are the coupons verified and kept up to date?

Yes. Codes come from official AliExpress affiliate feeds and trusted sources, are verified, and refreshed regularly. Expired codes are removed automatically and each coupon carries a live success rate, so your integration always serves current, working offers.

Can I use it for a coupon site, browser extension or bot?

Absolutely. The API is built for coupon websites, browser extensions, cashback and price-comparison apps, Telegram and WhatsApp bots, and affiliate marketing tools. CORS is enabled and the affiliate links let you monetise every click.

What programming languages are supported?

Any language that can make an HTTPS request - the API is plain REST + JSON. We provide ready-to-copy examples for cURL, JavaScript, Node.js, Python, PHP, Ruby and Go, and the same pattern works in Java, C#, Rust and more.

Still have a question? Contact us or see how it works.