Product Object

The product object contains all of our price history data and basic product information.

Returned by: the product object is returned by the following requests: Product Searches and Product Request.

Format#

{
    "productType": Integer,
    "asin": String,
    "domainId": Integer,
    "title": String,
    "itemHighlights": String,
    "trackingSince": Integer,
    "listedSince": Integer,
    "lastUpdate": Integer,
    "lastRatingUpdate": Integer,
    "lastPriceChange": Integer,
    "lastEbayUpdate": Integer,
    "lastStockUpdate": Integer,
    "images": Image array,
    "rootCategory": Integer,
    "categories": Long array,
    "categoryTree": Object array,
    "parentAsin": String,
    "parentAsinHistory": String array,
    "parentTitle": String,
    "parentHighlights": String,
    "frequentlyBoughtTogether": String array,
    "bundleItems": String array,
    "eanList": String array,
    "upcList": String array,
    "gtinList": String array,
    "manufacturer": String,
    "brand": String,
    "brandStoreName": String,
    "brandStoreUrl": String,
    "brandStoreUrlName": String,
    "websiteDisplayGroup": String,
    "websiteDisplayGroupName": String,
    "salesRankDisplayGroup": String,
    "type": String,
    "partNumber": String,
    "binding": String,
    "scent": String,
    "shortDescription": String,
    "activeIngredients": String,
    "specialIngredients": String,
    "itemForm": String,
    "itemTypeKeyword": String,
    "recommendedUsesForProduct": String,
    "pattern": String,
    "specificUsesForProduct": String array,
    "businessDiscount": Integer,
    "lastBusinessDiscountUpdate": Integer,
    "safetyWarning": String,
    "productBenefit": String,
    "batteriesRequired": Boolean,
    "batteriesIncluded": Boolean,
    "targetAudienceKeyword": String,
    "style": String,
    "includedComponents": String,
    "material": String,
    "materials": String array,
    "specialFeatures": String array,
    "numberOfItems": Integer,
    "numberOfPages": Integer,
    "publicationDate": Integer,
    "releaseDate": Integer,
    "contributors": two dimensional String array,
    "languages": two dimensional String array,
    "model": String,
    "color": String,
    "size": String,
    "edition": String,
    "format": String,
    "features": String array,
    "description": String,
    "hazardousMaterials": Object array,
    "videos": Object array,
    "aPlus": Object array,
    "deals": Deal Details Object array,
    "packageHeight": Integer,
    "packageLength": Integer,
    "packageWidth": Integer,
    "packageWeight": Integer,
    "packageQuantity": Integer,
    "itemHeight": Integer,
    "itemLength": Integer,
    "itemWidth": Integer,
    "itemWeight": Integer,
    "availabilityAmazon": Integer,
    "availabilityAmazonDelay": Integer array,
    "buyBoxEligibleOfferCounts": Integer array,
    "competitivePriceThreshold": Integer,
    "suggestedLowerPrice": Integer,
    "ebayListingIds": Long array,
    "isAdultProduct": Boolean,
    "isHeatSensitive": Boolean,
    "isMerchOnDemand": Boolean,
    "isHaul": Boolean,
    "launchpad": Boolean,
    "audienceRating": String,
    "ingredients": String,
    "urlSlug": String,
    "returnRate": Integer,
    "isEligibleForSuperSaverShipping": Boolean,
    "fbaFees": Object,
    "variableClosingFee": Integer,
    "referralFeePercentage": Double,
    "variations": Object array,
    "historicalVariations": String array,
    "coupon": Integer array,
    "couponHistory": Integer array,
    "promotions": Promotion Object array,
    "unitCount": Object,
    "stats": Statistics Object,
    "salesRankReference": Long,
    "salesRankReferenceHistory": Long array,
    "salesRanks": Object,
    "lastSoldUpdate": Integer,
    "monthlySold": Integer,
    "monthlySoldHistory": Integer array,
    "reviews": Review Object,
    "offers": Marketplace Offer Object array,
    "liveOffersOrder": Integer array,
    "buyBoxSellerIdHistory": String array,
    "buyBoxUsedHistory": String array,
    "isRedirectASIN": Boolean,
    "isSNS": Boolean,
    "offersSuccessful": Boolean,
    "csv": two dimensional Integer array
}

Fields#

All timestamps are given in Keepa Time minutes (see Keepa Time Minutes below). All price and fee values are integers in the respective Amazon locale’s smallest currency unit (e.g. euro cents or yen). The fields are grouped below for readability; the group order follows the API response.

Identification & product type#

Tracking & update timestamps#

Images & categories#

Example images entry:

"images": [{
    "l": "81bRlmLRyPL.jpg",
    "lH": 1500,
    "lW": 1500,
    "m": "g1dlEmb2mq3.jpg",
    "mH": 500,
    "mW": 500,
    "variant": "MAIN"
}]

Parent ASIN & variations#

Example variations entry:

"variations": [{
   "asin": "B07GFPNJL9",
   "image": "55DVdLc1oBC.jpg",
   "attributes": [{
      "dimension": "Size",
      "value": "7.24 LB"
   }, {
      "dimension": "FlavorName",
      "value": "Cheddar"
   }]
}]

Videos & A+ content#

Example videos entry:

"videos": [{
    "title": "Compressed Air Duster", // string
    "image": "31XBcVI7oTL.jpg", // string
    "duration": 36, // short, in seconds
    "creator": "Seller", // string
    "name": "Innovation", // string, public name of the creator
    "url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prd/d8d8f97e-aa42-42d2-aa4c-6ab1b006edb5/default.jobtemplate.hls.m3u8" // string
}]

Example aPlus entry:

"aPlus": [{
    "module": [{
        "text": [
            "Experience premium quality and design.",
            "Engineered for performance and style."
        ], // array of strings, each representing a block of descriptive text
        "image": [
            "https://m.media-amazon.com/images/S/aplus-media-library-service-media/47ac6642-83d5-4ebf-867b-ae890ef135d4.png"
        ], // array of strings, each representing a full image URL
        "imageAltText": [
            "Healthy delicious recipes"
        ], // array of strings, each the alt text of the image
        "video": [
            "https://m.media-amazon.com/images/S/aplus-media/vc/e07d60fa-d3dd-49fa-90d0-b07e05a3f783.mp4"
        ], // array of strings, each representing a full video URL
        "asin": [
            "B000K11CAA"
        ] // array of strings, each representing a comparison table module's product ASIN
    }],
    "fromManufacturer": true // boolean; indicates whether the A+ content is provided by the manufacturer/vendor
}]

Deal badges (deals)#

The deals field provides metadata for active deals associated with the product’s buy box. undefined if unavailable. Only updated when the offers parameter is used. Each entry is a Deal Details Object with the following fields:

Example:

"deals": [
  {
    "accessType": "PRIME_EXCLUSIVE",
    "badge": "Early Prime Deal",
    "dealType": "EARLY_ACCESS_WITH_PRIME"
  }
]

Related products & identifiers#

Brand & manufacturer#

Classification & display groups#

Product attributes#

Editions, formats & content details#

Example hazardousMaterials entries:

{
  "value": "AEROSOLS",
  "aspect": "proper_shipping_name"
}, {
  "value": "UN1950",
  "aspect": "united_nations_regulatory_id"
}

Package & item dimensions#

Availability & buy box eligibility#

Flags & miscellaneous#

FBA & referral fees#

Example fbaFees object:

"fbaFees": {
   "lastUpdate": keepaTime,
   "pickAndPackFee": 259
}

Coupons, promotions & unit count#

Sales rank, sold & review statistics#

Example salesRanks object:

"salesRanks": {
   "281052": [ keepaTime, salesRank, ... ],
   "123112042": [ keepaTime, salesRank, ... ]
}

Format of the reviews object:

"reviews": {
   "lastUpdate": keepaTime,
   "ratingCount": [ keepaTime, ratingCount, ... ],
   "reviewCount": [ keepaTime, reviewCount, ... ]
}

Offers & buy box#

The csv History Array#

The csv field is a two-dimensional history array containing the product’s historical data. Access the first dimension index using the following enum/constants:

Important csv information#

