API REFERENCE

One key. Every marketplace. Plain JSON.

Base URL https://api.gw.ecommdatahub.com. Send your access key in the X-API-Key header; every response is JSON and reports what it cost in X-Credits-Charged. $1 = 1,000 credits.

cURL
curl "https://api.gw.ecommdatahub.com/amazon/v2/products/search?q=wireless+earbuds&marketplace=US" \
  -H "X-API-Key: edh_live_9f2k...q7x"

Machine-readable: openapi.json (OpenAPI 3.1, generated from the same catalog).

A

Amazon DataHub

Products, offers, reviews & rankings · plans & rates →

GEThttps://api.gw.ecommdatahub.com/amazon/v2/products/searchfrom 2 cr

Product search

Search the Amazon catalog by keyword.

PARAMETERDESCRIPTION · EXAMPLE
qREQUIREDSearch keywords wireless earbuds
marketplaceoptionalMarketplace country code us
pageoptionalResult page 1
Example response ▾
200 OK · application/json · X-Credits-Charged: 2
{
    "page": 1,
    "items": [
        {
            "asin": "B0C1XKX7Z4",
            "price": 29.99,
            "title": "Wireless Earbuds X2",
            "currency": "USD"
        }
    ],
    "total": 18234
}
GEThttps://api.gw.ecommdatahub.com/amazon/v2/products/detailfrom 1.2 cr

Product detail

Full product record for one ASIN.

PARAMETERDESCRIPTION · EXAMPLE
asinREQUIREDProduct ASIN B0C1XKX7Z4
marketplaceoptionalMarketplace country code us
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.2
{
    "asin": "B0C1XKX7Z4",
    "brand": "Auria",
    "price": 29.99,
    "title": "Wireless Earbuds X2",
    "rating": 4.6,
    "in_stock": true,
    "reviews_count": 12873
}
GEThttps://api.gw.ecommdatahub.com/amazon/v2/reviews/listfrom 0.8 cr

Reviews list

Paginated reviews for a product.

PARAMETERDESCRIPTION · EXAMPLE
asinREQUIREDProduct ASIN B0C1XKX7Z4
pageoptionalResult page 1
Example response ▾
200 OK · application/json · X-Credits-Charged: 0.8
{
    "total": 12873,
    "reviews": [
        {
            "id": "R1K4",
            "title": "Great value",
            "rating": 5,
            "verified": true
        }
    ]
}
GEThttps://api.gw.ecommdatahub.com/amazon/v2/products/offersfrom 1.2 cr

Offers

Buy-box and third-party offers for an ASIN.

PARAMETERDESCRIPTION · EXAMPLE
asinREQUIREDProduct ASIN B0C1XKX7Z4
conditionoptionalnew | used | any new
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.2
{
    "asin": "B0C1XKX7Z4",
    "total": 7,
    "buybox": {
        "price": 29.99,
        "seller": "Auria Official"
    },
    "offers": [
        {
            "price": 28.5,
            "seller": "TechDeals",
            "condition": "new"
        }
    ]
}
GEThttps://api.gw.ecommdatahub.com/amazon/v2/bestsellers/listfrom 1.6 cr

Best sellers

Category best-seller ranks, updated hourly.

PARAMETERDESCRIPTION · EXAMPLE
categoryREQUIREDCategory node id or slug electronics
marketplaceoptionalMarketplace country code us
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.6
{
    "items": [
        {
            "asin": "B0C8PLX2M4",
            "rank": 1,
            "title": "Wireless Earbuds, 48H Playtime"
        }
    ],
    "category": "electronics",
    "updated_at": "2026-08-27T10:00:00Z"
}
E

eBay DataHub

Listings, sold history & seller data · plans & rates →

GEThttps://api.gw.ecommdatahub.com/ebay/v2/listings/searchfrom 1.6 cr

Listing search

Search live or sold eBay listings.

