Amazon Store API Documentation

GET   /api/v1/search?engine=amazon_store

The Amazon Store API returns an Amazon brand store from its page ID: the store details, its pages, the number of products it lists, the ASIN of each of them, and products with prices, ratings, availability and sellers. Use q to search inside the store.

API Parameters

Store

  • Name
    store_id
    Required
    Required
    Description

    Parameter defines the brand store to retrieve. It is the page ID in a store URL (e.g. D24FDA17-DECF-46BB-AF47-AF4647D2B1F8 in amazon.com/stores/page/D24FDA17-DECF-46BB-AF47-AF4647D2B1F8), and the ID of any page of the store works. The Amazon Product API returns it as product.brand_store.id. Store IDs are specific to one amazon_domain.

  • Name
    q
    Required
    Optional
    Description

    Parameter defines the terms to search for inside the store (e.g. power bank). Without it, every product of the store is listed.

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.

Pagination

  • Name
    page
    Required
    Optional
    Description

    The parameter determines the results page number. Each page has up to 25 products. A store lists at most 500 products per search, so the last page is 20; narrow larger stores with q. The asins array of any page holds every listed ASIN.

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_store.

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?engine=amazon_store&store_id=D24FDA17-DECF-46BB-AF47-AF4647D2B1F8
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "amazon_store",
  "store_id": "D24FDA17-DECF-46BB-AF47-AF4647D2B1F8"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_8SfEHO1thMsqAWH9nmvZ1QNZ",
    "status": "Success",
    "created_at": "2026-11-16T19:39:14Z",
    "request_time_taken": 4.64,
    "parsing_time_taken": 0.08,
    "total_time_taken": 4.72,
    "request_url": "https://www.amazon.com/stores/page/D24FDA17-DECF-46BB-AF47-AF4647D2B1F8/search?terms=%2A",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_GOFLl7gQT6Iin0mXoEeIMFSv.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_nE6p2sxzpu6FvV5VKEt3G0ld"
  },
  "search_parameters": {
    "engine": "amazon_store",
    "store_id": "D24FDA17-DECF-46BB-AF47-AF4647D2B1F8",
    "amazon_domain": "amazon.com",
    "delivery_country": "us"
  },
  "search_information": {
    "query_displayed": "*",
    "total_results": 1088
  },
  "store": {
    "store_id": "D24FDA17-DECF-46BB-AF47-AF4647D2B1F8",
    "name": "Anker",
    "description": "ANKER",
    "brand_id": "3271",
    "entity_type": "brand",
    "logo": "https://m.media-amazon.com/images/S/stores-image-uploads-na-prod/9/AmazonStores/ATVPDKIKX0DER/14f85b...",
    "link": "https://www.amazon.com/stores/page/D24FDA17-DECF-46BB-AF47-AF4647D2B1F8"
  },
  "pages": [
    {
      "page_id": "D24FDA17-DECF-46BB-AF47-AF4647D2B1F8",
      "title": "portable charger",
      "link": "https://www.amazon.com/stores/page/D24FDA17-DECF-46BB-AF47-AF4647D2B1F8",
      "level": 1
    },
    "..."
  ],
  "products": [
    {
      "position": 1,
      "asin": "B088NRLMPV",
      "title": "Anker USB C to USB C Cable, 60W Fast Charging Cable (2-Pack, 6 ft, Black) | For iPhone 18 / 17 Series, iPad mini 6, and More",
      "link": "https://www.amazon.com/Anker-Charging-MacBook-Galaxy-Charger/dp/B088NRLMPV",
      "thumbnail": "https://m.media-amazon.com/images/I/71k0d1eTetL.jpg",
      "rating": 4.7,
      "reviews": 91590,
      "recent_sales": "10K+ bought in past month",
      "extracted_recent_sales": 10000,
      "price": "$9.99",
      "extracted_price": 9.99,
      "availability": "In Stock",
      "fulfillment": {
        "ships_from": "Amazon",
        "sold_by": "AnkerDirect",
        "third_party_seller": {
          "id": "A294P4X9EWVXLJ",
          "name": "AnkerDirect"
        }
      }
    },
    "..."
  ],
  "asins": [
    "B088NRLMPV",
    "B01MTB55WH",
    "..."
  ],
  "pagination": {
    "current": 1,
    "next": 2,
    "total_pages": 20
  }
}

Search Inside a Store

