# Amazon Creators API

> 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.

App · 8 actions. Web page: https://docs.lodol.com/docs/integrations/amazon-creators-api

## Actions

### 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_ids`, list, required): Up to 10 category (browse node) IDs, such as 283155. Products' categories come with 'Get products' or 'Search products'.
- Details to include (`resources`, list): Parent categories, subcategories or both. Defaults to both. One or more of: `browseNodes.ancestor` (Parent categories, up to the top), `browseNodes.children` (Subcategories).
- Language (`language`, text): The language for titles and details. Leave empty for the marketplace's own.
- Tracking ID (`tracking_id`, text): Another of your tracking IDs for this marketplace, to credit sales from these links to it. Leave empty to use the connection's.

**Outputs**

- `browseNodes` (list): The categories
- `errors` (list): ASINs or categories Amazon couldn't return, with why; empty when all came back

**Example output**

```json
{
  "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_name`, text, required): The feed file, from 'List feeds'.
- Feed type (`feed_type`, text): The feed's type, as 'List feeds' gives it. One of: `PRODUCT_FEEDS` (Product feed), `DEALS_FEEDS` (Deals feed).

**Outputs**

- `url` (text): A link to download the feed, valid for a short time

**Example output**

```json
{
  "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 (`asin`, text, required): The product's ASIN, or its Amazon link. The ASIN is the 10 letters and digits after /dp/ in the link.
- Details to include (`resources`, list): 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 (`condition`, text): Only offers in this condition. Defaults to any condition. One of: `Any` (Any condition (default)), `New` (New only).
- Variations per page (`variation_count`, number): How many variations to get, 1 to 10. Defaults to 10. From 1 to 10.
- Page (`variation_page`, number): Which page of variations. Defaults to the first; the answer says how many pages there are. At least 1.
- Language (`language`, text): The language for titles and details. Leave empty for the marketplace's own.
- Currency (`currency`, text): The currency to show prices in. Leave empty for the marketplace's own.
- Tracking ID (`tracking_id`, text): Another of your tracking IDs for this marketplace, to credit sales from these links to it. Leave empty to use the connection's.

**Outputs**

- `errors` (list): ASINs or categories Amazon couldn't return, with why; empty when all came back
- `items` (list): The variations
- `variationSummary` (object): All the product's variations together

**Example output**

```json
{
  "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 (`asins`, list, required): 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 (`resources`, list): 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 (`condition`, text): Only offers in this condition. Defaults to any condition. One of: `Any` (Any condition (default)), `New` (New only).
- Language (`language`, text): The language for titles and details. Leave empty for the marketplace's own.
- Currency (`currency`, text): The currency to show prices in. Leave empty for the marketplace's own.
- Tracking ID (`tracking_id`, text): Another of your tracking IDs for this marketplace, to credit sales from these links to it. Leave empty to use the connection's.

**Outputs**

- `errors` (list): ASINs or categories Amazon couldn't return, with why; empty when all came back
- `items` (list): The products

**Example output**

```json
{
  "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 (`filename`, text, required): The report file, from 'List reports'.
- Report type (`report_type`, text): The report's type, as 'List reports' gives it. One of: `CREATOR_CENTRAL` (Creator Central report), `CREATOR_CONNECTIONS` (Creator Connections report).

**Outputs**

- `url` (text): A link to download the report, valid for a short time

**Example output**

```json
{
  "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**

- `feeds` (list): The feed files

**Example output**

```json
{
  "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**

- `reports` (list): The report files

**Example output**

```json
{
  "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 (`keywords`, text): What to search for. Give this, or at least one of Title, Brand, Author, Artist or Actor.
- Department (`search_index`, text): The department to search in. Defaults to all departments.
- Sort by (`sort_by`, text): 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_price`, number): Only products with an offer above this price, in the marketplace's currency, such as 20. At least 0.01.
- Highest price (`max_price`, number): Only products with an offer below this price, in the marketplace's currency, such as 100. At least 0.01.
- Customer rating (`min_reviews_rating`, text): 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_percent`, number): Only products with an offer at least this much off, 1 to 99 percent. From 1 to 99.
- Delivery (`delivery_flags`, list): 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 (`condition`, text): Only offers in this condition. Defaults to any condition. One of: `Any` (Any condition (default)), `New` (New only).
- Availability (`availability`, text): 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_count`, number): How many products to get, 1 to 10. Defaults to 10. From 1 to 10.
- Page (`item_page`, number): Which page of results, 1 to 10, each as long as Results. Defaults to the first. From 1 to 10.
- Details to include (`resources`, list): 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 (`title`, text): Words in the product's title.
- Brand (`brand`, text): All or part of the brand's name, such as Sony.
- Author (`author`, text): All or part of an author's name, for books.
- Artist (`artist`, text): All or part of an artist's name, for music.
- Actor (`actor`, text): All or part of an actor's name, for films and TV.
- Category ID (`browse_node_id`, text): Only products in this category (browse node), such as 283155. Products' categories come with 'Get products'.
- Language (`language`, text): The language for titles and details. Leave empty for the marketplace's own.
- Currency (`currency`, text): The currency to show prices in. Leave empty for the marketplace's own.
- Tracking ID (`tracking_id`, text): Another of your tracking IDs for this marketplace, to credit sales from these links to it. Leave empty to use the connection's.

**Outputs**

- `errors` (list): ASINs or categories Amazon couldn't return, with why; empty when all came back
- `items` (list): The products
- `searchRefinements` (object): Ways to narrow the search (departments, brands, categories), when asked for
- `searchURL` (text): A link to these search results on Amazon, with your tracking ID
- `totalResultCount` (number): How many products on Amazon match the search

**Example output**

```json
{
  "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
}
```
