data-extraction

Unlock Amazing Deals with the Amazon Product Data API

19 Jun 2025
Unlock Amazing Deals with the Amazon Product Data API

The Amazon Product Data And Insights API provides developers with a powerful tool to access a wealth of product information from Amazon's extensive marketplace. One of the standout features of this API is its ability to retrieve real-time deals, including Today's Deals, Top Deals, Best Deals, and Lightning Deals, tailored to specific filter criteria. This functionality can significantly enhance e-commerce applications, allowing developers to deliver timely and relevant offers to users, ultimately improving user engagement and satisfaction.

Imagine an application that alerts users about the best deals on products they are interested in, or a price comparison tool that helps shoppers find the best prices across different categories. With the Amazon Product Data API, developers can create such applications with ease, streamlining access to valuable product insights while saving time and effort.

Prerequisites

To get started, you will need an API key for the Cognitive Actions and a basic understanding of making API calls.

Retrieve Amazon Marketplace Deals

The Retrieve Amazon Marketplace Deals action allows you to fetch a variety of deals from Amazon's marketplace, providing customers with access to the latest offers based on specified criteria.

Purpose

This action solves the problem of finding relevant deals by allowing users to filter through a plethora of options based on their interests, such as price range, department categories, and discount percentages. It helps users make informed purchase decisions and enhances their shopping experience.

Input Requirements

The input for this action includes a structured request that must specify:

  • domainIdentifier: Identifies the Amazon domain (e.g., "com" for the US).
  • page: The page number for paginated results, defaulting to 1.
  • Optional filters such as pricingRange, earlyPrimeAccess, exclusiveToPrime, departmentCategories, discountPercentRange, and minimumProductStarRating to refine the search results.

Example Input:

{
  "page": 1,
  "domainIdentifier": "com"
}

Expected Output

The output will provide a list of deals that match the specified criteria, including details such as:

  • id: Unique identifier for the deal.
  • url: Direct link to the product.
  • price: Current deal price.
  • title: Name of the product.
  • discountLabel: Information about the discount percentage.
  • mainImage: The primary image of the product.

Example Output:

{
  "deals": [
    {
      "id": "3325e0ad",
      "url": "https://www.amazon.com/BLACK-DECKER-Portable-Conditioner-Display/dp/B01DLPUWHQ",
      "price": 399.99,
      "title": "BLACK+DECKER Smart Portable Air Conditioner",
      "discountLabel": "11% off",
      "mainImage": "https://m.media-amazon.com/images/I/61LcIL7oROL.jpg"
    }
  ]
}

Use Cases for this Action

  1. E-commerce Platforms: Integrate this action to provide users with a dedicated section for deals, enhancing the shopping experience by displaying the best offers available.
  2. Price Comparison Tools: Use the action to aggregate deals across different categories, allowing users to compare prices and find the best options quickly.
  3. Shopping Assistants: Build applications that notify users when their desired products go on sale or meet specific discount criteria, increasing customer satisfaction and loyalty.

```python
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "7faa4622-727a-4e59-a4de-cc6ac1fff6d6" # Action ID for: Retrieve Amazon Marketplace Deals

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "page": 1,
  "domainIdentifier": "com"
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body (non-JSON): {e.response.text}")
    print("------------------------------------------------")



## Conclusion
The Amazon Product Data And Insights API, particularly through the Retrieve Amazon Marketplace Deals action, empowers developers to create applications that enhance user experience by providing timely and relevant deal information. By leveraging this API, you can build robust e-commerce solutions that keep users engaged and informed about the best offers available on the market. To get started, integrate the API into your application and explore the possibilities of creating a smarter shopping experience for your users.
← Back to All Articles