Skip to content

Repository files navigation

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

PathStackWhat it shows
node-quickstartNode 20 + fetchBearer auth, look up a product, parse price + cross-retailer cells
python-quickstartPython 3.11 + requestsSame flow in Python; Pydantic types for the response
curl-bashcurl + jqShell one-liners for every endpoint
mcp-claude-desktop@retailerapi/mcpDrop into claude_desktop_config.json so Claude can call the API as tools
custom-gpt-actionOpenAI GPT ActionsThe OpenAPI spec + GPT instructions to ship a "retailerapi Product Lookup" GPT
next-app-routerNext.js 15 RSCServer Component fetches a product, edge-cached
vercel-edge-functionVercel Edge RuntimeSingle-function deploy that proxies through your key
supabase-edge-functionSupabase 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.

About

Copy-paste runnable examples for retailerapi.com — Node, Python, curl, Claude MCP, OpenAI Custom GPT, Next.js, Vercel Edge. Each subdir is standalone.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages