Amazon Pricing

The ScrapeIN Amazon API response provides information about product pricing on Amazon.

When making a request with the /pricing endpoint ScrapeIN returns results from the Amazon domain specified in either the asin and amazon_domain parameters or the url parameter.

A screenshot of the ScrapeIN Amazon API response displaying product pricing information. The response includes details such as the product name, price, and availability on Amazon. The information is neatly organized in a table format, making it easy to read and understand.

Amazon Pricing API returns results from the offers listing popup window for a single product on Amazon with the following properties:

JSON Example

{
  "product": {
    "title": "LG OLED C1 Series 77\"  Alexa Built-in 4k Smart TV, 120Hz Refresh Rate, AI-Powered, Dolby Vision IQ and Dolby Atmos, WiSA Ready, Gaming Mode (OLED77C1PUB, 2021)",
    "rating": 4.5,
    "reviews_total": 6982,
    "image": "https://m.media-amazon.com/images/I/51mfefisnwS.jpg",
    "asin": "B08WGFKSMW",
    "link": "https://www.amazon.com/dp/B08WGFKSMW"
  },
  "offers": [
    {
      "price": {
        "symbol": "$",
        "value": 2951.06,
        "currency": "USD",
        "raw": "$2,951.06"
      },
      "minimum_order_quantity": {
        "value": 1
      },
      "maximum_order_quantity": {
        "value": 3
      },
      "condition": {
        "is_new": true,
        "title": "New"
      },
      "delivery": {
        "fulfilled_by_amazon": false,
        "comments": "July 7 - 11",
        "price": {
          "symbol": "$",
          "currency": "USD",
          "value": 0,
          "raw": "FREE",
          "is_free": true
        }
      },
      "seller": {
        "name": "westlake",
        "link": "https://www.amazon.com/gp/aag/main?ie=UTF8&seller=A21BBMEF3BMW1Z&isAmazonFulfilled=0&asin=B08WGFKSMW&ref_=olp_merch_name_0",
        "id": "A21BBMEF3BMW1Z",
        "rating": 5,
        "ratings_percentage_positive": 97,
        "ratings_total": 24707
      },
      "offer_id": "fx6xPK91li%2B9gbawzXzJv3UIjmfgzILLGKVDca31TF2MW%2F4ggIJwQNZbQWBAbkjKqmDEu7mzW6vO0emQ%2FmBEDHZTywg5eVHJotBPCV3vXOSXHCCc8P5vhGp%2BZy63xTmO9Is4thkkaub%2BonedebDia00s1eREU%2FleoK7Kf5gTp%2Bjc%2BD0mdHKuVd%2BrVEtEhvgq",
      "is_prime": false,
      "position": 1,
      "buybox_winner": true,
      "offer_asin": "B08WGFKSMW"
    },
    {
      "price": {
        "symbol": "$",
        "value": 2299.99,
        "currency": "USD",
        "raw": "$2,299.99"
      },
      "minimum_order_quantity": {
        "value": 1
      },
      "maximum_order_quantity": {
        "value": 1
      },
      "condition": {
        "is_new": false,
        "title": "Used - Like New",
        "comments": "These are units that are certified refurbished. They come in the retail boxes with all accessories and come with a 90-day warranty. In some cases, the box might have some signs of wear and be for a similar model but not exactly matching the contents which is the TV listed here for sale. This TV will come with all the correct accessories and remote for the TV in this listing and should be in \"A\" condition."
      },
      "delivery": {
        "fulfilled_by_amazon": true,
        "shipped_from_outside_country": false,
        "price": {
          "symbol": "$",
          "currency": "USD",
          "value": 0,
          "raw": "FREE delivery",
          "is_free": true
        }
      },
      "seller": {
        "name": "G-Overstock",
        "link": "https://www.amazon.com/gp/aag/main?ie=UTF8&seller=AD0BANCB0IN2U&isAmazonFulfilled=1&asin=B08WGFKSMW&ref_=olp_merch_name_1",
        "rating": 4.5,
        "ratings_percentage_positive": 85,
        "ratings_total": 861,
        "id": "AD0BANCB0IN2U"
      },
      "offer_id": "fx6xPK91li%2B9gbawzXzJv3UIjmfgzILL9TaXrBk%2BgTqIE7DydwfukAHabD5BMJzSCfpbzev%2BojUBsq0jAJ6rxFuQdCXl0M04uMAZX36oBqw8A31%2B1qVXbmFjucZlLUOwAso7NpAKAwx5qgeZg9q9f0EBQW07a7oFPzFo4sssHwI5c2ikSLTWzCo5TX%2FiIUO5",
      "is_prime": true,
      "offer_asin": "B08WGFKSMW",
      "position": 2
    },
    {
      "price": {
        "symbol": "$",
        "value": 2494.03,
        "currency": "USD",
        "raw": "$2,494.03"
      },
      "minimum_order_quantity": {
        "value": 1
      },
      "maximum_order_quantity": {
        "value": 1
      },
      "condition": {
        "is_new": false,
        "title": "Used - Very Good",
        "comments": "No item damage observed during inspection. Item may not come in original packaging."
      },
      "delivery": {
        "fulfilled_by_amazon": true,
        "shipped_from_outside_country": false,
        "price": {
          "symbol": "$",
          "currency": "USD",
          "value": 0,
          "raw": "FREE delivery",
          "is_free": true
        }
      },
      "seller": {
        "name": "Amazon Warehouse",
        "link": "https://www.amazon.com/Warehouse-Deals/b?ie=UTF8&node=10158976011"
      },
      "offer_id": "fx6xPK91li%2B9gbawzXzJv3UIjmfgzILLhmHi2dj3PTCbiSYrmtm6uC8fmWIWdre%2BSlu3DyPWicrfjHaBnmjgq1QcISTgvyC%2FY5HURv9vDbLPGp8HkcaSFn%2BQPKbnYMul3QYW5fTPYMwfGGzhUujaYRD8y0E0ZRruKc1Io2T3pfstmuOIQusN8mv5%2F7xSKcXK",
      "is_prime": true,
      "position": 3
    },
  ],
  "pagination": {
    "offers_count": 4,
    "total_results": 4,
    "total_pages": 1,
    "current_page": 1
  },
  "available_filters": {
    "offers_free_shipping": true,
    "offers_prime": true,
    "offers_condition_new": true,
    "offers_condition_used_like_new": true,
    "offers_condition_used_very_good": true,
    "offers_condition_used_good": true,
    "offers_condition_used_acceptable": true
  }
}

