--- title: Offers slug: asindataapi/product-data-api/parameters/offers docTags: createdAt: 2024-08-01T10:34:46.728Z --- # Offers Parameters `GET` `/request` The Offers Parameters are applicable when making a request with `type=offers` to retrieve seller Offers for a single product on Amazon - the product is specified using either the `asin` and `amazon_domain` parameters or the `url` parameter (where the `url` parameter contains a link to an Amazon product offers page). The parameters should be appended as querystring parameters to the Product Data API `GET` HTTP request. Offers are retrieved from the offers listing popup window for a single product on Amazon. ![](https://apiimages.imgix.net/asindataapi/images/png/docs/offers.png?auto=format\&ixlib=react-9.5.1-beta.1\&w=600 "Offers Listing Page") For example, to request Prime-eligable Offers, for products in a New Condition, for the ASIN `B07WJJF8PB` on `amazon.com` the request would be: :::CodeblockTabs HTTP ```HTTP https://api.asindataapi.com/request?api_key=demo&type=offers&amazon_domain=amazon.com&asin=B07WJJF8PB&offers_prime=true&offers_condition_new=true ``` ```curl curl -L --get https://api.asindataapi.com/request \ -d api_key="demo" \ -d type="offers" \ -d amazon_domain="amazon.com" \ -d asin="B07WJJF8PB" \ -d offers_prime="true" \ -d offers_condition_new="true" ``` ```nodejs const axios = require('axios'); // set up the request parameters const params = { api_key: "demo", type: "offers", amazon_domain: "amazon.com", asin: "B07WJJF8PB", offers_prime: "true", offers_condition_new: "true" } // make the http GET request to ASIN Data API axios.get('https://api.asindataapi.com/request', { params }) .then(response => { // print the JSON response from ASIN Data API console.log(JSON.stringify(response.data, 0, 2)); }).catch(error => { // catch and print the error console.log(error); }) ``` ```python import requests import json # set up the request parameters params = { 'api_key': 'demo', 'type': 'offers', 'amazon_domain': 'amazon.com', 'asin': 'B07WJJF8PB', 'offers_prime': 'true', 'offers_condition_new': 'true' } # make the http GET request to ASIN Data API api_result = requests.get('https://api.asindataapi.com/request', params) # print the JSON response from ASIN Data API print(json.dumps(api_result.json())) ``` ```php 'demo', 'type' => 'offers', 'amazon_domain' => 'amazon.com', 'asin' => 'B07WJJF8PB', 'offers_prime' => 'true', 'offers_condition_new' => 'true' ]); # make the http GET request to ASIN Data API $ch = curl_init(sprintf('%s?%s', 'https://api.asindataapi.com/request', $queryString)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true); # the following options are required if you're using an outdated OpenSSL version # more details: https://www.openssl.org/blog/blog/2021/09/13/LetsEncryptRootCertExpire/ curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch, CURLOPT_TIMEOUT, 180); $api_result = curl_exec($ch); curl_close($ch); # print the JSON response from ASIN Data API echo $api_result; ?> ``` ::: *** ### Offers Parameters The following parameters are available for all requests made when `type=offers` . | *`Parameter`* | *`Required`* | *`Description`* | | ------------------------------------ | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | *`amazon_domain`* | *`optional`* | The Amazon domain to retrieve Offers for the product specified in the `asin` parameter from. For a full list of supported Amazon domains see [Supported Amazon Domains ](https://docs.trajectdata.com/asindataapi/product-data-api/reference/amazon-domains).
**Note** : If the `amazon_domain` and `asin` parameters are supplied then the `url` parameter is ignored. | | *`asin`* | *`optional`* | The Amazon ASIN (product ID) to retrieve Offers for. Used in combination with the `amazon_domain` parameter.
**Note** : If the `asin` and `amazon_domain` parameters are supplied then the `url` parameter is ignored. | | *`url`* | *`optional`* | The Amazon product-page URL to retrieve Offers from.
**Note** : If the `url` parameter is supplied then the `amazon_domain` and `asin` parameters are ignored. | | *`offers_prime`* | *`optional`* | Limit the offers returned to just those that are Prime-eligible. Valid values are:
1. `true`
2. Only include offers that are Prime-eligible.

