retailerapi examples

Runnable code samples for retailerapi.com — the unified product API covering Walmart, Amazon, eBay, Lowe's, Target, Best Buy, Home Depot. Each subdirectory is a standalone, self-contained example you can copy-paste into your own project.

Get an API key

Sign up free — 1,000 lookups per month, no card required. Your rk_live_* key lands on app.retailerapi.com/app/keys.

Then export it:

export RETAILERAPI_KEY=rk_live_…

Examples

Path	Stack	What it shows
node-quickstart	Node 20 + fetch	Bearer auth, look up a product, parse price + cross-retailer cells
python-quickstart	Python 3.11 + requests	Same flow in Python; Pydantic types for the response
curl-bash	curl + jq	Shell one-liners for every endpoint
mcp-claude-desktop	@retailerapi/mcp	Drop into claude_desktop_config.json so Claude can call the API as tools
custom-gpt-action	OpenAI GPT Actions	The OpenAPI spec + GPT instructions to ship a "retailerapi Product Lookup" GPT
next-app-router	Next.js 15 RSC	Server Component fetches a product, edge-cached
vercel-edge-function	Vercel Edge Runtime	Single-function deploy that proxies through your key
supabase-edge-function	Supabase Edge (Deno)	Same pattern in Deno; useful when you want the lookup to write to your own DB

Endpoints used

All examples use the documented v1 API:

• GET /v1/products/{id} — UPC, EAN, ISBN, ASIN, or Walmart item_id → flat product
• GET /v1/products/{id}/history?timeframe=30d — time-series prices
• POST /v1/products/{id}/refresh — force fresh fetch
• GET /v1/products/{id}/reviews — reviews summary + top reviews
• GET /v1/sellers/{id} — Walmart marketplace seller profile

Full reference: docs.retailerapi.com.

License

MIT. Use these as starters for your own code.