PARAMETERDESCRIPTION · EXAMPLE
qREQUIREDSearch keywords vintage camera
soldoptionaltrue = sold listings false
conditionoptionalnew | used | any any
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.6
{
    "total": 932,
    "listings": [
        {
            "id": "295712345",
            "price": 45,
            "title": "Vintage Camera AE-1",
            "ends_in": "2h 14m"
        }
    ]
}
GEThttps://api.gw.ecommdatahub.com/ebay/v2/listings/detailfrom 1.2 cr

Listing detail

Full item detail including shipping and returns.

PARAMETERDESCRIPTION · EXAMPLE
item_idREQUIREDeBay item id 295712345
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.2
{
    "price": 45,
    "title": "Vintage Camera AE-1",
    "item_id": "295712345",
    "returns": "30 days",
    "shipping": {
        "cost": 5.9,
        "days": "3-5"
    }
}
GEThttps://api.gw.ecommdatahub.com/ebay/v2/sold/historyfrom 2 cr

Sold history

Realized prices for comparable items, 90 days.

PARAMETERDESCRIPTION · EXAMPLE
qREQUIREDItem keywords or id vintage camera ae-1
daysoptionalLookback window (max 90) 90
Example response ▾
200 OK · application/json · X-Credits-Charged: 2
{
    "count": 184,
    "median": 30.5,
    "series": [
        {
            "date": "2026-08-01",
            "price": 31.99
        },
        {
            "date": "2026-08-15",
            "price": 29.99
        }
    ]
}
GEThttps://api.gw.ecommdatahub.com/ebay/v2/sellers/profilefrom 0.8 cr

Seller profile

Feedback score, ratings breakdown, store info.

PARAMETERDESCRIPTION · EXAMPLE
seller_idREQUIREDSeller username topdeals_uk
Example response ▾
200 OK · application/json · X-Credits-Charged: 0.8
{
    "seller_id": "topdeals_uk",
    "items_sold": 48211,
    "feedback_pct": 99.1,
    "member_since": "2014"
}
W

Walmart DataHub

Product catalog & store availability · plans & rates →

GEThttps://api.gw.ecommdatahub.com/walmart/v2/products/searchfrom 1.6 cr

Product search

Search the Walmart catalog.

PARAMETERDESCRIPTION · EXAMPLE
qREQUIREDSearch keywords air fryer
pageoptionalResult page 1
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.6
{
    "items": [
        {
            "id": "WM-55231",
            "price": 24.88,
            "title": "6-Quart Air Fryer",
            "currency": "USD"
        }
    ],
    "total": 1287
}
GEThttps://api.gw.ecommdatahub.com/walmart/v2/products/detailfrom 1.2 cr

Product detail

Item detail with pricing and media.

PARAMETERDESCRIPTION · EXAMPLE
item_idREQUIREDWalmart item id WM-55231
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.2
{
    "id": "WM-55231",
    "price": 24.88,
    "title": "6-Quart Air Fryer",
    "rating": 4.4,
    "in_stock": true
}
GEThttps://api.gw.ecommdatahub.com/walmart/v2/stores/availabilityfrom 2 cr

Store availability

In-store stock by zip code.

PARAMETERDESCRIPTION · EXAMPLE
item_idREQUIREDWalmart item id WM-55231
zipREQUIREDUS zip code 94105
Example response ▾
200 OK · application/json · X-Credits-Charged: 2
{
    "stores": [
        {
            "qty": 6,
            "stock": "in_stock",
            "store": "San Francisco #2280"
        }
    ],
    "item_id": "WM-55231"
}
GEThttps://api.gw.ecommdatahub.com/walmart/v2/reviews/listfrom 0.8 cr

Reviews list

Paginated customer reviews.

PARAMETERDESCRIPTION · EXAMPLE
item_idREQUIREDWalmart item id WM-55231
pageoptionalResult page 1
Example response ▾
200 OK · application/json · X-Credits-Charged: 0.8
{
    "total": 812,
    "reviews": [
        {
            "title": "Works great",
            "rating": 5
        }
    ]
}
S

