API Platform

Build with Amazon product data

Call product search and category endpoints with a scoped Ecomblade API key. Use the returned marketplace data in internal tools, analysis pipelines, and research workflows.

Start free Overview

Authentication and access

Get API access

API Platform access requires an eligible Ecomblade plan. Create a key in the authenticated API Platform, save the secret when it is shown, and send it as a Bearer token. Keys can be revoked from the same workspace.

GET/api/v1/products/searchProduct search · platform, query, page=1, sort?

GET/api/v1/products/categoryCategory products · platform, categoryId, page=1

Example request

curl --get 'https://api.ecomblade.com/api/v1/products/search?platform=amazon&query=wireless+earbuds&page=1' \
  --header 'Authorization: Bearer $ECOMBLADE_API_KEY'

Data returned by the API

Example response

Responses contain normalized product fields plus marketplace-specific data. Depending on the source, useful fields include product identity, URLs, images, price, currency, ratings, reviews, sales and revenue signals, store details, and pagination state.

JSON

{
  "success": true,
  "data": {
    "summary": {
      "query": "wireless earbuds",
      "page": 1
    },
    "items": [
      {
        "itemId": "prod-10001",
        "name": "Wireless Noise-Cancelling Earbuds",
        "slug": "wireless-noise-cancelling-earbuds",
        "url": "https://marketplace.example/products/prod-10001",
        "brand": "Example Audio",
        "image": "https://cdn.example.com/products/prod-10001.jpg",
        "shopId": "shop-501",
        "shopName": "Example Audio Official",
        "price": 29.99,
        "originalPrice": 39.99,
        "discount": 25,
        "currency": "USD",
        "sold": 1280,
        "monthlySold": 340,
        "totalSold": 4620,
        "revenue": 38387.2,
        "monthlyRevenue": 10196.6,
        "totalRevenue": 138553.8,
        "listingDate": "2026-01-15T00:00:00.000Z",
        "reviews": 894,
        "marketplaceData": {
          "amazon": {
            "rating": 4.6,
            "isBestSeller": true,
            "isAmazonChoice": false,
            "location": "United States"
          }
        }
      }
    ],
    "hasFullAccess": true,
    "isLimited": false
  }
}

Useful marketplace signals

Errors and usage limits

Invalid parameters, expired or revoked credentials, plan access, rate limits, upstream parsing, and exhausted pages return explicit HTTP error responses. Clients should check the response status, respect Retry-After when present, and avoid assuming that every marketplace returns identical optional fields.

Available regions

the United States

Access Amazon product search and category data for the United States using country code US.

Explore

Frequently asked questions

Which endpoints support Amazon?

Ecomblade exposes GET /api/v1/products/search and GET /api/v1/products/category for Amazon. Marketplace-specific query parameters are documented in the authenticated API Platform.

Get API access

Choose an eligible plan to create API keys and connect marketplace data to your workflow.

Get API accessNo credit card required.