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

ActionWhat it does
Get categoriesGet up to 10 Amazon categories (browse nodes) by ID, with their names, parent categories up to the top and subcategories.
Get feed download linkGet a link to download one feed file.
Get product variationsList 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 productsGet 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 linkGet a link to download one report file.
List feedsList the product and deals feed files your store can download, with when each was updated.
List reportsList the report files Amazon has made for your store, with each one's type and date.
Search productsSearch 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 IDsbrowse_node_idslistRequired
Up to 10 category (browse node) IDs, such as 283155. Products' categories come with 'Get products' or 'Search products'.
Details to includeresourceslist
Parent categories, subcategories or both. Defaults to both.One or more of: browseNodes.ancestor (Parent categories, up to the top), browseNodes.children (Subcategories).
Languagelanguagetext
The language for titles and details. Leave empty for the marketplace's own.
Tracking IDtracking_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 a link to download one feed file. The link works for a short time only, so fetch the file in the next step.

Inputs

Feedfeed_nametextRequired
The feed file, from 'List feeds'.
Feed typefeed_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

ASINasintextRequired
The product's ASIN, or its Amazon link. The ASIN is the 10 letters and digits after /dp/ in the link.
Details to includeresourceslist
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.
Conditionconditiontext
Only offers in this condition. Defaults to any condition.One of: Any (Any condition (default)), New (New only).
Variations per pagevariation_countnumber
How many variations to get, 1 to 10. Defaults to 10.From 1 to 10.
Pagevariation_pagenumber
Which page of variations. Defaults to the first; the answer says how many pages there are.At least 1.
Languagelanguagetext
The language for titles and details. Leave empty for the marketplace's own.
Currencycurrencytext
The currency to show prices in. Leave empty for the marketplace's own.
Tracking IDtracking_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

ASINsasinslistRequired
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 includeresourceslist
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.
Conditionconditiontext
Only offers in this condition. Defaults to any condition.One of: Any (Any condition (default)), New (New only).
Languagelanguagetext
The language for titles and details. Leave empty for the marketplace's own.
Currencycurrencytext
The currency to show prices in. Leave empty for the marketplace's own.
Tracking IDtracking_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 a link to download one report file. The link works for a short time only, so fetch the file in the next step.

Inputs

ReportfilenametextRequired
The report file, from 'List reports'.
Report typereport_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

Keywordskeywordstext
What to search for. Give this, or at least one of Title, Brand, Author, Artist or Actor.
Departmentsearch_indextext
The department to search in. Defaults to all departments.
Sort bysort_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 pricemin_pricenumber
Only products with an offer above this price, in the marketplace's currency, such as 20.At least 0.01.
Highest pricemax_pricenumber
Only products with an offer below this price, in the marketplace's currency, such as 100.At least 0.01.
Customer ratingmin_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.
Deliverydelivery_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)).
Conditionconditiontext
Only offers in this condition. Defaults to any condition.One of: Any (Any condition (default)), New (New only).
Availabilityavailabilitytext
Whether to include products that are out of stock.One of: Available (Only products in stock (default)), IncludeOutOfStock (Include out of stock products).
Resultsitem_countnumber
How many products to get, 1 to 10. Defaults to 10.From 1 to 10.
Pageitem_pagenumber
Which page of results, 1 to 10, each as long as Results. Defaults to the first.From 1 to 10.
Details to includeresourceslist
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.
Titletitletext
Words in the product's title.
Brandbrandtext
All or part of the brand's name, such as Sony.
Authorauthortext
All or part of an author's name, for books.
Artistartisttext
All or part of an artist's name, for music.
Actoractortext
All or part of an actor's name, for films and TV.
Category IDbrowse_node_idtext
Only products in this category (browse node), such as 283155. Products' categories come with 'Get products'.
Languagelanguagetext
The language for titles and details. Leave empty for the marketplace's own.
Currencycurrencytext
The currency to show prices in. Leave empty for the marketplace's own.
Tracking IDtracking_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
}

On this page