Shopify DataHub

Storefront catalogs & price tracking · plans & rates →

GEThttps://api.gw.ecommdatahub.com/shopify/v2/products/listfrom 1.2 cr

Products list

Full public catalog for a shop domain.

PARAMETERDESCRIPTION · EXAMPLE
shopREQUIREDShop domain allbirds.com
pageoptionalResult page 1
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.2
{
    "page": 1,
    "shop": "allbirds.com",
    "items": [
        {
            "id": "8837120",
            "price": {
                "value": 98,
                "currency": "USD"
            },
            "title": "Wool Runner",
            "in_stock": true
        }
    ]
}
GEThttps://api.gw.ecommdatahub.com/shopify/v2/products/detailfrom 0.8 cr

Product detail

Variants, options, images, availability.

PARAMETERDESCRIPTION · EXAMPLE
shopREQUIREDShop domain allbirds.com
product_idREQUIREDProduct id or handle wool-runner
Example response ▾
200 OK · application/json · X-Credits-Charged: 0.8
{
    "id": "8837120",
    "title": "Wool Runner",
    "variants": [
        {
            "sku": "WR-M-9",
            "price": 98,
            "available": true
        }
    ]
}
GEThttps://api.gw.ecommdatahub.com/shopify/v2/collections/listfrom 0.8 cr

Collections

Collections with product membership.

PARAMETERDESCRIPTION · EXAMPLE
shopREQUIREDShop domain allbirds.com
Example response ▾
200 OK · application/json · X-Credits-Charged: 0.8
{
    "collections": [
        {
            "title": "Men's Shoes",
            "handle": "mens-shoes",
            "products": 42
        }
    ]
}
GEThttps://api.gw.ecommdatahub.com/shopify/v2/products/historyfrom 2 cr

Price history

Tracked price changes, 12 months.

PARAMETERDESCRIPTION · EXAMPLE
shopREQUIREDShop domain allbirds.com
product_idREQUIREDProduct id or handle wool-runner
Example response ▾
200 OK · application/json · X-Credits-Charged: 2
{
    "series": [
        {
            "date": "2026-05-01",
            "price": 110
        },
        {
            "date": "2026-08-01",
            "price": 98
        }
    ],
    "product": "wool-runner"
}
X

AliExpress DataHub

Catalog, pricing & shipping data · plans & rates →

GEThttps://api.gw.ecommdatahub.com/aliexpress/v2/products/searchfrom 1.6 cr

Product search

Keyword search with ship-from filters.

PARAMETERDESCRIPTION · EXAMPLE
qREQUIREDSearch keywords usb c hub
ship_fromoptionalWarehouse country code cn
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.6
{
    "items": [
        {
            "id": "ALX-2231",
            "price": 12.4,
            "title": "7-in-1 USB-C Hub",
            "currency": "USD"
        }
    ],
    "total": 5211
}
GEThttps://api.gw.ecommdatahub.com/aliexpress/v2/products/detailfrom 1.2 cr

Product detail

SKU matrix, tiered pricing, seller info.

PARAMETERDESCRIPTION · EXAMPLE
product_idREQUIREDProduct id ALX-2231
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.2
{
    "id": "ALX-2231",
    "skus": [
        {
            "sku": "grey",
            "price": 12.4,
            "stock": 1834
        }
    ],
    "title": "7-in-1 USB-C Hub",
    "seller": {
        "name": "HubStore",
        "rating": 97.8
    }
}
GEThttps://api.gw.ecommdatahub.com/aliexpress/v2/logistics/estimatefrom 1.2 cr

Shipping estimate

Lanes, cost and delivery window by country.

PARAMETERDESCRIPTION · EXAMPLE
product_idREQUIREDProduct id ALX-2231
countryREQUIREDDestination country code de
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.2
{
    "options": [
        {
            "cost": 2.14,
            "days": "12-18",
            "carrier": "Cainiao"
        }
    ],
    "product_id": "ALX-2231"
}
GEThttps://api.gw.ecommdatahub.com/aliexpress/v2/sellers/ratingsfrom 0.8 cr

