Amazon Product Advertising API

This Apify Actor provides a seamless interface to the Amazon Product Advertising API. It enables you to search for products, retrieve detailed item information, and get product variations using official Amazon data.

Features

• Search Products: Find items by keywords with advanced filtering (Category, Price, Prime, etc.).
• Product Details: Get comprehensive data for specific products (ASINs).
• Variations: Retrieve all available variations (size, color, style) for a parent product.
• Smart & Simple: No need to manage signatures or credentials manually.

Usage

1. Operations

🔍 SearchItems

Search for products on Amazon.

• UseCase: "Find all 'Sony Headphones' under $200 sorted by price."
• Required: keywords
• Options: searchIndex (Category), sortBy, minPrice/maxPrice, prime, and more.

📦 GetItems

Retrieve specific details for a list of products.

• UseCase: "I have a list of ASINs and need their current price and prime status."
• Required: itemIds (List of ASINs)
• Options: condition, offerCount.

🎨 GetVariations

Get all variations for a specific parent product.

• UseCase: "Get all colors and sizes for this T-Shirt ASIN."
• Required: asin
• Options: variationCount, variationPage.

2. Inputs

Field	Type	Description
operation	Enum	Required. Choose SearchItems, GetItems, or GetVariations.
keywords	String	Search terms (e.g., "iphone 13"). Required for SearchItems.
marketplace	String (Select)	Required. Amazon marketplace domain (e.g. www.amazon.com). Default: www.amazon.com.
itemIds	List	List of ASINs (e.g., ["B08N9Q24M9"]). Required for GetItems.
asin	String	Parent ASIN. Required for GetVariations.
searchIndex	String	Category to search in (e.g., Electronics, Books, All). Default: All.
sortBy	String	Sort results (e.g., Price:LowToHigh, Relevance, NewestArrivals).
itemPage	Number	Page number for search results (1-10).
prime	Boolean	If true, returns only Prime-eligible items.
minPrice / maxPrice	Number	Filter by price range (in cents, e.g., 1000 = $10.00).
condition	Enum	Filter by condition (New, Used, Refurbished, Collectible).
brand	String	Filter by brand name.
resources	List	Specific data to retrieve (e.g., ["ItemInfo.Title", "Offers.Listings.Price"]).

[!TIP] Pro Tip: Use resources to limit the response size if you only need specific fields like Title and Price.

3. Advanced Parameters (JSON)

If you need to pass a parameter not listed in the input form, use the apiParameters JSON field.

{
  "MinReviewsRating": 4,
  "DeliveryFlags": ["FreeShipping"]
}

Parameter Reference

supported searchIndex (Categories)

When using the SearchItems operation, you can specify one of the following categories in the searchIndex field (Default is All):

Supported sortBy Values

Sort the results by a specific ranking.

• Relevance (Default)
• Price:LowToHigh (Price: Low to High)
• Price:HighToLow (Price: High to Low)
• AvgCustomerReviews (Avg. Customer Review)
• NewestArrivals (Newest Arrivals)
• Featured

Output

The actor stores the full JSON response from Amazon in the default Apify Dataset. You can download it in JSON, CSV, or Excel formats.

License

This project is licensed under the Apache License 2.0.