Getting started with the ShopAPIS API

You can make your first ShopAPIS call in under five minutes: grab an API key from the dashboard, send a GET /v1/product request with a marketplace and an identifier, and read back a normalized JSON product object. Authentication is a single Authorization: Bearer header, every endpoint returns the same 40+ field schema, and the examples below are copy-pasteable in curl, Python and JavaScript.

Base URL: https://api.shopapis.com. Get your key from the dashboard — or sign up free first to claim trial credits.

Step 1 — Get an API key

Your API key is created in the dashboard and passed as a Bearer token on every request. Sign in at shopapis.com/dashboard , open the API keys section, and copy the key. Keep it server-side — never ship it in browser code. Each successful request spends one credit (see pricing).

Step 2 — Make your first request

Request a product by marketplace, country and identifier (ASIN, SKU, GTIN/EAN, or URL). The example below fetches an Amazon US product by ASIN.

curl


curl "https://api.shopapis.com/v1/product?marketplace=amazon&country=US&id=B0CHWRXH8B" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python


import requests
 
resp = requests.get(
    "https://api.shopapis.com/v1/product",
    params={"marketplace": "amazon", "country": "US", "id": "B0CHWRXH8B"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
resp.raise_for_status()
product = resp.json()
print(product["title"], product["price"]["current"], product["price"]["currency"])

JavaScript


const params = new URLSearchParams({
  marketplace: "amazon",
  country: "US",
  id: "B0CHWRXH8B",
});
 
const resp = await fetch(`https://api.shopapis.com/v1/product?${params}`, {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
 
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const product = await resp.json();
console.log(product.title, product.price.current, product.price.currency);

Step 3 — Read the response

Every product call returns the same normalized object, so your parsing code works across all 70+ marketplaces. A successful response looks like this:


{
  "marketplace": "amazon",
  "country": "US",
  "identifiers": { "asin": "B0CHWRXH8B", "gtin": "0194253433814" },
  "title": "Apple AirPods Pro (2nd Generation) with USB-C",
  "brand": "Apple",
  "price": { "current": 189.99, "list": 249.00, "currency": "USD", "discount_pct": 24 },
  "availability": { "in_stock": true, "stock": 38 },
  "seller": { "name": "Amazon.com", "fulfillment": "FBA", "buybox_won": true },
  "rating": 4.7,
  "review_count": 51894,
  "category": ["Electronics", "Headphones", "Earbud Headphones"],
  "variants": [{ "sku": "MTJV3", "title": "USB-C", "price": 189.99, "in_stock": true }],
  "images": ["https://m.media-amazon.com/images/I/61SUj2aKoEL._AC_SL1500_.jpg"],
  "url": "https://www.amazon.com/dp/B0CHWRXH8B",
  "fetched_at": "2026-06-05T11:42:03Z"
}

Request parameters

Parameter	Required	Description
`marketplace`	yes	Marketplace slug (e.g. `amazon`, `ebay`, `alibaba`). See all platforms.
`country`	yes	ISO country code routing the request to the correct domain (e.g. `US`, `DE`, `JP`).
`id`	one of	Product identifier — ASIN, SKU, GTIN/EAN/UPC, or MPN.
`url`	one of	Full product URL, as an alternative to `id`.

Handling errors & limits

Check the HTTP status and back off on 429. A 200 carries the product object; 404 means the listing was not found (and is not charged); 401 means a bad key; 429 means you hit your rate limit — retry with exponential backoff. The full strategy, including pagination over search results, is in handling pagination & rate limits.

Next steps

Amazon product data guideA full ASIN → JSON walkthrough.Price-monitoring pipelineSchedule recurring price pulls.All platformsEvery marketplace you can query.Pricing & creditsHow requests map to credits.

Get your API key