Offers

offers results when making a request with the type parameter https //docs trajectdata com/asindataapi/product data api/parameters/offers set to type=offers asin data 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' asin data api will append the buybox winner offer to the top of the offers array when page=1 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/b07wjjf8pb" }, "request parameters" { "type" "offers", "amazon domain" "amazon com", "asin" "b07wjjf8pb" }, "product" { "title" "lego duplo classic brick box 10913 first set with storage box, great educational toy for toddlers 18 months and up (65 pieces)", "rating" 5, "reviews total" 6816, "image" "https //images na ssl images amazon com/images/i/51a8tr hnfl jpg", "asin" "b07wjjf8pb", "link" "https //www amazon com/dp/b07wjjf8pb" }, "offers" \[ { "price" { "symbol" "$", "value" 24, "currency" "usd", "raw" "$24 00" }, "minimum order quantity" { "value" 1 }, "maximum order quantity" { "value" 5 }, "condition" { "is new" true, "title" "new" }, "delivery" { "fulfilled by amazon" true, "countdown" "12 hrs 55 mins", "comments" "saturday, may 28", "price" { "symbol" "$", "currency" "usd", "value" 0, "raw" "free", "is free" true } }, "seller" { "name" "amazon com" }, "offer id" "ngwxc9%2fff5hbqitkvn0al7fmddowjlgoyt1z7apntg668y97ma0dzbug2%2b7vxxrqhswui7h7wrxskn8wndg3domj96hfo07mtqimk3xjscjthx3chn6rjss5zq71g2wbyh6hhbwvwoflinms5gou2g%3d%3d", "is prime" true, "position" 1, "buybox winner" true }, { "price" { "symbol" "$", "value" 29 99, "currency" "usd", "raw" "$29 99" }, "minimum order quantity" { "value" 1 }, "maximum order quantity" { "value" 27 }, "condition" { "is new" true, "title" "new" }, "delivery" { "fulfilled by amazon" false, "shipped from outside country" false, "comments" "may 26 31", "price" { "raw" "$5 99", "symbol" "$", "value" 5 99, "currency" "usd", "is free" false } }, "seller" { "name" "fat brain toys", "link" "https //www amazon com/gp/aag/main?ie=utf8\&seller=a154z3bzb2ccws\&isamazonfulfilled=0\&asin=b07wjjf8pb\&ref =olp merch name 1", "rating" 5, "ratings percentage positive" 94, "ratings total" 78401, "id" "a154z3bzb2ccws" }, "offer id" "w44yrkt%2brhz2rgvm6cszofj%2bues9rw2jdheot4bu30sdmitptoerxmgpbkzrb5pyany0t%2fwdys%2foecks%2fbgocgilgds9ts3y%2fkaydsua9avmfeh36vsco%2bjpzmhzow3%2fxam1ojuilmiem9qsz47anz2chy0s3t2tpuud7hz%2bvtlvzl1zlnxzppcw6sxxkasd", "is prime" false, "offer asin" "b07wjjf8pb", "position" 2 }, { "price" { "symbol" "$", "value" 37 99, "currency" "usd", "raw" "$37 99" }, "minimum order quantity" { "value" 1 }, "maximum order quantity" { "value" 5 }, "condition" { "is new" true, "title" "new" }, "delivery" { "fulfilled by amazon" false, "shipped from outside country" false, "comments" "may 26 31", "price" { "symbol" "$", "currency" "usd", "value" 0, "raw" "free", "is free" true } }, "seller" { "name" "spreetail", "link" "https //www amazon com/gp/aag/main?ie=utf8\&seller=a1dxn92kckeqv4\&isamazonfulfilled=0\&asin=b07wjjf8pb\&ref =olp merch name 2", "rating" 4 5, "ratings percentage positive" 90, "ratings total" 355447, "id" "a1dxn92kckeqv4" }, "offer id" "gnhm0et3gbqwzuupkyhnkkmpdjb9sztcr16xq4ij9qsvai85ypurgfpeb3hgo%2fsgts15t9jafjzyzvfduhrfecb%2fskzoedmopxk3ehreri3lht7ranuvclygdpa5xhz4icr7en3tfyo9jeou6sjxh5dztvt47m26ljvfv7m%2bkhp889xn3oq1ryf3alpb4rkf", "is prime" false, "offer asin" "b07wjjf8pb", "position" 3 }, { "price" { "symbol" "$", "value" 29 99, "currency" "usd", "raw" "$29 99" }, "minimum order quantity" { "value" 1 }, "maximum order quantity" { "value" 14 }, "condition" { "is new" true, "title" "new" }, "delivery" { "fulfilled by amazon" false, "shipped from outside country" false, "comments" "may 25 31", "price" { "raw" "$9 62", "symbol" "$", "value" 9 62, "currency" "usd", "is free" false } }, "seller" { "name" "imagine that toys", "link" "https //www amazon com/gp/aag/main?ie=utf8\&seller=a3mo0ongfy5ke2\&isamazonfulfilled=0\&asin=b07wjjf8pb\&ref =olp merch name 3", "rating" 5, "ratings percentage positive" 96, "ratings total" 2236, "id" "a3mo0ongfy5ke2" }, "offer id" "tkwufvdumj3m4mgmsc7ewe5kbioczox33lp9%2fk9ohcropdtdc4ytyr2ack2apdftxnhb8a4q%2f7oeevvo%2bm2qaqgq%2fq8rzokwxj4wljtre%2bxfyhyepnzttgtvlmi%2f5kts0wscaiqfhplgbwujslvfm6%2fjeyhtprqp5gaj1eterpvxec7wy%2f7rwa%3d%3d", "is prime" false, "offer asin" "b07wjjf8pb", "position" 4 }, { "price" { "symbol" "$", "value" 39 89, "currency" "usd", "raw" "$39 89" }, "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" "12 hrs 55 mins", "comments" "saturday, may 28", "price" { "symbol" "$", "currency" "usd", "value" 0, "raw" "free", "is free" true } }, "seller" { "name" "the toymix", "link" "https //www amazon com/gp/aag/main?ie=utf8\&seller=a2aqnwfgvkezmx\&isamazonfulfilled=1\&asin=b07wjjf8pb\&ref =olp merch name 4", "rating" 5, "ratings percentage positive" 99, "ratings total" 5016, "id" "a2aqnwfgvkezmx" }, "offer id" "wn6ogrn6sboeswhog6rcikroy0ohcolkmwhf8vkyyshfujobkfivcgecxcqqo4qw0meuioyg3zmnqvca9pijohnlr85x6j%2b6mov2tiodcrpw4v%2fim7kvo9upsrfnh6khqe3tu92zg4mtegofiunorypqmryb%2bwga2l1s6xor%2bpkxt6ihy6symy69a0hbptr8", "is prime" true, "offer asin" "b07wjjf8pb", "position" 5 }, { "price" { "symbol" "$", "value" 39 97, "currency" "usd", "raw" "$39 97" }, "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" "12 hrs 55 mins", "comments" "saturday, may 28", "price" { "symbol" "$", "currency" "usd", "value" 0, "raw" "free", "is free" true } }, "seller" { "name" "jbs industries, llc", "link" "https //www amazon com/gp/aag/main?ie=utf8\&seller=a203kmjx6aks78\&isamazonfulfilled=1\&asin=b07wjjf8pb\&ref =olp merch name 5", "rating" 4 5, "ratings percentage positive" 95, "ratings total" 421, "id" "a203kmjx6aks78" }, "offer id" "bqys7ihfzfmv2q3%2fzxovk0jwasdyyxmvzt3rubom3t4colkczwqpvjl%2b4diud37oxcjilmbqb2xqdzvba7xckpvjgr3vnyue6myt8qjn9506gdxz4i943fzkgi%2b%2bwfy94cw8ki9gjzx5rk2al%2bnguoun7gns3ayjs9jzzy2s1v%2fepgjfxpco429qnjdln5a3", "is prime" true, "offer asin" "b07wjjf8pb", "position" 6 }, { "price" { "symbol" "$", "value" 42 29, "currency" "usd", "raw" "$42 29" }, "minimum order quantity" { "value" 1 }, "maximum order quantity" { "value" 5 }, "condition" { "is new" true, "title" "new" }, "delivery" { "fulfilled by amazon" false, "shipped from outside country" false, "comments" "june 2 10", "price" { "symbol" "$", "currency" "usd", "value" 0, "raw" "free", "is free" true } }, "seller" { "name" "treasure island sales", "link" "https //www amazon com/gp/aag/main?ie=utf8\&seller=a3sfpil4ka3kl\&isamazonfulfilled=0\&asin=b07wjjf8pb\&ref =olp merch name 6", "rating" 4 5, "ratings percentage positive" 87, "ratings total" 15, "id" "a3sfpil4ka3kl" }, "offer id" "ipecmdwtg%2fu6xujhgvsxy4rxx7sjquotaz7las6vjwz9%2bvh8emwfw953w1greqedgznyoqkp9ltdzpnv0entri6vtihuxkkxyzttnjz%2b%2ft4rxsdlumevu45mtfsoasxutoy2nb1l3ukratoxnynloimepq7okzs%2f%2f17dmwvtpwbun9lqnz258hdibsbvddev", "is prime" false, "offer asin" "b07wjjf8pb", "position" 7 }, { "price" { "symbol" "$", "value" 43 93, "currency" "usd", "raw" "$43 93" }, "minimum order quantity" { "value" 1 }, "maximum order quantity" { "value" 5 }, "condition" { "is new" true, "title" "new" }, "delivery" { "fulfilled by amazon" false, "shipped from outside country" false, "comments" "may 25 27", "price" { "symbol" "$", "currency" "usd", "value" 0, "raw" "free", "is free" true } }, "seller" { "name" "hobbytown", "link" "https //www amazon com/gp/aag/main?ie=utf8\&seller=a2o50o9wc1kti1\&isamazonfulfilled=0\&asin=b07wjjf8pb\&ref =olp merch name 7", "rating" 4 5, "ratings percentage positive" 89, "ratings total" 12988, "id" "a2o50o9wc1kti1" }, "offer id" "tkwufvdumj3m4mgmsc7ewe5kbioczox3zrcifduqev9p4xrkjnagfqugwju4lv%2fuf6wumka86%2fra%2btg1xkmn9n0my6mevxqdmqsmtjvursjjgmtzsyapa49bayfy7fve84bq3ngzq35pghuyuyrbtpenxmu0otvkjz2h0sl0indjoq2mtaxnhq%3d%3d", "is prime" false, "offer asin" "b07wjjf8pb", "position" 8 }, { "price" { "symbol" "$", "value" 36 95, "currency" "usd", "raw" "$36 95" }, "minimum order quantity" { "value" 1 }, "maximum order quantity" { "value" 5 }, "condition" { "is new" true, "title" "new" }, "delivery" { "fulfilled by amazon" false, "shipped from outside country" false, "comments" "may 26 june 1", "price" { "raw" "$10", "symbol" "$", "value" 10, "currency" "usd", "is free" false } }, "seller" { "name" "kaplan early learning company", "link" "https //www amazon com/gp/aag/main?ie=utf8\&seller=a27ok403wrhsgi\&isamazonfulfilled=0\&asin=b07wjjf8pb\&ref =olp merch name 8", "rating" 4 5, "ratings percentage positive" 93, "ratings total" 43368, "id" "a27ok403wrhsgi" }, "offer id" "ipecmdwtg%2fu6xujhgvsxy4rxx7sjquotejz3nzdya0bsofdnk2n2sysnlhs%2fzqfmcwlltay%2f633lrqbwurdeewkf0ckrx2wkkke20yjgddqotgbcbrbhjtnodif%2fzbvnqegzhbenipspgyqfpt4orlsp82gvd%2b1i7vswhzjgo9zrwgj9q8ojcirnz0pu0hin", "is prime" false, "offer asin" "b07wjjf8pb", "position" 9 }, { "price" { "symbol" "$", "value" 34 99, "currency" "usd", "raw" "$34 99" }, "minimum order quantity" { "value" 1 }, "maximum order quantity" { "value" 11 }, "promotion" { "raw" " " }, "condition" { "is new" true, "title" "new" }, "delivery" { "fulfilled by amazon" false, "shipped from outside country" false, "price" { "raw" "$0 00", "symbol" "$", "value" 0, "currency" "usd", "is free" true } }, "seller" { "name" "wild kingdom of toys", "link" "https //www amazon com/gp/aag/main?ie=utf8\&seller=a31q3r4veajypz\&isamazonfulfilled=0\&asin=b07wjjf8pb\&ref =olp merch name 9", "rating" 5, "ratings percentage positive" 96, "ratings total" 9464, "id" "a31q3r4veajypz" }, "offer id" "1du4fpvuggfa3wpak%2f5uufcnjwase06t9tiaf%2f9w6miwyzfnje4ertni%2fi7fwajg502jlffksr3w%2fcggyxmnssorzrpkclv9nkjwtvqi20sww2nxm4hkdsensxd0ge%2bppo%2bqrgxa6hgjckmsbbf1yrp58jx%2fp7kxxm6fca1l8mz6njq5fnns2g%3d%3d", "is prime" false, "offer asin" "b07wjjf8pb", "position" 10 }, { "price" { "symbol" "$", "value" 35 73, "currency" "usd", "raw" "$35 73" }, "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, "comments" "june 2 14", "price" { "raw" "$12 50", "symbol" "$", "value" 12 5, "currency" "usd", "is free" false } }, "seller" { "name" "castello toys store", "link" "https //www amazon com/gp/aag/main?ie=utf8\&seller=a2lfp05c9a92mm\&isamazonfulfilled=0\&asin=b07wjjf8pb\&ref =olp merch name 10", "rating" 5, "ratings percentage positive" 94, "ratings total" 419, "id" "a2lfp05c9a92mm" }, "offer id" "1du4fpvuggfa3wpak%2f5uufcnjwase06tzgt9kpezgvfykcolb5bstdh4vif2jxbk0u8f4dcldqptmmm2bc6fuzpopt99xzwbpdlxl3hmtznbwo5hpc9dh9qyn6mbcccnrht71xp4tbnf%2fw6gshai8xefdusf9a0rb6zeaapx68ajzk2fsp2mkxvbcrnq%2bdo7", "is prime" false, "offer asin" "b07wjjf8pb", "position" 11 } ], "pagination" { "offers count" 32, "total results" 32, "total pages" 4, "current page" 1 }, "available filters" { "offers free shipping" true, "offers prime" true, "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 } } asin data 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/asindataapi/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 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 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/asindataapi/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/asindataapi/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/asindataapi/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/asindataapi/product data api/parameters/offers