B2B API

iGift Deal Intelligence API

Access live trust-scored gift card deals, brand data, and pricing analytics programmatically. REST · JSON · Read-only.

Quick start — one command

curl https://igift.app/api/v1/deals \
  -H "X-API-Key: igift_live_<your_key>" \
  -G --data-urlencode "category=gaming" \
     --data-urlencode "limit=10"

Response envelope: { data: [...], meta: { count, limit, hasMore, nextCursor } }

Trust-scored

Every deal carries a Deal Quality Score (0–100) and Confidence Score. Green zone = verified sellers only.

Live data

Deals refreshed from source adapters every 6 hours. isHistoricalLow flag when price hits an all-time low.

Multi-region

Filter by region (US, GB, CA, AU, …). countryRedeemable array on every offer.

Authentication

Pass your API key in every request via the X-API-Key header (or Authorization: Bearer <key>).

# Header
X-API-Key: igift_live_<your_key>

# Or Bearer
Authorization: Bearer igift_live_<your_key>

• Keys are prefixed igift_live_ followed by 64 hex characters
• Keys are shown once at creation — store them securely
• Rate limit headers are returned on every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
• Exceeded limit: HTTP 429 with Retry-After header

Endpoints

GET/api/v1/dealsList active deals, sorted by deal score

Parameter	Type	Description
`category`	string	Filter: gaming \| app_stores \| streaming \| retail \| food_dining \| travel \| telecom
`trust_zone`	string	Filter: green (default for free) \| yellow \| red
`region`	string	ISO country code — e.g. US, GB, CA
`min_score`	number	Minimum deal score 0–100
`limit`	number	Max results: 1–100 (free) \| 1–200 (pro). Default 50
`cursor`	string	Opaque pagination cursor from previous response meta.nextCursor

GET/api/v1/brandsList all active brands with offer counts

Parameter	Type	Description
`category`	string	Filter by category
`limit`	number	Max results: 1–200. Default 100
`cursor`	string	Pagination cursor

GET/api/v1/brands/:slugSingle brand with all its current active offers

Parameter	Type	Description
`slug`	path	Brand slug e.g. amazon, google-play, steam

GET/api/v1/statsPlatform statistics: total active deals, brands, historical lows, by-category breakdown

Plans

All plans are read-only. We never expose affiliate URLs via the API — visit igift.app/deals for click-outs.

Free

100 requests / hour

✓Green-zone deals only (by default)
✓Up to 100 results per request
✓All 4 endpoints
✓/api/v1/stats included

Request a key

Pro

Recommended

1,000 requests / hour

✓All trust zones (green, yellow, red)
✓Up to 200 results per request
✓Priority support
✓Webhook delivery (coming soon)

Contact sales

Response format

Success

{
  "data": [
    {
      "id": 42,
      "title": "Amazon Gift Card $50",
      "brand": "Amazon",
      "brandSlug": "amazon",
      "category": "retail",
      "faceValueCents": 5000,
      "effectivePriceCents": 4250,
      "currency": "USD",
      "discountPct": 15.0,
      "dealScore": 82,
      "confidenceScore": 91,
      "finalScore": 86,
      "trustZone": "green",
      "isHistoricalLow": false,
      "lastSeenAt": "2026-04-05T..."
    }
  ],
  "meta": {
    "count": 1,
    "limit": 50,
    "hasMore": true,
    "nextCursor": "86:42",
    "tier": "free"
  }
}

Error

// 401 — missing or invalid key
{
  "error": "invalid_api_key",
  "message": "API key not found or revoked."
}

// 429 — rate limit
{
  "error": "rate_limit_exceeded",
  "message": "Rate limit of 100 req/hour exceeded.",
  "retryAfterSeconds": 1847
}

// HTTP headers on 429:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1744000000
Retry-After: 1847

Ready to integrate?

Email us with your use case and we'll issue a key within 24 hours.

Request API Access

Questions? api@igift.app