Search Inside a Store
GET
https://www.searchapi.io/api/v1/search?engine=amazon_store&q=power+bank&store_id=D24FDA17-DECF-46BB-AF47-AF4647D2B1F8
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "amazon_store",
  "store_id": "D24FDA17-DECF-46BB-AF47-AF4647D2B1F8",
  "q": "power bank"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_ucbFoqtNQXGo5Mq95WxLpD9E",
    "status": "Success",
    "created_at": "2026-11-16T19:39:19Z",
    "request_time_taken": 5.12,
    "parsing_time_taken": 0.19,
    "total_time_taken": 5.31,
    "request_url": "https://www.amazon.com/stores/page/D24FDA17-DECF-46BB-AF47-AF4647D2B1F8/search?terms=power+bank",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_uXy3HPXRET1amxc64Gv0uhJw.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_gS6SPigeaANLRxKwMAsYr3Uh"
  },
  "search_parameters": {
    "engine": "amazon_store",
    "store_id": "D24FDA17-DECF-46BB-AF47-AF4647D2B1F8",
    "q": "power bank",
    "amazon_domain": "amazon.com",
    "delivery_country": "us"
  },
  "search_information": {
    "query_displayed": "power bank",
    "total_results": 317
  },
  "products": [
    {
      "position": 1,
      "asin": "B0DCBB2YTR",
      "title": "Anker Laptop Power Bank, 25,000mAh Travel Essential with 165W Total Output | 3 USB-C Ports with 100W Max Each, Built-In Retractable Cables, Flight-Ready, for iPhone 17 Series ,MacBook, and More",
      "link": "https://www.amazon.com/Anker-Laptop-000mAh-Travel-Essential/dp/B0DCBB2YTR",
      "thumbnail": "https://m.media-amazon.com/images/I/61CF1s8tz1L.jpg",
      "rating": 4.4,
      "reviews": 13369,
      "recent_sales": "10K+ bought in past month",
      "extracted_recent_sales": 10000,
      "price": "$119.99",
      "extracted_price": 119.99,
      "original_price": "$134.99",
      "extracted_original_price": 134.99,
      "original_price_label": "List",
      "discount_percentage": 11,
      "availability": "In Stock",
      "fulfillment": {
        "ships_from": "Amazon",
        "sold_by": "AnkerDirect",
        "third_party_seller": {
          "id": "A294P4X9EWVXLJ",
          "name": "AnkerDirect"
        }
      }
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "next": 2,
    "total_pages": 13
  }
}

Store on Another Amazon Domain

Store on Another Amazon Domain
GET
https://www.searchapi.io/api/v1/search?amazon_domain=amazon.in&engine=amazon_store&store_id=D22AD126-B5A3-4916-B232-F83F4C57B16C
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "amazon_store",
  "store_id": "D22AD126-B5A3-4916-B232-F83F4C57B16C",
  "amazon_domain": "amazon.in"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_04p9lQ5Ui1X4V0eerbBiNwR4",
    "status": "Success",
    "created_at": "2026-11-16T19:40:46Z",
    "request_time_taken": 7.3,
    "parsing_time_taken": 0.18,
    "total_time_taken": 7.48,
    "request_url": "https://www.amazon.in/stores/page/D22AD126-B5A3-4916-B232-F83F4C57B16C/search?terms=%2A",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_KygZGdGFXQhEL1nryYsIN6ft.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_SHEq68rBQg9P8qVbpaBBmJXt"
  },
  "search_parameters": {
    "engine": "amazon_store",
    "store_id": "D22AD126-B5A3-4916-B232-F83F4C57B16C",
    "amazon_domain": "amazon.in",
    "delivery_country": "in"
  },
  "search_information": {
    "query_displayed": "*",
    "total_results": 80
  },
  "store": {
    "store_id": "D22AD126-B5A3-4916-B232-F83F4C57B16C",
    "name": "KONEX",
    "description": "KK KONEX - WE CREATE CHAMPIONS",
    "brand_id": "1163799",
    "entity_type": "brand",
    "logo": "https://m.media-amazon.com/images/S/stores-image-uploads-eu-prod/8/AmazonStores/A21TJRUUN4KGV/1cd814...",
    "link": "https://www.amazon.in/stores/page/D22AD126-B5A3-4916-B232-F83F4C57B16C"
  },
  "products": [
    {
      "position": 1,
      "asin": "B0CTRXF4DS",
      "title": "Konex Badminton Shuttlecock (10 Pcs) | Durable Plastic Build with Lightweight Design | Fast, Stable & Steady Flight | Perfect for Indoor & Outdoor Games - Yellow",
      "link": "https://www.amazon.in/Plastic-Shuttlecock-Stable-Flight-Recovery/dp/B0CTRXF4DS",
      "thumbnail": "https://m.media-amazon.com/images/I/61vg2H+Up4L.jpg",
      "rating": 3.9,
      "reviews": 2078,
      "recent_sales": "1K+ bought in past month",
      "extracted_recent_sales": 1000,
      "price": "₹218.00",
      "extracted_price": 218.0,
      "original_price": "₹230.00",
      "extracted_original_price": 230.0,
      "original_price_label": "M.R.P",
      "discount_percentage": 5,
      "availability": "In stock",
      "fulfillment": {
        "ships_from": "Amazon",
        "sold_by": "RetailEZ Pvt Ltd",
        "third_party_seller": {
          "id": "AXOGFIT0PZZ7G",
          "name": "RetailEZ Pvt Ltd"
        }
      }
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "next": 2,
    "total_pages": 4
  }
}