Name: Amazon Data – Product & ASIN Lookup | Free · $25/mo | API.market
Brand: openwebninja
SKU: api-openwebninja-real-time-amazon-data
Availability: InStock
Author: API Market

Shashank Agarwal

# 🚀📦 Real-Time Amazon Data API: Comprehensive Product Documentation

Welcome to the Real-Time Amazon Data API—a robust solution for retrieving live Amazon product data, including product details, offers, categories, and more, in real time. This documentation outlines the features, use cases, endpoints, and best practices for leveraging this API within your applications. If you encounter any issues or need additional assistance, please reach out to our customer support.

---

## Overview

The **Real-Time Amazon Data API** is designed to provide fast, accurate, and extensive information from Amazon across multiple regions and marketplaces. Whether you need to track product listings, retrieve detailed offers, or browse through Amazon categories, this API facilitates direct access to the data you need—at scale.

**Key Points**:
- **Fast & Reliable**: Ultra-fast responses for high-volume, real-time data needs.
- **Extensive Dataset**: Retrieve product details, reviews, offers, best sellers, deals, and more.
- **Global Coverage**: Supports multiple Amazon marketplaces (e.g., US, UK, DE, CA, etc.).
- **Easy Integration**: Straightforward HTTP GET endpoints with JSON responses.

---

## Key Features & Capabilities

1. **Product Searches (Keyword or ASIN)**  
   - Retrieve products based on free-form text queries (e.g., “Phone”, “Laptop”), or by searching specific ASINs.  
   - Sort results by relevance, price range, review count, rating, and more.

2. **Product Data & Offers**  
   - Fetch live product prices, images, availability, brand, rating, reviews count, best seller/amazon choice tags, and more.  
   - Filter by condition (New, Used, Renewed, etc.), brand, min/max price, and prime-only listings.

3. **Browse by Category**  
   - Retrieve products in a specific Amazon category (e.g. Books, Electronics) with pagination and advanced filters.  
   - Sort results by featured, newest arrivals, price, and best sellers.

4. **Deals & Discounts**  
   - Easily filter to get discounted products or today’s deals, limiting search results to special offers.

5. **Pagination & Bulk Support**  
   - Paginated responses for large result sets, including page selection and total page count.

6. **Region-Specific Results**  
   - Set the `country` parameter to target a specific Amazon marketplace domain.  
   - Retrieve localized currency, language, and region-based categories.

7. **SEO & Marketing Insights**  
   - Access star ratings, reviews volume, best seller flags, and more to optimize marketing campaigns or build ranking trackers.

8. **Simple Integration & Quick Start**  
   - Straightforward RESTful endpoints.  
   - JSON responses for easy parsing.  
   - “Try for Free” to get started quickly with minimal setup.

---

## Common Use Cases

1. **Price Comparison & Monitoring**  
   - Track product price fluctuations or monitor competitor listings in real time.  
   - Build price alert or comparison tools for eCommerce platforms.

2. **Affiliate Marketing & SEO**  
   - Display live Amazon listings, star ratings, best seller badges, or deals on affiliate websites or blogs.  
   - Keep product info up-to-date without manual updates.

3. **Inventory & Catalog Management**  
   - Integrate with internal systems to enrich product catalogs, ensuring accurate product data, images, brand, and availability.

4. **Product Research & Analytics**  
   - Analyze top sellers, filter by star rating, or identify market gaps by exploring categories.  
   - Gather insights for niche product opportunities or to enhance PPC strategies.

5. **Deal Aggregation Services**  
   - Aggregate and display daily Amazon deals, discounts, or prime-eligible items for deal/trends websites.

6. **Mobile & Voice Apps**  
   - Integrate real-time Amazon searches into your mobile or voice assistant app, letting users find, browse, or compare products instantly.

---

## Authentication & Base URL

- **Base URL**:  
  ```
  https://api.market/store/openwebninja/real-time-amazon-data
  ```

---

## Endpoints Overview

The Real-Time Amazon Data API offers two main endpoints:

1. **`GET /search`**  
   - **Description**: Search for products on Amazon by keyword or ASIN, with pagination and advanced filters (price range, condition, brand, prime-only, etc.).
   - **Typical Use Case**: Searching the Amazon site in real-time for relevant product listings.

2. **`GET /products-by-category`**  
   - **Description**: Retrieve products & offers in a specific Amazon category, with pagination and filtering (condition, brand, prime, deals, etc.).
   - **Typical Use Case**: Browsing an Amazon category or subcategory for advanced catalog building or best seller lookups.

Below is a detailed breakdown for each endpoint, including query parameters, responses, and sample requests.

---

## 1. Product Search — `GET /search`

### Summary
Search for products & offers on Amazon with powerful filters such as price range, product condition, brand, and more. Supports pagination to traverse large result sets.

### Request

**Endpoint**:
```
GET /search
```

**Query Parameters**:

| Parameter              | Type    | Example            | Description                                                                                                                                                                                       |
|------------------------|---------|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **query**             | string  | `Phone`            | Search query (free-form text or product ASIN).                                                                                                                                                   |
| **page**              | integer | `1`                | Results page to return. Typically starts at 1.                                                                                                                                                   |
| **country**           | string  | `US`               | Sets the Amazon domain/region. (e.g., `US`, `UK`, `CA`, etc.)                                                                                                                                    |
| **sort_by**           | string  | `RELEVANCE`        | Sort order for the returned products. Possible values might include `RELEVANCE`, `PRICE_LOW_TO_HIGH`, `PRICE_HIGH_TO_LOW`, `BEST_SELLER`, etc.                                                   |
| **category_id**       | string  | `computers-intl-ship` | (Optional) Filter for a specific named category (non-numeric). For numeric Amazon category IDs, see the `category` parameter.                                                                 |
| **category**          | string  | `1234567890`       | (Optional) Numeric Amazon category ID (e.g. from the URL’s node). Multiple values may be comma-separated.                                                                                        |
| **min_price**         | integer | `105`              | Return only products with price >= this value. In local currency of the `country`.                                                                                                                |
| **max_price**         | integer | `110`              | Return only products with price <= this value. In local currency of the `country`.                                                                                                                |
| **product_condition** | string  | `ALL`              | Product condition filter: `ALL`, `NEW`, `USED`, `RENEWED`, or `COLLECTIBLE`.                                                                                                                      |
| **brand**             | string  | `Google,Apple`     | Filter by brand(s). Comma-separated list.                                                                                                                                                         |
| **seller_id**         | string  | `A1D09S7Q0OD6TH`   | Filter by seller/merchant ID(s). Comma-separated.                                                                                                                                                 |
| **is_prime**          | boolean | `false`            | Only return prime products if `true`.                                                                                                                                                             |
| **deals_and_discounts** | string | `NONE`            | Filter for deals: `NONE`, `ALL_DISCOUNTS`, or `TODAYS_DEALS`.                                                                                                                                     |
| **four_stars_and_up** | boolean | `false`            | Return only products with rating >= 4 stars.                                                                                                                                                      |
| **additional_filters**| string  | (various)          | Amazon-specific filters from the `rh` parameter in search URLs. Comma-separate multiple.                                                                                                          |
| **fields**            | string  | `asin,product_url` | (Optional) Comma-separated list of fields to return. By default, all fields are returned.                                                                                                          |

### Example Request

```bash
GET /search?query=Phone&page=1&country=US&sort_by=RELEVANCE&is_prime=false&four_stars_and_up=true
```

### Response

- **HTTP 200** on success, JSON payload with `status`, `request_id`, `parameters`, and `data`.
- The `data` object typically contains:
  - **`total_products`**: Total matches found.
  - **`country`**: The Amazon region used (`US`, `UK`, etc.).
  - **`domain`**: The domain for the search (e.g., `www.amazon.com`).
  - **`products`**: An array of products. Each product can include:
    - `asin`, `product_title`, `product_price`, `currency`, `product_star_rating`, `product_num_ratings`, `product_url`, `product_photo`, `is_best_seller`, `is_prime`, `sales_volume`, `delivery`, `has_variations`, and more.

**Sample Response** (Truncated):
```json
{
  "status": "OK",
  "request_id": "8b996d8b-de0c-4f3d-8377-306ecfea07aa",
  "parameters": {
    "query": "Phone",
    "country": "US",
    "sort_by": "RELEVANCE",
    "page": 1,
    "is_prime": false
  },
  "data": {
    "total_products": 142342,
    "country": "US",
    "domain": "www.amazon.com",
    "products": [
      {
        "asin": "B0CWHXVLXG",
        "product_title": "Moto G 5G ...",
        "product_price": "$149.99",
        "product_original_price": "$199.99",
        "currency": "USD",
        "product_star_rating": "4.2",
        "product_num_ratings": 1474,
        "product_url": "https://www.amazon.com/dp/B0CWHXVLXG",
        "product_photo": "...",
        "is_best_seller": false,
        "is_prime": true,
        ...
      },
      ...
    ]
  }
}
```

---

## 2. Products by Category — `GET /products-by-category`

### Summary
Retrieve Amazon products & offers from a specific category ID with sorting, paging, price filters, brand filters, prime-only, deals, etc.

### Request

**Endpoint**:
```
GET /products-by-category
```

**Query Parameters**:

| Parameter              | Type    | Example            | Description                                                                                                                                                                                       |
|------------------------|---------|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **category_id**       | string  | `2478868012`       | The Amazon category ID (numeric) or node ID used for searching.                                                                                                                                    |
| **page**              | integer | `1`                | Which page of results to return.                                                                                                                                                                  |
| **country**           | string  | `US`               | Sets the Amazon domain, marketplace country, language, and currency.                                                                                                                             |
| **sort_by**           | string  | `RELEVANCE`        | The order in which results are returned: e.g., `PRICE_LOW_TO_HIGH`, `BEST_SELLER`, etc.                                                                                                           |
| **product_condition** | string  | `ALL`              | Filter by product condition: `ALL`, `NEW`, `USED`, `RENEWED`, `COLLECTIBLE`.                                                                                                                      |
| **min_price**         | number  | `105`              | Return only products priced >= this threshold (in local currency).                                                                                                                                |
| **max_price**         | number  | `110`              | Return only products priced <= this threshold (in local currency).                                                                                                                                |
| **brand**             | string  | `SAMSUNG`          | Filter by brand(s). Comma-separated if multiple.                                                                                                                                                  |
| **is_prime**          | boolean | `false`            | If `true`, only prime-eligible products are returned.                                                                                                                                             |
| **deals_and_discounts** | string | `NONE`            | Include deals/discounts: `NONE`, `ALL_DISCOUNTS`, `TODAYS_DEALS`.                                                                                                                                 |
| **four_stars_and_up** | boolean | `false`            | Return listings with an average rating >= 4 stars.                                                                                                                                                |
| **additional_filters**| string  | (various)          | Additional Amazon filters from the `rh` parameter. Comma-separate multiple.                                                                                                                       |
| **fields**            | string  | `product_price,product_url` | Comma-separated list of fields to include.                                                                                                                                                         |

### Example Request

```bash
GET /products-by-category?category_id=2478868012&page=1&country=US&sort_by=RELEVANCE&is_prime=false
```

### Response

- **HTTP 200** on success, with JSON data including `status`, `request_id`, `parameters`, and an object with `total_products`, `domain`, `country`, and `products`.
- Each product entry includes similar fields to the `/search` endpoint (`asin`, `product_title`, `product_price`, `product_photo`, etc.).

**Sample Response** (Truncated):
```json
{
  "status": "OK",
  "request_id": "afbd3e96-4c73-4e42-8f44-058b1b1a9dd1",
  "parameters": {
    "category_id": "2478868012",
    "country": "US",
    "sort_by": "RELEVANCE",
    "page": 1,
    "is_prime": false
  },
  "data": {
    "total_products": 983312,
    "country": "US",
    "domain": "www.amazon.com",
    "products": [
      {
        "asin": "B0DJQVYV99",
        "product_title": "Forgotten Home Apothecary ...",
        "product_price": "$37.00",
        "currency": "USD",
        "book_format": "Paperback",
        "product_url": "https://www.amazon.com/dp/B0DJQVYV99",
        "product_photo": "...",
        "is_best_seller": true,
        ...
      },
      ...
    ]
  }
}
```

---

## Additional Notes & Best Practices

1. **Pagination**  
   - For large searches, increment the `page` parameter to walk through the results.  
   - Always check `total_products` or any relevant fields to see how many pages might be available.

2. **Filters Usage**  
   - Combining filters (e.g., brand + min_price + is_prime) will narrow results significantly.  
   - If your search yields fewer results than expected, try relaxing some filter parameters.

3. **Rate Limits & Throttling**  
   - Depending on your subscription plan, the API may enforce rate limits.  
   - If you receive throttling errors, implement exponential backoff or upgrade your plan.

4. **Field Projection**  
   - Use `fields` to reduce payload size, improve performance, and return only the data you need.  
   - If omitted, a rich set of default fields is returned.

5. **Error Handling**  
   - Common errors include invalid `country` codes, unavailable category IDs, or out-of-bounds page numbers.  
   - The API will return an HTTP 4xx or 5xx with a JSON body describing the error.

---

## Getting Started Quickly (Try for Free)

1. **Obtain Your API Key**:  
   Sign up on [API.market](https://api.market/) to get your free or paid subscription key.

2. **Test a Simple Search**:  
   ```bash
   curl "https://api.market/store/openwebninja/real-time-amazon-data/search?query=Phone&country=US&page=1"
   -H "x-magicapi-key: YOUR_API_MARKET_KEY"
   ```

3. **Inspect the JSON Response**:  
   Parse through the `products` array to see `asin`, price, rating, etc.

4. **Advance with Filters**:  
   Add additional query parameters (like `min_price` or `brand`) as your use case evolves.

If you have questions or face any error codes, please **contact customer support**. We strive to keep your integration smooth and reliable.

---

The **Real-Time Amazon Data API** provides a powerful, flexible way to seamlessly integrate Amazon product searches, category browsing, and dynamic data into your applications. With straightforward endpoints and comprehensive query parameters, developers can quickly build robust eCommerce, affiliate, or analytics solutions.

**Have questions or need technical help?**  
- Reach out to us anytime if you experience errors or need assistance—**we’re here to help**.

**Ready to get started?**  


Access real-time product data, offers, and reviews from Amazon. Supports all Amazon regions. Free 100 calls/mo, from $25/mo. Start free on API.market.

Amazon Data – Product & ASIN Lookup | Free · $25/mo | API.market

FREE