Amazon Store API Documentation
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-AF4647D2B1F8inamazon.com/stores/page/D24FDA17-DECF-46BB-AF47-AF4647D2B1F8), and the ID of any page of the store works. The Amazon Product API returns it asproduct.brand_store.id. Store IDs are specific to oneamazon_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
-
- Name
-
amazon_domain - Required
- Optional
- Description
-
The default parameter
amazon.comdefines the Amazon domain of the search. Check the full list of supported Amazon domains.
-
- Name
-
language - Required
- Optional
- Description
-
The
languageparameter is used to specify the display language of Amazon page. Check the full list of supported Amazon display languages.
Delivery
-
- Name
-
postal_code - Required
- Optional
- Description
-
Postal code for the delivery location. Use this for postal-code countries (e.g.
10001for US,SW1A 0AAfor UK,M5V 2T6for CA). Check the list of supported Amazon postal codes by domain and format. The response reports the outcome insearch_metadata.delivery_location:applied,not_applied, orunverified.
-
- 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 usepostal_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 withdelivery_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.deforamazon.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 withq. Theasinsarray 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_keyauthenticates 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
trueto 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
https://www.searchapi.io/api/v1/search?engine=amazon_store&store_id=D24FDA17-DECF-46BB-AF47-AF4647D2B1F8
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
https://www.searchapi.io/api/v1/search?engine=amazon_store&q=power+bank&store_id=D24FDA17-DECF-46BB-AF47-AF4647D2B1F8
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
https://www.searchapi.io/api/v1/search?amazon_domain=amazon.in&engine=amazon_store&store_id=D22AD126-B5A3-4916-B232-F83F4C57B16C
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
}
}