Seller ratings

Store scores and dispute rates.

PARAMETERDESCRIPTION · EXAMPLE
seller_idREQUIREDStore id HubStore
Example response ▾
200 OK · application/json · X-Credits-Charged: 0.8
{
    "followers": 12894,
    "seller_id": "HubStore",
    "disputes_pct": 0.4,
    "positive_pct": 97.8
}
T

Etsy DataHub

Handmade listings & shop stats · plans & rates →

GEThttps://api.gw.ecommdatahub.com/etsy/v2/listings/searchfrom 1.2 cr

Listing search

Keyword search with category filters.

PARAMETERDESCRIPTION · EXAMPLE
qREQUIREDSearch keywords ceramic mug
sortoptionalrelevance | newest | price relevance
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.2
{
    "total": 3411,
    "listings": [
        {
            "id": "ET-99812",
            "shop": "ClayAndCo",
            "price": 18.5,
            "title": "Handmade Ceramic Mug"
        }
    ]
}
GEThttps://api.gw.ecommdatahub.com/etsy/v2/listings/detailfrom 0.8 cr

Listing detail

Full listing with materials and variants.

PARAMETERDESCRIPTION · EXAMPLE
listing_idREQUIREDListing id ET-99812
Example response ▾
200 OK · application/json · X-Credits-Charged: 0.8
{
    "id": "ET-99812",
    "title": "Handmade Ceramic Mug",
    "variants": [
        {
            "name": "12oz",
            "price": 18.5
        }
    ],
    "materials": [
        "stoneware"
    ]
}
GEThttps://api.gw.ecommdatahub.com/etsy/v2/shops/statsfrom 1.2 cr

Shop stats

Sales counts, admirers, shop age.

PARAMETERDESCRIPTION · EXAMPLE
shop_idREQUIREDShop name ClayAndCo
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.2
{
    "shop": "ClayAndCo",
    "sales": 20411,
    "since": "2017",
    "admirers": 3120
}
GEThttps://api.gw.ecommdatahub.com/etsy/v2/reviews/listfrom 0.8 cr

Reviews list

Paginated shop and listing reviews.

PARAMETERDESCRIPTION · EXAMPLE
shop_idREQUIREDShop name ClayAndCo
pageoptionalResult page 1
Example response ▾
200 OK · application/json · X-Credits-Charged: 0.8
{
    "total": 1834,
    "reviews": [
        {
            "rating": 5,
            "comment": "Beautiful glaze"
        }
    ]
}

Taobao DataHub

Taobao & Tmall items, translated · plans & rates →

GEThttps://api.gw.ecommdatahub.com/taobao/v2/products/searchfrom 2.4 cr

Product search

Keyword search with optional EN translation.

PARAMETERDESCRIPTION · EXAMPLE
qREQUIREDSearch keywords bluetooth speaker
translateoptionalTranslate fields to language code en
Example response ▾
200 OK · application/json · X-Credits-Charged: 2.4
{
    "items": [
        {
            "id": "TB-778201",
            "price": {
                "value": 89,
                "currency": "CNY"
            },
            "title": "蓝牙音箱 Bluetooth Speaker"
        }
    ],
    "total": 40211
}
GEThttps://api.gw.ecommdatahub.com/taobao/v2/products/detailfrom 1.6 cr

Product detail

SKU matrix, promos, seller and shop data.

PARAMETERDESCRIPTION · EXAMPLE
item_idREQUIREDTaobao item id TB-778201
translateoptionalTranslate fields to language code en
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.6
{
    "id": "TB-778201",
    "shop": {
        "name": "声动旗舰店",
        "rating": 4.9
    },
    "skus": [
        {
            "name": "black",
            "price_cny": 89,
            "price_usd": 12.3
        }
    ],
    "title": "Bluetooth Speaker"
}
GEThttps://api.gw.ecommdatahub.com/taobao/v2/products/image-searchfrom 4 cr

