API Overview

OfferPulse API — Real-Time Product Offers & Price Monitoring

Turn any product URL into structured offer data with price, currency, availability, and confidence scoring. Track price history and monitor changes over time.

Subscription Tiers

Tier	Price	Requests/month	Features
BASIC	$0/mo	500	All endpoints, `cached` mode only, community support
PRO	$19/mo	10,000	Cached + `live` modes, price history, email support
ULTRA	$49/mo	50,000	Bulk normalize (up to 50 URLs), monitoring (beta), priority support
MEGA	$149/mo	500,000	Highest rate limits, dedicated support channel

Tier-Gated Features

Feature	BASIC	PRO	ULTRA	MEGA
Normalize (cached)	✅	✅	✅	✅
Normalize (live)	❌	✅	✅	✅
Product lookup	✅	✅	✅	✅
Latest offer	✅	✅	✅	✅
Availability check	✅	✅	✅	✅
Price history	❌	✅	✅	✅
Bulk normalize	❌	❌	✅	✅
Monitoring	❌	❌	✅	✅

Requesting a tier-gated feature on a lower plan returns 403 with a PLAN_REQUIRED error and an upgrade link.

Authentication

All endpoints (except /v1-health) require your X-RapidAPI-Key header, which RapidAPI adds automatically when you subscribe. No separate API key registration is needed — your account is provisioned on first request.

Endpoints & Testing Examples

Health Check

GET /v1-health — No authentication required.

Response:

{ "ok": true, "status": "operational", "version": "1.0.0", "uptime_seconds": 86400, "timestamp": "2026-02-11T12:00:00Z" }

Normalize Product URL

POST /v1-normalize — All tiers (live mode requires PRO+)

Request body:

{ "product_url": "https://www.amazon.com/dp/B0CX23V2ZK", "mode": "cached" }

To use live extraction (PRO, ULTRA, MEGA):

{ "product_url": "https://www.amazon.com/dp/B0CX23V2ZK", "mode": "live", "force_refresh": true }

Response:

{ "ok": true, "product": { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "title": "Wireless Headphones Pro", "brand": "AudioTech", "domain": "amazon.com" }, "offer": { "price": 79.99, "currency": "USD", "availability": "in_stock", "confidence": 0.9 }, "cache": { "hit": false, "age_seconds": 0 }, "request_id": "req_abc123" }

Get Product

GET /v1-product?product_id=PRODUCT_UUID — All tiers

Or by URL: /v1-product?product_url=https://www.amazon.com/dp/B0CX23V2ZK

Response:

{ "ok": true, "product": { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "title": "Wireless Headphones Pro", "brand": "AudioTech", "domain": "amazon.com" }, "latest_offer": { "price": 79.99, "currency": "USD", "availability": "in_stock" }, "request_id": "req_abc123" }

Latest Offer

GET /v1-offers-latest?product_id=PRODUCT_UUID — All tiers

Response:

{ "ok": true, "offer": { "price": 79.99, "currency": "USD", "availability": "in_stock", "merchant": "Amazon", "confidence": 0.9, "extracted_at": "2026-02-11T12:00:00Z" }, "request_id": "req_abc123" }

Check Availability

GET /v1-availability?product_id=PRODUCT_UUID — All tiers

Response:

{ "ok": true, "product_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "availability": "in_stock", "last_checked": "2026-02-11T12:00:00Z", "price": 79.99, "currency": "USD", "request_id": "req_abc123" }

Price History

GET /v1-price-history?product_id=PRODUCT_UUID&period=90d — PRO+ tiers only

Periods: 30d, 90d, 365d

Or by URL — POST /v1-price-history:

{ "product_url": "https://www.amazon.com/dp/B0CX23V2ZK", "period": "90d" }

Response:

{ "ok": true, "product_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "period": "90d", "count": 2, "price_history": [ { "price": 89.99, "currency": "USD", "recorded_date": "2026-01-01" }, { "price": 79.99, "currency": "USD", "recorded_date": "2026-02-01" } ], "request_id": "req_abc123" }

BASIC tier returns 403 PLAN_REQUIRED.

Bulk Normalize

POST /v1-bulk-normalize — ULTRA+ tiers only (up to 50 URLs)

Request body:

{ "urls": [ "https://www.amazon.com/dp/B0CX23V2ZK", "https://www.bestbuy.com/site/1234567", "https://www.walmart.com/ip/987654321" ], "mode": "cached" }

Response:

{ "ok": true, "job_id": "j1b2c3d4-e5f6-7890-abcd-ef1234567890", "request_id": "req_abc123" }

BASIC and PRO tiers return 403 PLAN_REQUIRED.

Job Status

GET /v1-jobs?job_id=JOB_UUID — ULTRA+ tiers

Response:

{ "ok": true, "job": { "id": "j1b2c3d4-e5f6-7890-abcd-ef1234567890", "status": "complete", "output": { "results": [] } }, "request_id": "req_abc123" }

Create Monitor

POST /v1-monitor?action=create — ULTRA+ tiers only

Request body:

{ "product_url": "https://www.amazon.com/dp/B0CX23V2ZK", "interval_minutes": 60 }

Response:

{ "ok": true, "monitor": { "id": "m1b2c3d4-e5f6-7890-abcd-ef1234567890", "enabled": true, "interval_minutes": 60 }, "request_id": "req_abc123" }

BASIC and PRO tiers return 403 PLAN_REQUIRED.

Monitor Status

GET /v1-monitor?action=status&monitor_id=MONITOR_UUID — ULTRA+ tiers

Monitor Changes

GET /v1-monitor?action=changes&product_id=PRODUCT_UUID&since=2026-01-01T00:00:00Z — ULTRA+ tiers

Rate Limits

Every response includes rate limit headers:

X-RateLimit-Requests-Limit — Your monthly limit
X-RateLimit-Requests-Remaining — Requests remaining
X-RateLimit-Requests-Reset — Seconds until reset

Exceeding your limit returns 429 RATE_LIMITED.

Error Handling

All errors return a consistent JSON structure:

{ "ok": false, "error": { "code": "INVALID_INPUT", "message": "product_url is required", "request_id": "req_abc123" } }

Code	HTTP	Description
`INVALID_INPUT`	400	Missing or malformed parameters
`UNAUTHORIZED`	401	Missing API key / not subscribed
`PLAN_REQUIRED`	403	Feature requires a higher tier — includes `upgrade_url`
`NOT_FOUND`	404	Product, job, or monitor not found
`EXTRACTION_FAILED`	422	Could not extract offer data from URL
`RATE_LIMITED`	429	Monthly request quota exceeded
`INTERNAL_ERROR`	500	Unexpected server error

403 PLAN_REQUIRED Example

{ "ok": false, "error": { "code": "PLAN_REQUIRED", "message": "Live mode requires a Pro plan or higher", "upgrade_url": "https://rapidapi.com/bradsan42/api/offer-pulse/pricing", "request_id": "req_abc123" } }

Endpoint Summary

Method	Path	Min Tier	Description
GET	`/v1-health`	Public	Service health check
POST	`/v1-normalize`	BASIC	Normalize product URL (live mode: PRO+)
GET	`/v1-product`	BASIC	Get product by ID or URL
GET	`/v1-offers-latest`	BASIC	Latest offer snapshot
GET	`/v1-availability`	BASIC	Availability status
GET/POST	`/v1-price-history`	PRO	Price history (30d, 90d, 365d)
POST	`/v1-bulk-normalize`	ULTRA	Bulk normalize up to 50 URLs
GET	`/v1-jobs`	ULTRA	Poll async job status
POST/GET	`/v1-monitor`	ULTRA	Create monitor / status / changes

Support & Contact

Need help or have questions? Reach out to us:

General Support: offerpulse@fastmail.com
API Issues: Report through your RapidAPI dashboard or email offerpulse@fastmail.com

We typically respond within 24 hours on business days.