Core APIs
...
Results
Core Requests
Offers
4min
offers results when making a request with the type parameter https //docs trajectdata com/rainforestapi/product data api/parameters/offers set to type=offers rainforest api will return all seller offers for the product specified in either the asin and amazon domain parameters or the url parameter offers are retrieved from the offers listing popup window for a single product on amazon note that the buybox winner offer is always pinned to the top of the offers listing popup window, above the 'other offers' rainforest will append the buybox winner offer to the top of the offers array when page=1 stock estimation to get stock estimation for a specific offer pass that offers offer id into a stock estimation https //docs trajectdata com/rainforestapi/product data api/parameters/stock estimation request an example of the json object returned from an offers request is shown below { "request info" { "success" true, "credits used" 1, "credits remaining" 999 }, "request metadata" { "id" "fae0a664cf810e66247dd3e8dbbf94094fa13c04", "created at" "2020 01 01 09 00 000z", "processed at" "2020 01 01 09 00 001z", "total time taken" 1, "amazon url" "https //amazon com/gp/offer listing/b073jyvknx" }, "request parameters" { "type" "offers", "amazon domain" "amazon com", "asin" "b073jyvknx" }, "product" { "title" "sandisk 64gb ultra microsdxc uhs i memory card with adapter 100mb/s, c10, u1, full hd, a1, micro sd card sdsquar 064g gn6ma", "rating" 4 6, "reviews total" 25319, "image" "https //images na ssl images amazon com/images/i/41pfhjozwql ss160 jpg", "asin" "b073jyvknx" }, "offers" \[ { "price" { "symbol" "$", "value" 11 98, "currency" "usd", "raw" "$11 98" }, "minimum order quantity" { "value" 1 }, "maximum order quantity" { "value" 5 }, "condition" { "is new" true, "title" "new" }, "delivery" { "fulfilled by amazon" true, "shipped from outside country" false, "countdown" "20 hrs and 33 mins", "comments" "back ordered due in stock january 23 order now to reserve yours", "price" { "raw" "$0 00", "symbol" "$", "value" 0, "currency" "usd", "is free" true }, "upsell" { "name" "fastest delivery", "value" "tomorrow" } }, "seller" { "name" "bestcomputers (we record sn)", "link" "https //amazon com/gp/aag/main/ref=olp merch name 1/134 9490218 4502634?ie=utf8\&asin=b073jyvknx\&isamazonfulfilled=1\&seller=a30307mol17z4z", "rating" 4 5, "ratings percentage positive" 91, "ratings total" 394, "id" "a3qhmv5ksm4x3l" }, "is prime" true, "buybox winner" true, "offer id" "12345678abcdef" }, { "price" { "symbol" "$", "value" 11 98, "currency" "usd", "raw" "$11 98" }, "minimum order quantity" { "value" 1 }, "maximum order quantity" { "value" 10 }, "condition" { "is new" true, "title" "new" }, "delivery" { "fulfilled by amazon" true, "shipped from outside country" false, "countdown" "20 hrs and 33 mins", "comments" "back ordered due in stock january 23 order now to reserve yours", "price" { "raw" "$0 00", "symbol" "$", "value" 0, "currency" "usd", "is free" true }, "upsell" { "name" "fastest delivery", "value" "tomorrow" } }, "seller" { "name" "memoski memory", "link" "https //amazon com/gp/aag/main/ref=olp merch name 2/134 9490218 4502634?ie=utf8\&asin=b073jyvknx\&isamazonfulfilled=1\&seller=a206l2nd1mnb5k", "rating" 5, "ratings percentage positive" 98, "ratings total" 1225, "id" "a3qhmv5ksm4x3l" }, "is prime" true, "offer id" "12345678abcdef" }, { "price" { "symbol" "$", "value" 11 99, "currency" "usd", "raw" "$11 99" }, "minimum order quantity" { "value" 1 }, "maximum order quantity" { "value" 4 }, "condition" { "is new" true, "title" "new" }, "delivery" { "fulfilled by amazon" false, "shipped from outside country" false, "countdown" "20 hrs and 33 mins", "price" { "raw" "$0 00", "symbol" "$", "value" 0, "currency" "usd", "is free" true } }, "seller" { "name" "amazon com", "image" "https //images na ssl images amazon com/images/i/01dxm j1oel gif" }, "is prime" true, "offer id" "12345678abcdef" }, { "price" { "symbol" "$", "value" 12 44, "currency" "usd", "raw" "$12 44" }, "minimum order quantity" { "value" 1 }, "maximum order quantity" { "value" 30 }, "condition" { "is new" true, "title" "new" }, "delivery" { "fulfilled by amazon" true, "shipped from outside country" false, "countdown" "20 hrs and 33 mins", "price" { "raw" "$0 00", "symbol" "$", "value" 0, "currency" "usd", "is free" true } }, "seller" { "name" "blueproton", "link" "https //amazon com/gp/aag/main/ref=olp merch name 4/134 9490218 4502634?ie=utf8\&asin=b073jyvknx\&isamazonfulfilled=1\&seller=a2wtvcolvn15gp", "rating" 5, "ratings percentage positive" 96, "ratings total" 305790, "id" "a3qhmv5ksm4x3l" }, "is prime" true, "offer id" "12345678abcdef" } ], "pagination" { "current page" 1, "total pages" 3 }, "available filters" { "offers free shipping" true, "offers prime" false, "offers condition new" true, "offers condition used like new" false, "offers condition used very good" false, "offers condition used good" false, "offers condition used acceptable" false } } rainforest api returns the following properties for offers requests paginating offers results amazon returns 10 offers per page to request more offers issue additional requests incrementing the page parameter https //docs trajectdata com/rainforestapi/product data api/parameters/offers the position property shows the position of the offer within the current page of results for example, the first offer of page=2 would have position=1 property type description offers array an array of offer objects, containing each of the seller offers shown on the offers listing page the offer object has the following properties position number the position of the offer within the current page of offer results is prime boolean determines whether the offer is prime eligible or not offer id string the id of the offer to get stock estimation for a specific offer pass the offer id into a stock estimation https //docs trajectdata com/rainforestapi/product data api/parameters/stock estimation request offer asin string the asin the offer relates to normally the same as the asin supplied in the asin parameter unless the request specifies show different asins=true price only available in cart string true / false depending on whether the price for this offer is only available in the cart if no price is shown then the price may only be visible once the asin is added to the cart you could consider a stock estimation https //docs trajectdata com/rainforestapi/product data api/parameters/stock estimation request to retrieve the price when price only available in cart=true price object the price object contains details about the sellers pricing symbol string the currency symbol, i e $ for usd value number the price of the offer currency string the currency of the offer as a iso 4217 https //en wikipedia org/wiki/iso 4217 currency code minimum order quantity object the minimum order quantity object contains details about the sellers minimum order quantity value number the minimum order quantity of the offer maximum order quantity object the maximum order quantity object contains details about the sellers maximum order quantity value number the maximum order quantity of the offer promotion object the promotion object contains details about any promotion associated with the seller offer raw string the raw text of the promotion import fee object the import fee object contains details about any import fee payable on the offer symbol string the currency symbol, i e $ for usd value number the amount of the import fee currency string the currency of the import fee as a iso 4217 https //en wikipedia org/wiki/iso 4217 currency code raw string the raw price as displayed on the import fee condition object the condition object contains details about the products condition is new boolean used to quickly determine whether the product being offered is new or used title string the main description of the product condition, i e "used very good" comments string any further comments about the product being offered, i e "item will come repackaged " delivery object the deliery object contains details about the products delivery options is free boolean used to quickly determine whether free delivery is offered fulfilled by amazon boolean whether the delivery is via amazon, or a third party seller shipped from outside country boolean whether the product is shipped from outside the home country for the given amazon domain (e g if an item on amazon ca is shipped from the united states) countdown string the countdown as displayed next to the offer, i e "20 hrs and 33 mins" comments string any delivery comments, i e "on back order expected 30th june" raw string the raw price as displayed for the delivery price (if present) price object delivery price object the delivery price object contains details about the delivery pricing for the offer symbol string the currency symbol, i e $ for usd value number the price for delivery currency string the currency as a iso 4217 https //en wikipedia org/wiki/iso 4217 currency code upsell object delivery upsell object the delivery upsell object contains details about the upsell messages (if shown) for the offer name string the name of the upsell message, for example "fastest delivery" value string the value of the upsell message, for example "tomorrow" in the case of a "fastest delivery" upsell message undeliverable boolean present, and set to true , when the offer is not deliverable to the current customer location absent if the product is deliverable undeliverable message string when undeliverable=true , undeliverable message contains the message shown indicating why the offer is undeliverable seller object the seller object contains details about the seller providing the offer name string the name of the seller id string the id of the seller can be specified as a request parameter to a type=seller profile request to view this sellers profile page link string a link to the sellers shopfront on amazon (for third party sellers) rating number the third party sellers rating, out of 5 ratings total number the total number of ratings that the third party seller has received in the last 12 months ratings total percentage number the % of all ratings received by the third party seller in the last 12 months that amazon determines where "positive" product object an object containing details of the product (in so far as those details are shown on the offers listing page) for full product details you should issue a request with type=product to retrieve details from the product page https //docs trajectdata com/rainforestapi/product data api/results/product title string the product name categories array categories array an array containing details of the categories shown with this product as displayed next to the search bar at the top of the page note that amazon products can exist in multiple categories each object in the array contains the following properties name string the name of the category (i e "toys & games") rating number the customer rating of the product, out of 5 reviews total number the total number of customer reviews the product has to retrieve the reviews you should issue a request with type=reviews to retrieve details from the reviews page https //docs trajectdata com/rainforestapi/product data api/results/reviews image string a link to the image of the product asin string the amazon product id (asin) for the product sub title object subtitle object the subtitle object contains details of the information shown in the subtitle directly underneath the product title text string the text of the subtitle typically the brand name of the product i e "samsung" attributes array attributes array the attributes array contains details of the product attributes as shown underneath the product title name string the name of the product attribute i e "capacity" value string the value of the product attribute i e "128 gb" pagination object an object containing details of the current offers page and the total number of offers pages that are available to paginate you should specify the page number in your request's page parameter https //docs trajectdata com/rainforestapi/product data api/parameters/offers current page number the current page number total pages number the total number of pages available available filters object an object containing details of which offer filters are shown by amazon can be used to inform future type=offers requests offers free shipping boolean true/false depending on whether a offers free shipping filter is available offers prime boolean true/false depending on whether a offers prime filter is available offers condition new boolean true/false depending on whether a offers condition new filter is available offers condition used like new boolean true/false depending on whether a offers condition used like new filter is available offers condition used very good boolean true/false depending on whether a offers condition used very good filter is available offers condition used good boolean true/false depending on whether a offers condition used good filter is available offers condition used acceptable boolean true/false depending on whether a offers condition used acceptable filter is available next steps offers parameters https //docs trajectdata com/rainforestapi/product data api/parameters/offers