• We only append a new entry to the history array if the price/value changed, not every time we update the product.
• Shipping and handling costs are not included unless specified.
• For NEW, USED, COLLECTIBLE, and REFURBISHED time series, the pricing definition is as follows: entries dated before Feb 23, 2026, reflect the lowest listing price. Entries dated on or after Feb 23, 2026, reflect the lowest landing price (listing price + shipping).
• Amazon is considered to be part of the marketplace. If Amazon has the overall lowest new price, the marketplace new price in the corresponding time interval is identical to the Amazon price.
• The following types are only set if the offers parameter was used in the Product Request: NEW_FBM_SHIPPING, WAREHOUSE, NEW_FBA, RATING, COUNT_REVIEWS, BUY_BOX_SHIPPING, USED_*_SHIPPING, COLLECTIBLE_*_SHIPPING, REFURBISHED_SHIPPING, BUY_BOX_USED_SHIPPING, and PRIME_EXCL.

Decoding the Price History#

The second dimension of the csv array contains the price/value history in the format Keepa time minutes, value, […] or, if the type includes *_SHIPPING costs, the format: Keepa time minutes, price, shipping costs, […]. If history is unavailable, it is null.

• The price is an integer of the respective Amazon locale’s smallest currency unit (e.g., euro cents or yen).
• If no offer was available in the given interval (e.g., out of stock), the price has the value -1.
• Timestamps are Keepa Time minutes – see the conversion below.

A minimal Python decoder:

KEEPA_TIME_OFFSET = 21564000  # minutes; Keepa Time -> Unix epoch offset

def keepa_time_to_unix_ms(keepa_minutes):
    return (keepa_minutes + KEEPA_TIME_OFFSET) * 60000

def decode_csv(history, with_shipping=False):
    """Decode one csv history array into a list of data points.

    Plain types:      [keepaTime, value, keepaTime, value, ...]
    *_SHIPPING types: [keepaTime, price, shipping, keepaTime, price, shipping, ...]
    A value/price of -1 means no offer was available in that interval.
    """
    if history is None:
        return []  # no history available for this type
    step = 3 if with_shipping else 2
    points = []
    for i in range(0, len(history), step):
        point = {
            "timestamp_ms": keepa_time_to_unix_ms(history[i]),
            "value": history[i + 1],
        }
        if with_shipping:
            point["shipping"] = history[i + 2]
        points.append(point)
    return points

# csv index constants (see table above)
AMAZON, NEW, USED, SALES, BUY_BOX_SHIPPING = 0, 1, 2, 3, 18

product = response["products"][0]
amazon_history = decode_csv(product["csv"][AMAZON])
buy_box_history = decode_csv(product["csv"][BUY_BOX_SHIPPING], with_shipping=True)

Keepa Time Minutes#

Keepa Time minutes is the time format used for all timestamps of the product object. To convert a Keepa Time minutes value to an uncompressed Unix epoch time:

• For milliseconds: (keepaTime + 21564000) * 60000
• For seconds: (keepaTime + 21564000) * 60

from datetime import datetime, timezone

def parse_keepa_time(keepa_minutes):
    """Convert Keepa Time minutes to a timezone-aware datetime (UTC)."""
    return datetime.fromtimestamp((keepa_minutes + 21564000) * 60, tz=timezone.utc)

Example#

Product objects are returned in the products array of a Product Request response. A basic request:

KeepaAPI api = new KeepaAPI("YOUR_API_KEY");
Request r = Request.getProductRequest(AmazonLocale.US, null, null, "B00M0QVG3W");
api.sendRequest(r)
    .done(result -> {
        Product product = result.products[0];
        // newest value of the AMAZON price history
        int price = ProductAnalyzer.getLast(
                product.csv[Product.CsvType.AMAZON.index], Product.CsvType.AMAZON);
        System.out.println(product.title + ": " + price);
    })
    .fail(failure -> System.out.println(failure));

<?php
use Keepa\KeepaAPI;
use Keepa\API\Request;
use Keepa\API\ResponseStatus;
use Keepa\objects\AmazonLocale;

$api = new KeepaAPI("YOUR_API_KEY");
$response = $api->sendRequestWithRetry(Request::getProductRequest(AmazonLocale::US, null, null, null, 1, true, ['B00M0QVG3W']));
if ($response->status == ResponseStatus::OK) {
    $product = $response->products[0];
    $amazonHistory = $product->csv[0]; // AMAZON price history
    echo $product->title . ": " . end($amazonHistory);
}

import requests

params = {"key": "YOUR_API_KEY", "domain": 1, "asin": "B00M0QVG3W"}
r = requests.get("https://api.keepa.com/product", params=params)
product = r.json()["products"][0]