Image search

Find items matching an uploaded image.

PARAMETERDESCRIPTION · EXAMPLE
image_urlREQUIREDPublic image URL https://example.com/speaker.jpg
Example response ▾
200 OK · application/json · X-Credits-Charged: 4
{
    "matches": [
        {
            "id": "TB-778201",
            "price": {
                "value": 89,
                "currency": "CNY"
            },
            "title": "蓝牙音箱 Bluetooth Speaker",
            "similarity": 0.94
        }
    ]
}
GEThttps://api.gw.ecommdatahub.com/taobao/v2/sellers/profilefrom 1.2 cr

Seller profile

Shop ratings, DSR scores, years active.

PARAMETERDESCRIPTION · EXAMPLE
shop_idREQUIREDShop id or name 声动旗舰店
Example response ▾
200 OK · application/json · X-Credits-Charged: 1.2
{
    "dsr": {
        "desc": 4.9,
        "service": 4.8,
        "logistics": 4.9
    },
    "shop": "声动旗舰店",
    "years": 7
}

Errors

Every non-2xx response is {"ok":false,"error":{"code","message","details"}}. Rate-limit state rides on every response as X-RateLimit-Limit / -Remaining / -Reset; 429s add Retry-After.

STATUS · CODEMEANINGWHAT TO DO
401 UNAUTHENTICATEDThe X-API-Key header is missing, malformed or unknown.Send a valid access key; create or rotate one in the console under Keys.
403 ACCOUNT_INACTIVEThe account behind the key is suspended or under review.Check your inbox for the reason and contact support.
403 KEY_SCOPE_FORBIDDENThe key is not scoped to this service.Use a key whose scopes include the service, or create one that does.
403 KEY_IP_FORBIDDENThe request came from an address outside the key's IP allowlist.Call from an allowed address or edit the allowlist on the key.
404 UNKNOWN_ENDPOINTNo endpoint at this path/version (or one your plan cannot see).Compare the path with this reference; private endpoints need a plan that includes them.
402 NOT_SUBSCRIBEDNo active subscription for this service.Subscribe in the console — pay-as-you-go has no monthly fee.
402 PAYMENT_FAILEDA renewal payment failed and access is paused until it succeeds.Update the card under Billing; access resumes on the next successful charge.
402 INSUFFICIENT_CREDITSThe monthly quota is used up and the credit wallet is empty.Top up credits (or enable auto top-up) — the request is retried as soon as credits exist.
429 QUOTA_EXHAUSTEDA hard plan quota or per-endpoint cap was reached for this window.Wait for the window to reset (see the error details) or move to a larger plan.
429 RATE_LIMITEDMore requests per second than the plan allows.Back off using Retry-After and the X-RateLimit-* headers, then retry.
503 NODE_SYNCINGThe gateway node that took the request is still loading its state.Retry after a few seconds — other nodes may already answer.
503 NODE_UNAVAILABLEThe gateway node cannot reach its state store.Retry with exponential backoff; the status page shows fleet health.
410 ENDPOINT_SUNSETThis endpoint version was retired after its announced sunset date.Migrate to the successor named in the Link header and in error.details.replacement.

Versioning policy

How endpoints change without breaking your integration.

Versions are path segments/amazon/v2/products/search. A new major version is a new path; the old one keeps answering unchanged.
Additive changes are not versions — new optional parameters and new response fields can appear at any time; never rely on key order or on unknown fields being absent.
Deprecations are announced in-band, at least 90 days before sunset — a deprecated endpoint answers with Deprecation, Sunset: <HTTP date> and Link: <successor>; rel="successor-version" headers, is flagged on this page and in openapi.json (deprecated: true), and your account is notified by email.
After the sunset date the path returns 410 ENDPOINT_SUNSET with error.details.replacement naming the successor — nothing is silently redirected.

Start with 5,000 free credits.

No card required. Create a key, hit the playground, and see structured marketplace data in under five minutes.

Create free account