Logo SearchApi

Amazon Offers API

GET   /api/v1/search?engine=amazon_offers
OpenAPI Initiative Download OpenAPI Spec

Allows you to retrieve all offers for a specific product and filter them by various criteria.

API Parameters

Search Query

  • Name
    asin
    Required
    Required
    Description

    The asin parameter is used to specify the product you want to retrieve offers for. It accepts an Amazon Standard Identification Number (ASIN), a unique identifier for products on Amazon.

Localization

Delivery

  • Name
    postal_code
    Required
    Optional
    Description

    Postal code for the delivery location. Use this for postal-code countries (e.g. 10001 for US, SW1A 0AA for UK, M5V 2T6 for CA). Check the list of supported Amazon postal codes by domain and format. The response reports the outcome in search_metadata.delivery_location: applied, not_applied, or unverified.

  • Name
    delivery_city
    Required
    Optional
    Description

    City for the delivery address in snake_case (e.g. delivery_city=riyadh). Only supported for city-based countries (Saudi Arabia, UAE, Egypt). For other countries use postal_code. See the full list of supported Amazon delivery cities and areas by domain.

  • Name
    delivery_area
    Required
    Optional
    Description

    Area within the city, only available for amazon.ae (e.g. business_bay). Optional and must be sent with delivery_city. See the full list of supported Amazon delivery areas

  • Name
    delivery_country
    Required
    Optional
    Description

    A two-letter ISO 3166-1 alpha-2 country code that defines the country of the delivery address.
    By default, it is set to the country code of the selected Amazon domain (e.g. de for amazon.de), you can also explicitly set it to a different country. Check the full list of supported Amazon delivery countries.

Filters

  • Name
    filters
    Required
    Optional
    Description

    This parameter allows you to filter search results by various criteria. Multiple filters can be applied by separating them with commas (e.g., prime,new,used_very_good). Available filters include:

    Condition filters:
    • new
    • used_like_new
    • used_very_good
    • used_good
    • used_acceptable
    • collectible
    Shipping filters:
    • prime
    • free_shipping

Pagination

  • Name
    page
    Required
    Optional
    Description

    This parameter determines the results page number. It defaults to 1.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to amazon_offers.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?asin=B0D3J98W75&engine=amazon_offers
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "amazon_offers",
  "asin": "B0D3J98W75"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_dbyrKD1vgMQrInk6geJNER4z",
    "status": "Success",
    "created_at": "2025-05-16T11:29:03Z",
    "request_time_taken": 1.73,
    "parsing_time_taken": 0.02,
    "total_time_taken": 1.75,
    "request_url": "https://www.amazon.com/dp/B0D3J98W75?aod=1",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_dbyrKD1vgMQrInk6geJNER4z.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_dbyrKD1vgMQrInk6geJNER4z"
  },
  "search_parameters": {
    "engine": "amazon_offers",
    "asin": "B0D3J98W75",
    "amazon_domain": "amazon.com",
    "delivery_country": "us"
  },
  "product": {
    "asin": "B0D3J98W75",
    "title": "Apple iPad Pro 13-Inch (M4): Built for Apple Intelligence, Ultra Retina XDR Display, 256GB, 12MP Front/Back Camera, LiDAR Scanner, Wi-Fi 6E, Face ID, All-Day Battery Life — Space Black",
    "rating": 4.7,
    "reviews": 1082,
    "main_image": "https://m.media-amazon.com/images/I/41EJMDdgU0L.jpg",
    "link": "https://www.amazon.com/dp/B0D3J98W75"
  },
  "offers": [
    {
      "position": 1,
      "is_buybox_winner": true,
      "price": {
        "raw": "$1,099.00",
        "value": 1099,
        "symbol": "$",
        "currency": "USD"
      },
      "original_price": {
        "raw": "$1,299.00",
        "value": 1299,
        "symbol": "$",
        "currency": "USD"
      },
      "save": {
        "percentage": 15
      },
      "is_prime": true,
      "minimum_order_quantity": 1,
      "maximum_order_quantity": 29,
      "condition": {
        "text": "New",
        "is_new": true
      },
      "fulfillment": {
        "standard_delivery": {
          "text": "FREE delivery Wednesday, May 21",
          "type": "FREE",
          "date": "Wednesday, May 21"
        },
        "fastest_delivery": {
          "text": "Or Prime members get FREE delivery Tomorrow, May 17. Order within 16 hrs 30 mins. Join Prime",
          "type": "FREE",
          "date": "Tomorrow, May 17"
        },
        "ships_from": "Amazon.com",
        "sold_by": "Amazon.com",
        "is_sold_by_amazon": true
      },
      "offer_listing_id": "v7xCCmwhymVWjXINTBYPzHFxUcS%2B9yaPoHY5JzLa8Hk%2B5vM7ybN%2Brl9PC19%2BzeiVkQHSvqes9cXEyb2VtGCEDeo6S402slUHpG7NTFhGQzLZjVGZrS8FDrzD5Dwv22hB5nyj5G8CU8JU1gWkApzGQw%3D%3D"
    },
    ...
  ],
  "pagination": {
    "current": 1,
    "total_pages": 1
  }
}

Offer

Offer
GET
https://www.searchapi.io/api/v1/search?asin=B09FT58QQP&engine=amazon_offers
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "amazon_offers",
  "asin": "B09FT58QQP"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "offers": [
    {
      "position": 1,
      "is_buybox_winner": true,
      "price": {
        "raw": "$12.98",
        "value": 12.98,
        "symbol": "$",
        "currency": "USD"
      },
      "original_price": {
        "raw": "$29.99",
        "value": 29.99,
        "symbol": "$",
        "currency": "USD"
      },
      "save": {
        "percentage": 57
      },
      "is_prime": true,
      "minimum_order_quantity": 1,
      "maximum_order_quantity": 24,
      "condition": {
        "text": "New",
        "is_new": true
      },
      "fulfillment": {
        "standard_delivery": {
          "text": "FREE delivery Wednesday, May 21 on orders shipped by Amazon over $35",
          "type": "FREE",
          "date": "Wednesday, May 21"
        },
        "fastest_delivery": {
          "text": "Or Prime members get FREE Same-Day delivery Today 2 PM - 6 PM. Order within 1 hr 22 mins. Join Prime",
          "type": "FREE",
          "date": "Today 2 PM - 6 PM"
        },
        "third_party_seller": {
          "id": "A3RX0V7R69HJ3V",
          "name": "Desetin",
          "link": "https://www.amazon.com/gp/aag/main?ie=UTF8&seller=A3RX0V7R69HJ3V&isAmazonFulfilled=1&asin=B09FT58QQP&ref_=olp_merch_name_0",
          "rating": 5,
          "reviews": 17418,
          "positive_feedback_percent": 100
        },
        "ships_from": "Amazon.com",
        "sold_by": "Desetin"
      },
      "offer_listing_id": "UszGazu10Jt7qRBNAP3VNmrdRVeiX5ciFA4KbGRayZ5ZUjPGYeGa8JmlmIMfPtr2kQIMZPglE2DeHlBxfYzqw92gK%2F3kl8eZnC8aNXnHzlTifZa3jID%2F5LSUscIrQ2mXF7YO1F1zqsyW7bi8jWsp%2F6txYkkoGqD3neIcG4g6hflHKuYHafSc5T3cy5ENfMMB"
    },
    ...
  ]
}