1. `false`
2. Include all offers, regardless of whether they are Prime-eligible or not.
:inlineImage[]{src="https://apiimages.imgix.net/asindataapi/images/png/docs/offers_prime.png?auto=format&ixlib=react-9.5.1-beta.1&w=150&dpr=1&q=75" alt caption width="150" height="52"} | | *`offers_free_shipping`* | *`optional`* | Limit the offers returned to just those that have Free Shipping. Valid values are:
1. `true`
2. Only include offers that have Free Shipping.

1. `false`
2. Include all offers, regardless of whether they have Free Shipping or not.
:inlineImage[]{src="https://apiimages.imgix.net/asindataapi/images/png/docs/offers_free_shipping.png?auto=format&ixlib=react-9.5.1-beta.1&w=150&dpr=1&q=75" alt caption width="150" height="52"} | | *`offers_condition_new`* | *`optional`* | Limit the offers returned to just those that are of New Condition. Valid values are:
1. `true`
2. Only include offers that are New Condition.

1. `false`
2. Include all offers, regardless of their Condition.
:inlineImage[]{src="https://apiimages.imgix.net/asindataapi/images/png/docs/offers_condition_new.png?auto=format&ixlib=react-9.5.1-beta.1&w=150&dpr=1&q=75" alt caption width="150" height="152"} | | *`offers_condition_used_like_new`* | *`optional`* | Limit the offers returned to just those that are of Used-Like-New Condition. Valid values are:
1. `true`
2. Only include offers that are Used-Like-New Condition.

1. `false`
2. Include all offers, regardless of their Condition.
:inlineImage[]{src="https://apiimages.imgix.net/asindataapi/images/png/docs/offers_condition_used_like_new.png?auto=format&ixlib=react-9.5.1-beta.1&w=150&dpr=1&q=75" alt caption width="150" height="138"} | | *`offers_condition_used_very_good`* | *`optional`* | Limit the offers returned to just those that are of Used-Very-Good Condition. Valid values are:
1. `true`
2. Only include offers that are Used-Very-Good Condition.

1. `false`
2. Include all offers, regardless of their Condition.
:inlineImage[]{src="https://apiimages.imgix.net/asindataapi/images/png/docs/offers_condition_used_very_good.png?auto=format&ixlib=react-9.5.1-beta.1&w=150&dpr=1&q=75" alt caption width="150" height="129"} | | *`offers_condition_used_good`* | *`optional`* | Limit the offers returned to just those that are of Used-Good Condition. Valid values are:
1. `true`
2. Only include offers that are Used-Good Condition.

1. `false`
2. Include all offers, regardless of their Condition.
:inlineImage[]{src="https://apiimages.imgix.net/asindataapi/images/png/docs/offers_condition_used_good.png?auto=format&ixlib=react-9.5.1-beta.1&w=150&dpr=1&q=75" alt caption width="150" height="133"} | | *`offers_condition_used_acceptable`* | *`optional`* | Limit the offers returned to just those that are of Used-Acceptable Condition. Valid values are:
1. `true`
2. Only include offers that are Used-Acceptable Condition.

1. `false`
2. Include all offers, regardless of their Condition.
:inlineImage[]{src="https://apiimages.imgix.net/asindataapi/images/png/docs/offers_condition_used_acceptable.png?auto=format&ixlib=react-9.5.1-beta.1&w=150&dpr=1&q=75" alt caption width="150" height="127"} | | *`show_different_asins`* | *`optional`* | Sometimes Amazon will return Offers from ASINs other than the ASIN supplied in the `asin` request parameter (for example, when the original ASIN is out of stock). `show_different_asins` controls whether you want these other-ASIN offer results returned, or not. Can be set to `true` to include offers from other ASINs, or `false` (the default) to hide offers from ASINs other than the ASIN supplied in the `asin` parameter. Note that if you supply a `url` instead of `asin` in your request this parameter is ignored. | | *`page`* | *`optional`* | The current page of Offers to retrieve. Inspect the `pagination.total_pages` property in the [Offers results ](https://docs.trajectdata.com/asindataapi/product-data-api/results/offers)to see how many pages of offers are available. | | *`max_page`* | *`optional`* | Use the `max_page` parameter to get multiple pages of results in one request. The API will automatically paginate through pages and concatenate the results into one response.
See the [Pagination ](https://docs.trajectdata.com/asindataapi/product-data-api/pagination)docs for more information. | *** **Next Steps**      [Offers Results](https://docs.trajectdata.com/asindataapi/product-data-api/results/offers)