JSON Structure

The JSON structure returned by the Amazon API includes required elements, such as request_parameters, request_metadata, pagination, as described in the Results Amazon Data API section, as well as those specific to Amazon offers, which are described below.

product

An object contains details of the product shown on the Offers listing page. To retrieve full product details, you should utilize the /product endpoint to retrieve information from the product page.

  • title: The product name.

  • categories: An array contains details of the categories associated with the product, displayed next to the search bar on the page. Each object in the array has the following properties:

    • name: The name of the category (i.e. "Health & Household").
  • sub_title: An object contains details of the information shown in the subtitle directly underneath the product title.

    • text: The text of the subtitle - typically the brand name of the product.
  • attributes: The attributes array contains details of the product attributes as shown underneath the product title.

    • name: The name of the product attribute (i.e., "Capacity").

    • value: The value of the product attribute (i.e., "128 GB").

  • rating: The customer rating of the product, out of 5.

  • reviews_total: The total number of reviews for the product, represented as a numeric value.

  • image: A link to the image of the product.

  • asin: The Amazon product ID (ASIN) for the product.

  • link : Provides the URL that links directly to the product's page on Amazon's website.

offers

An array of offer objects contains a list of offers available for the product. Each offer is represented as a separate object within the list with the following properties:

  • price: An object contains details about the price of the offer.
    • symbol: Represents the currency symbol, for example, $ for USD.
    • value: Specifies the price of the offer.
    • currency: The currency indicates the specific currency unit used. Here, it is "USD" which stands for US dollars.
    • raw: Displays the raw price of the offer.
  • is_prime: A boolean value indicates whether the offer is eligible for Amazon Prime benefits.
  • position: A number specifies the position of the offer in the list of available offers. It represents the rank or order of the offer.
  • promotion: An object provides information about any promotion associated with the seller's offer. It includes the following property:
    • raw: The exact text of the promotion.
  • import fee: An object contains details about any import fee applicable to the offer. It includes the following properties:
    • symbol: The currency symbol, such as $ for USD.
    • value: The amount of the import fee.
    • currency: The currency of the import fee, represented by an ISO 4217 currency code.
    • raw: The original price displayed for the import fee.
  • offer_asin: A string that indicates the ASIN associated with the offer. Typically, it will be the same as the ASIN provided in the asin parameter of the request. However, if the request specifies show_different_asins=true, the offer_asin might differ.
  • price_only_available_in_cart: Indicates whether the price for this offer is exclusively shown in the cart. It is represented by true or false. If no price is displayed, it means that the price becomes visible only when the ASIN is added to the cart.
  • minimum_order_quantity: An object provides information about the seller's minimum order quantity requirement. It includes the following property:
    • value: Specifies the minimum quantity of the offer that needs to be ordered by the buyer.
  • maximum_order_quantity: An object provides information about the seller's maximum order quantity requirement. It includes the following property:
    • value: Specifies the maximum quantity of the offer that needs to be ordered by the buyer.
  • condition: An object provides details about the product's condition. It includes the following properties:
    • is_new: A boolean value indicates whether the product is new or used.
    • title: The primary description of the product's condition, such as "New".
    • comments: Additional comments about the product's condition, such as "Item will come repackaged."
  • delivery: An object contains details about the product's delivery options.
    • fulfilled_by_amazon: A boolean value specifies if the delivery is handled by Amazon or a third-party seller.
    • is_fee: Helps to determine whether free delivery is offered.
    • shipped_from_outside_country: Indicates whether the product is shipped from outside the home country for the specific Amazon domain.
    • countdown: Displays the remaining time for the offer, such as "20 hrs and 33 mins".
    • comments: Provides any additional comments related to delivery, such as "July 3 - 6".
    • raw: Displays the original price for the delivery (if available).
    • upsell: Contains details about any upsell messages related to the offer (if applicable).
      • name: Specifies the name of the upsell message, such as "Fastest delivery".
      • value: Provides the value of the upsell message, for example, "Tomorrow" in the case of a "Fastest delivery" upsell message.
    • undeliverable: Indicates if the offer is not deliverable to the current customer location.
    • undeliverable_message: Provides a message explaining why the offer is undeliverable when undeliverable=true.
    • price: An object contains details about the delivery pricing for the offer.
      • symbol: Represents the currency symbol, for example, $ for USD.
      • value: Specifies the price for delivery.
      • currency: The currency indicates the specific currency unit used. Here, it is "USD" which stands for US dollars.
      • is_free: A boolean value indicates whether free delivery is offered.
      • raw: Displays the original price for the delivery (if available).
  • seller: An object contains details about the seller offering the product.
    • name: Specifies the name of the seller ("Westlake").
    • id: Represents the seller's ID, which can be used as a request parameter to view the seller's profile page using the /seller_profile endpoint ("A21BBMEF3BMW1Z").
    • link: Provides a link to the seller's shopfront on Amazon (applicable for third-party sellers).
    • rating: Represents the rating of the third-party seller, on a scale of 1 to 5.
    • ratings_percentage_positive: Represents the percentage of positive ratings received by the third-party seller in the last 12 months, as determined by Amazon.
    • ratings_total: Specifies the total number of ratings received by the third-party seller in the last 12 months.
  • offer_id: Represents the unique identifier for the offer. It is typically encoded and may contain special characters. For example, the Offer ID is "iAx%2FLqjoB%2B8jdtFYwEpZOartlF2q0V6OMXq7JFohFQHQ9N7jAmq7ou9er0W6%2FCz%2BeBAPoH2lS17BzzUzn8SRx7vxt9fkFYgOJB1KhiTiiZKAz4r%2B0KjslHVKdR43pwjTtXtSX4LyhY8VZX5d%2BmCnC3XQnuz3F1jHI2Gqdb1hBciS3D6XF7NUwYg2LSQ4inIE".
  • buybox_winner: Indicates if the offer is the winner of the Buy Box.

📘

Note on Buybox-Winner Offer

The buybox-winner offer is always displayed at the top of the offers listing popup window, above the "other offers". When the page parameter is set to 1, the API will add the buybox winner offer to the beginning of the offers array.

pagination

An object provides information about the pagination of the offers. The parameters in the JSON response are as follows:

  • offers_count: Indicates the number of offers available for the search query.
  • total_results: Represents the total number of results found for the search query.
  • total_pages: Specifies the total number of pages required to display all the results.
  • current_page: Indicates the current page number that is displayed in the pagination.

To paginate specify the page number in your request parameter.

available_filters

An object containing details about the filters displayed by Amazon. This can be useful for future requests when you want to specify the type of offers you are interested in. The available filters include:

  • offers_free_shipping: Indicates whether the offers include free shipping.

  • offers_prime: Indicates whether the offers are available to Amazon Prime members.

  • offers_condition_new: Indicates whether new condition offers are available.

  • offers_condition_used_like_new: Indicates whether used-like-new condition offers are available.

  • offers_condition_used_very_good: Indicates whether used-very-good condition offers are available.

  • offers_condition_used_good: Indicates whether used-good condition offers are available.

  • offers_condition_used_acceptable: Indicates whether used-acceptable condition offers are available.