Amazon Creators API
App · 8 actions
Find Amazon products and their affiliate links as an Amazon Associate: search the catalog, look products up by ASIN with price, deal and stock, list variations and categories, download reports and feeds, and start workflows on price drops, restocks and deals.
Actions
| Action | What it does |
|---|---|
| Get categories | Get up to 10 Amazon categories (browse nodes) by ID, with their names, parent categories up to the top and subcategories. |
| Get feed download link | Get a link to download one feed file. |
| Get product variations | List the variations of a product (its sizes, colours and so on), 10 to a page, with each one's price and affiliate link, and the price range across them. |
| Get products | Get up to 10 products by ASIN or product link: title, features, pictures, price, availability, deal, seller, reviews and affiliate link, or the details you choose. |
| Get report download link | Get a link to download one report file. |
| List feeds | List the product and deals feed files your store can download, with when each was updated. |
| List reports | List the report files Amazon has made for your store, with each one's type and date. |
| Search products | Search Amazon for up to 10 products by keywords, title, brand, author, artist or actor, in a department, with price, rating, saving and delivery filters. |
Get categories
Get up to 10 Amazon categories (browse nodes) by ID, with their names, parent categories up to the top and subcategories.
Inputs
- Category IDs
browse_node_idslistRequired - Up to 10 category (browse node) IDs, such as 283155. Products' categories come with 'Get products' or 'Search products'.
- Details to include
resourceslist - Parent categories, subcategories or both. Defaults to both.One or more of:
browseNodes.ancestor(Parent categories, up to the top),browseNodes.children(Subcategories). - Language
languagetext - The language for titles and details. Leave empty for the marketplace's own.
- Tracking ID
tracking_idtext - Another of your tracking IDs for this marketplace, to credit sales from these links to it. Leave empty to use the connection's.
Outputs
browseNodeslist- The categories
errorslist- ASINs or categories Amazon couldn't return, with why; empty when all came back
Example output
{
"browseNodes": [
{
"ancestor": {},
"children": [
{
"contextFreeName": "Subjects",
"displayName": "Subjects",
"id": "1000"
},
{
"contextFreeName": "Books Featured Categories",
"displayName": "Books Featured Categories",
"id": "51546011"
}
],
"contextFreeName": "Books",
"displayName": "Books",
"id": "283155",
"isRoot": true
}
],
"errors": []
}Get feed download link
Get a link to download one feed file. The link works for a short time only, so fetch the file in the next step.
Inputs
- Feed
feed_nametextRequired - The feed file, from 'List feeds'.
- Feed type
feed_typetext - The feed's type, as 'List feeds' gives it.One of:
PRODUCT_FEEDS(Product feed),DEALS_FEEDS(Deals feed).
Outputs
urltext- A link to download the feed, valid for a short time
Example output
{
"url": "https://creatorsapi-reports.s3.amazonaws.com/example?X-Amz-Expires=900"
}Get product variations
List the variations of a product (its sizes, colours and so on), 10 to a page, with each one's price and affiliate link, and the price range across them. Give the product's ASIN or any variation's.
Inputs
- ASIN
asintextRequired - The product's ASIN, or its Amazon link. The ASIN is the 10 letters and digits after /dp/ in the link.
- Details to include
resourceslist - What to get for each product. Leave empty for the title, features, brand, pictures, price, availability, deal, seller, reviews and parent ASIN.One or more of:
itemInfo.title(Title),itemInfo.features(Key features),itemInfo.byLineInfo(Brand, maker and contributors),itemInfo.classifications(Product group and binding),itemInfo.contentInfo(Edition, languages and pages (books, media)),itemInfo.contentRating(Audience rating (media)),itemInfo.externalIds(EAN, ISBN and UPC codes),itemInfo.manufactureInfo(Model, part number and warranty),itemInfo.productInfo(Colour, size, dimensions and release date),itemInfo.technicalInfo(Technical details and formats), and 27 more. - Condition
conditiontext - Only offers in this condition. Defaults to any condition.One of:
Any(Any condition (default)),New(New only). - Variations per page
variation_countnumber - How many variations to get, 1 to 10. Defaults to 10.From 1 to 10.
- Page
variation_pagenumber - Which page of variations. Defaults to the first; the answer says how many pages there are.At least 1.
- Language
languagetext - The language for titles and details. Leave empty for the marketplace's own.
- Currency
currencytext - The currency to show prices in. Leave empty for the marketplace's own.
- Tracking ID
tracking_idtext - Another of your tracking IDs for this marketplace, to credit sales from these links to it. Leave empty to use the connection's.
Outputs
errorslist- ASINs or categories Amazon couldn't return, with why; empty when all came back
itemslist- The variations
variationSummaryobject- All the product's variations together
Example output
{
"errors": [],
"items": [
{
"asin": "B019MNBMS4",
"detailPageURL": "https://www.amazon.co.uk/dp/B019MNBMS4?tag=yourstore-21&linkCode=ogv&th=1&psc=1",
"itemInfo": {
"title": {
"displayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet, Navy",
"label": "Title",
"locale": "en_GB"
}
},
"offersV2": {
"listings": [
{
"availability": {
"maxOrderQuantity": 30,
"message": "In Stock",
"minOrderQuantity": 1,
"type": "IN_STOCK"
},
"condition": {
"conditionNote": "",
"subCondition": "Unknown",
"value": "New"
},
"dealDetails": {
"accessType": "ALL",
"badge": "Limited time deal",
"endTime": "2026-11-27T07:59:59Z",
"percentClaimed": 38,
"startTime": "2026-11-20T08:00:00Z"
},
"isBuyBoxWinner": true,
"merchantInfo": {
"id": "A3P5ROKL5A1OLE",
"name": "Amazon.co.uk"
},
"price": {
"money": {
"amount": 24.99,
"currency": "GBP",
"displayAmount": "\u00a324.99"
},
"pricePerUnit": {
"amount": 24.99,
"currency": "GBP",
"displayAmount": "\u00a324.99 / count"
},
"savingBasis": {
"money": {
"amount": 30.87,
"currency": "GBP",
"displayAmount": "\u00a330.87"
},
"savingBasisType": "LIST_PRICE",
"savingBasisTypeLabel": "RRP"
},
"savings": {
"money": {
"amount": 5.88,
"currency": "GBP",
"displayAmount": "\u00a35.88"
},
"percentage": 19
}
},
"type": "LIGHTNING_DEAL",
"violatesMAP": false
}
]
},
"parentASIN": "B00422MCUS",
"variationAttributes": [
{
"name": "size_name",
"value": "One Size"
},
{
"name": "color_name",
"value": "Navy"
}
]
}
],
"variationSummary": {
"pageCount": 2,
"price": {
"highestPrice": {
"amount": 30.87,
"currency": "GBP",
"displayAmount": "\u00a330.87"
},
"lowestPrice": {
"amount": 17.03,
"currency": "GBP",
"displayAmount": "\u00a317.03"
}
},
"variationCount": 13,
"variationDimensions": [
{
"displayName": "Size",
"name": "size_name",
"values": [
"One Size"
]
},
{
"displayName": "Colour",
"name": "color_name",
"values": [
"Brown",
"Navy",
"Black"
]
}
]
}
}Get products
Get up to 10 products by ASIN or product link: title, features, pictures, price, availability, deal, seller, reviews and affiliate link, or the details you choose.
Inputs
- ASINs
asinslistRequired - Up to 10 products, each an ASIN or an Amazon product link. The ASIN is the 10 letters and digits after /dp/ in the link.
- Details to include
resourceslist - What to get for each product. Leave empty for the title, features, brand, pictures, price, availability, deal, seller, reviews and parent ASIN.One or more of:
itemInfo.title(Title),itemInfo.features(Key features),itemInfo.byLineInfo(Brand, maker and contributors),itemInfo.classifications(Product group and binding),itemInfo.contentInfo(Edition, languages and pages (books, media)),itemInfo.contentRating(Audience rating (media)),itemInfo.externalIds(EAN, ISBN and UPC codes),itemInfo.manufactureInfo(Model, part number and warranty),itemInfo.productInfo(Colour, size, dimensions and release date),itemInfo.technicalInfo(Technical details and formats), and 24 more. - Condition
conditiontext - Only offers in this condition. Defaults to any condition.One of:
Any(Any condition (default)),New(New only). - Language
languagetext - The language for titles and details. Leave empty for the marketplace's own.
- Currency
currencytext - The currency to show prices in. Leave empty for the marketplace's own.
- Tracking ID
tracking_idtext - Another of your tracking IDs for this marketplace, to credit sales from these links to it. Leave empty to use the connection's.
Outputs
errorslist- ASINs or categories Amazon couldn't return, with why; empty when all came back
itemslist- The products
Example output
{
"errors": [],
"items": [
{
"asin": "B09B2SBHQK",
"browseNodeInfo": {
"browseNodes": [
{
"contextFreeName": "Smart Displays",
"displayName": "Smart Displays",
"id": "21579957011",
"isRoot": false,
"salesRank": 3
}
]
},
"customerReviews": {
"count": 128934,
"starRating": {
"value": 4.6
}
},
"detailPageURL": "https://www.amazon.com/dp/B09B2SBHQK?tag=yourstore-20&linkCode=ogi&th=1&psc=1",
"images": {
"primary": {
"large": {
"height": 328,
"url": "https://m.media-amazon.com/images/I/41cNJGm9ZFL._SL500_.jpg",
"width": 500
},
"medium": {
"height": 105,
"url": "https://m.media-amazon.com/images/I/41cNJGm9ZFL._SL160_.jpg",
"width": 160
}
}
},
"itemInfo": {
"byLineInfo": {
"brand": {
"displayValue": "Amazon",
"label": "Brand",
"locale": "en_US"
}
},
"features": {
"displayValues": [
"Echo Show 5 includes a 5.5 inch display",
"Control compatible smart devices like lights and thermostats"
],
"label": "Features",
"locale": "en_US"
},
"title": {
"displayValue": "Amazon Echo Show 5 (newest model), Smart display, Charcoal",
"label": "Title",
"locale": "en_US"
}
},
"offersV2": {
"listings": [
{
"availability": {
"maxOrderQuantity": 30,
"message": "In Stock",
"minOrderQuantity": 1,
"type": "IN_STOCK"
},
"condition": {
"conditionNote": "",
"subCondition": "Unknown",
"value": "New"
},
"dealDetails": {
"accessType": "ALL",
"badge": "Limited time deal",
"endTime": "2026-11-27T07:59:59Z",
"percentClaimed": 38,
"startTime": "2026-11-20T08:00:00Z"
},
"isBuyBoxWinner": true,
"merchantInfo": {
"id": "ATVPDKIKX0DER",
"name": "Amazon.com"
},
"price": {
"money": {
"amount": 59.49,
"currency": "USD",
"displayAmount": "$59.49"
},
"pricePerUnit": {
"amount": 59.49,
"currency": "USD",
"displayAmount": "$59.49 / count"
},
"savingBasis": {
"money": {
"amount": 89.99,
"currency": "USD",
"displayAmount": "$89.99"
},
"savingBasisType": "LIST_PRICE",
"savingBasisTypeLabel": "List Price"
},
"savings": {
"money": {
"amount": 30.5,
"currency": "USD",
"displayAmount": "$30.50"
},
"percentage": 34
}
},
"type": "LIGHTNING_DEAL",
"violatesMAP": false
}
]
},
"parentASIN": "B0BZTW3TCH"
}
]
}Get report download link
Get a link to download one report file. The link works for a short time only, so fetch the file in the next step.
Inputs
- Report
filenametextRequired - The report file, from 'List reports'.
- Report type
report_typetext - The report's type, as 'List reports' gives it.One of:
CREATOR_CENTRAL(Creator Central report),CREATOR_CONNECTIONS(Creator Connections report).
Outputs
urltext- A link to download the report, valid for a short time
Example output
{
"url": "https://creatorsapi-reports.s3.amazonaws.com/example?X-Amz-Expires=900"
}List feeds
List the product and deals feed files your store can download, with when each was updated. Amazon offers feeds to some stores only.
Inputs
None.
Outputs
feedslist- The feed files
Example output
{
"feeds": [
{
"feedName": "deals-feed-us-2026-11-17.json.gz",
"feedType": "DEALS_FEEDS",
"lastUpdated": "2026-11-17T04:00:00Z",
"md5": "e4d909c290d0fb1ca068ffaddf22cbd0",
"size": 1048576
}
]
}List reports
List the report files Amazon has made for your store, with each one's type and date. Amazon makes reports for some stores only.
Inputs
None.
Outputs
reportslist- The report files
Example output
{
"reports": [
{
"filename": "creator-central-earnings-2026-10.csv.gz",
"lastModified": "2026-11-01T06:12:44Z",
"md5": "9e107d9d372bb6826bd81d3542a419d6",
"reportType": "CREATOR_CENTRAL",
"size": 48213
}
]
}Search products
Search Amazon for up to 10 products by keywords, title, brand, author, artist or actor, in a department, with price, rating, saving and delivery filters. Each comes with its affiliate link, price and picture.
Inputs
- Keywords
keywordstext - What to search for. Give this, or at least one of Title, Brand, Author, Artist or Actor.
- Department
search_indextext - The department to search in. Defaults to all departments.
- Sort by
sort_bytext - The order of the results. Defaults to Amazon's own.One of:
Relevance,Featured,NewestArrivals(Newest arrivals),AvgCustomerReviews(Average customer review),Price:LowToHigh(Price, low to high),Price:HighToLow(Price, high to low). - Lowest price
min_pricenumber - Only products with an offer above this price, in the marketplace's currency, such as 20.At least 0.01.
- Highest price
max_pricenumber - Only products with an offer below this price, in the marketplace's currency, such as 100.At least 0.01.
- Customer rating
min_reviews_ratingtext - Only products rated above this.One of:
4(Over 4 stars),3(Over 3 stars),2(Over 2 stars),1(Over 1 star). - Lowest saving (%)
min_saving_percentnumber - Only products with an offer at least this much off, 1 to 99 percent.From 1 to 99.
- Delivery
delivery_flagslist - Only products with an offer that has all of these.One or more of:
Prime(Prime eligible),FreeShipping(Free shipping),FulfilledByAmazon(Fulfilled by Amazon),AmazonGlobal(Ships internationally (AmazonGlobal)). - Condition
conditiontext - Only offers in this condition. Defaults to any condition.One of:
Any(Any condition (default)),New(New only). - Availability
availabilitytext - Whether to include products that are out of stock.One of:
Available(Only products in stock (default)),IncludeOutOfStock(Include out of stock products). - Results
item_countnumber - How many products to get, 1 to 10. Defaults to 10.From 1 to 10.
- Page
item_pagenumber - Which page of results, 1 to 10, each as long as Results. Defaults to the first.From 1 to 10.
- Details to include
resourceslist - What to get for each product. Leave empty for the title, features, brand, pictures, price, availability, deal, seller, reviews and parent ASIN.One or more of:
itemInfo.title(Title),itemInfo.features(Key features),itemInfo.byLineInfo(Brand, maker and contributors),itemInfo.classifications(Product group and binding),itemInfo.contentInfo(Edition, languages and pages (books, media)),itemInfo.contentRating(Audience rating (media)),itemInfo.externalIds(EAN, ISBN and UPC codes),itemInfo.manufactureInfo(Model, part number and warranty),itemInfo.productInfo(Colour, size, dimensions and release date),itemInfo.technicalInfo(Technical details and formats), and 25 more. - Title
titletext - Words in the product's title.
- Brand
brandtext - All or part of the brand's name, such as Sony.
- Author
authortext - All or part of an author's name, for books.
- Artist
artisttext - All or part of an artist's name, for music.
- Actor
actortext - All or part of an actor's name, for films and TV.
- Category ID
browse_node_idtext - Only products in this category (browse node), such as 283155. Products' categories come with 'Get products'.
- Language
languagetext - The language for titles and details. Leave empty for the marketplace's own.
- Currency
currencytext - The currency to show prices in. Leave empty for the marketplace's own.
- Tracking ID
tracking_idtext - Another of your tracking IDs for this marketplace, to credit sales from these links to it. Leave empty to use the connection's.
Outputs
errorslist- ASINs or categories Amazon couldn't return, with why; empty when all came back
itemslist- The products
searchRefinementsobject- Ways to narrow the search (departments, brands, categories), when asked for
searchURLtext- A link to these search results on Amazon, with your tracking ID
totalResultCountnumber- How many products on Amazon match the search
Example output
{
"errors": [],
"items": [
{
"asin": "B09B2SBHQK",
"browseNodeInfo": {
"browseNodes": [
{
"contextFreeName": "Smart Displays",
"displayName": "Smart Displays",
"id": "21579957011",
"isRoot": false,
"salesRank": 3
}
]
},
"customerReviews": {
"count": 128934,
"starRating": {
"value": 4.6
}
},
"detailPageURL": "https://www.amazon.com/dp/B09B2SBHQK?tag=yourstore-20&linkCode=ogi&th=1&psc=1",
"images": {
"primary": {
"large": {
"height": 328,
"url": "https://m.media-amazon.com/images/I/41cNJGm9ZFL._SL500_.jpg",
"width": 500
},
"medium": {
"height": 105,
"url": "https://m.media-amazon.com/images/I/41cNJGm9ZFL._SL160_.jpg",
"width": 160
}
}
},
"itemInfo": {
"byLineInfo": {
"brand": {
"displayValue": "Amazon",
"label": "Brand",
"locale": "en_US"
}
},
"features": {
"displayValues": [
"Echo Show 5 includes a 5.5 inch display",
"Control compatible smart devices like lights and thermostats"
],
"label": "Features",
"locale": "en_US"
},
"title": {
"displayValue": "Amazon Echo Show 5 (newest model), Smart display, Charcoal",
"label": "Title",
"locale": "en_US"
}
},
"offersV2": {
"listings": [
{
"availability": {
"maxOrderQuantity": 30,
"message": "In Stock",
"minOrderQuantity": 1,
"type": "IN_STOCK"
},
"condition": {
"conditionNote": "",
"subCondition": "Unknown",
"value": "New"
},
"dealDetails": {
"accessType": "ALL",
"badge": "Limited time deal",
"endTime": "2026-11-27T07:59:59Z",
"percentClaimed": 38,
"startTime": "2026-11-20T08:00:00Z"
},
"isBuyBoxWinner": true,
"merchantInfo": {
"id": "ATVPDKIKX0DER",
"name": "Amazon.com"
},
"price": {
"money": {
"amount": 59.49,
"currency": "USD",
"displayAmount": "$59.49"
},
"pricePerUnit": {
"amount": 59.49,
"currency": "USD",
"displayAmount": "$59.49 / count"
},
"savingBasis": {
"money": {
"amount": 89.99,
"currency": "USD",
"displayAmount": "$89.99"
},
"savingBasisType": "LIST_PRICE",
"savingBasisTypeLabel": "List Price"
},
"savings": {
"money": {
"amount": 30.5,
"currency": "USD",
"displayAmount": "$30.50"
},
"percentage": 34
}
},
"type": "LIGHTNING_DEAL",
"violatesMAP": false
}
]
},
"parentASIN": "B0BZTW3TCH"
}
],
"searchRefinements": {},
"searchURL": "https://www.amazon.com/s/?field-keywords=echo+show&search-alias=aps&tag=yourstore-20&linkCode=osi",
"totalResultCount": 146
}