print(product["title"])
amazon = product["csv"][0]  # AMAZON price history: [keepaTime, price, ...]
print("Latest Amazon price (cents):", amazon[-1])  # -1 = out of stock

const res = await fetch("https://api.keepa.com/product?key=YOUR_API_KEY&domain=1&asin=B00M0QVG3W");
const data = await res.json();
const product = data.products[0];

console.log(product.title);
const amazon = product.csv[0]; // AMAZON price history: [keepaTime, price, ...]
console.log("Latest Amazon price (cents):", amazon[amazon.length - 1]);

curl -s "https://api.keepa.com/product?key=YOUR_API_KEY&domain=1&asin=B00M0QVG3W"

Example product object#

{
  "productType": 0,
  "asin": "B00M0QVG3W",
  "domainId": 1,
  "title": "Canon PowerShot SX400 Digital Camera with 30x Optical Zoom (Black)",
  "trackingSince": 2711319,
  "listedSince": 2705011,
  "lastUpdate": 7664520,
  "lastRatingUpdate": 7664201,
  "lastPriceChange": 7664520,
  "lastEbayUpdate": 7660034,
  "images": [
    {
      "l": "81bRlmLRyPL.jpg",
      "lH": 1500,
      "lW": 1500,
      "m": "g1dlEmb2mq3.jpg",
      "mH": 500,
      "mW": 500,
      "variant": "MAIN"
    }
  ],
  "rootCategory": 502394,
  "categories": [281052],
  "categoryTree": [
    { "catId": 502394, "name": "Camera & Photo" },
    { "catId": 281052, "name": "Point-and-Shoot Digital Cameras" }
  ],
  "parentAsin": null,
  "frequentlyBoughtTogether": ["B00T85PMWY"],
  "eanList": ["8714574623290"],
  "upcList": ["013803243871"],
  "manufacturer": "Canon",
  "brand": "Canon",
  "websiteDisplayGroup": "photo_display_on_website",
  "websiteDisplayGroupName": "photo",
  "salesRankDisplayGroup": "photo_display_on_website",
  "type": "CAMERA_DIGITAL",
  "partNumber": "9542B001",
  "binding": "Electronics",
  "model": "SX400",
  "color": "Black",
  "numberOfItems": 1,
  "releaseDate": 20140929,
  "features": [
    "30x Optical Zoom with 24mm Wide-Angle lens",
    "16.0 Megapixel CCD sensor with DIGIC 4+ Image Processor"
  ],
  "packageHeight": 91,
  "packageLength": 175,
  "packageWidth": 137,
  "packageWeight": 540,
  "packageQuantity": 1,
  "itemHeight": 69,
  "itemLength": 104,
  "itemWidth": 80,
  "itemWeight": 313,
  "availabilityAmazon": 0,
  "buyBoxEligibleOfferCounts": [3, 5, 1, 2, 0, 0, 0, 0],
  "competitivePriceThreshold": 18990,
  "ebayListingIds": [273344490183, 0],
  "isAdultProduct": false,
  "isHeatSensitive": false,
  "launchpad": false,
  "isSNS": false,
  "urlSlug": "Canon-PowerShot-SX400-Digital-Optical",
  "isEligibleForSuperSaverShipping": true,
  "fbaFees": {
    "lastUpdate": 7664213,
    "pickAndPackFee": 384
  },
  "referralFeePercentage": 8,
  "coupon": [200, 0],
  "salesRankReference": 281052,
  "salesRanks": {
    "281052": [7650101, 4823, 7660440, 5102, 7664520, 4991]
  },
  "lastSoldUpdate": 7664100,
  "monthlySold": 100,
  "monthlySoldHistory": [7620400, 50, 7650300, 100],
  "csv": [
    [7650101, 19900, 7655230, 18999, 7664520, 19499],
    [7650101, 18990, 7660440, 18500],
    [7650101, 14999, 7663880, 15250],
    [7650101, 4823, 7660440, 5102, 7664520, 4991],
    [7650101, 24999],
    null,
    null,
    [7650101, 18990, 450, 7660440, 18500, 499]
  ]
}

Object shortened for readability; illustrative values only. Real product objects contain many more fields, and the csv array covers the history types listed above (null where no history exists) – here it is truncated after index 7 (NEW_FBM_SHIPPING, which uses the time, price, shipping triplet format). Prices are integers in the locale’s smallest currency unit; timestamps are Keepa Time minutes.