https://api.sandbase.ai/v1/api/amazon/freshSearch Amazon Fresh grocery products for a delivery ZIP code, with title, price, unit price, rating and availability.
Your output will appear here
Complete the inputs, then click Run.
Search Amazon Fresh grocery products for a delivery ZIP code, with title, price, unit price, rating and availability.
curl -X POST "https://api.sandbase.ai/v1/api/amazon/fresh" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"k": "milk", "delivery_zip": "10001"}'
The result is returned in outputs[0].data as structured JSON.
| Name | Type | Required | Description |
|---|---|---|---|
delivery_zip | string | Yes | Parameter defines the ZIP or postal code of the delivery location. Amazon Fresh shows the products, prices, and delivery options available at that location. For example, 10001 on amazon.com, EC1A 1BB on amazon.co.uk, or 100-0001 o |
k | string | No | Parameter defines the query you want to search. You can use anything that you would use in a regular Amazon Fresh search. This parameter can't be used with the node parameter. |
amazon_domain | string | No | Parameter defines the Amazon domain to use. It defaults to amazon.com. Amazon Fresh is available on amazon.com, amazon.co.uk, amazon.co.jp, amazon.it, and amazon.es. |
language | string | No | Parameter defines the language to use for the Amazon Fresh search. It's a locale name represented as <language>_<REGION>. (e.g., on amazon.com en_US for English, es_US for Spanish, or on amazon.co.jp ja_JP for Japanese). Head to Amazo |
s | string | No | Parameter is used for sorting results. It defaults to relevanceblender (Featured). Available options: relevanceblender - Featured price-asc-rank - Price: Low to High price-desc-rank - Price: High to Low review-rank - Avg. Customer |
node | string | No | Parameter defines the Amazon Fresh department to browse without a search query. For example, 16318981 for Fresh Fruits on amazon.com. Department IDs are the n: values in filters.department[].rh (e.g., n:16318981). To switch de |
rh | string | No | Parameter defines items filtering based on their attributes. The structure is a list of key:value pairs separated by ,. For example n:16318981,p_n_program_participation:17428820011 to filter for products in the Fresh Fruits depart |
dc | string | No | Parameter defines the exclusion of results from an auto-corrected query when the original query is spelled wrong. It can be set to true to exclude these results, or false to include them (default). |
page | string | No | Parameter defines the page number. It's used for pagination. (e.g., 1 (default) is the first page of results, 2 is the 2nd page of results, 3 is the 3rd page of results, etc.). |
device | string | No | Parameter defines the device to use to get the results. It can be set to desktop (default) to use a regular browser, tablet to use a tablet browser (currently using iPads), or mobile to use a mobile browser. |
json_restrictor | string | No | Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details. |
$0.010 per successful call. Failed calls are not charged.
Start building
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/amazon/fresh" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"k": "milk",
"delivery_zip": "10001"
}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
delivery_zipstringrequiredParameter defines the ZIP or postal code of the delivery location. Amazon Fresh shows the products, prices, and delivery options available at that location. For example, `10001` on `amazon.com`, `EC1A 1BB` on `amazon.co.uk`, or `100-0001` on `amazon.co.jp`. ZIP+4 codes aren't supported.
kstringParameter defines the query you want to search. You can use anything that you would use in a regular Amazon Fresh search. This parameter can't be used with the `node` parameter.
amazon_domainstringParameter defines the Amazon domain to use. It defaults to `amazon.com`. Amazon Fresh is available on `amazon.com`, `amazon.co.uk`, `amazon.co.jp`, `amazon.it`, and `amazon.es`.
languagestringParameter defines the language to use for the Amazon Fresh search. It's a locale name represented as <language>_<REGION>. (e.g., on amazon.com `en_US` for English, `es_US` for Spanish, or on amazon.co.jp `ja_JP` for Japanese). Head to Amazon languages for a full list of supported Amazon languages.
sstringParameter is used for sorting results. It defaults to `relevanceblender` (Featured). Available options: `relevanceblender` - Featured `price-asc-rank` - Price: Low to High `price-desc-rank` - Price: High to Low `review-rank` - Avg. Customer Review `date-desc-rank` - Newest Arrivals `exact-aware-popularity-rank` - Best Sellers
nodestringParameter defines the Amazon Fresh department to browse without a search query. For example, `16318981` for **Fresh Fruits** on `amazon.com`. Department IDs are the `n:` values in `filters.department[].rh` (e.g., `n:16318981`). To switch departments while browsing, change `node` or follow the department's `the API_link`: Amazon ignores departments in `rh` while `node` is set. This parameter can't be used with the `k` parameter.
rhstringParameter defines items filtering based on their attributes. The structure is a list of `key:value` pairs separated by `,`. For example `n:16318981,p_n_program_participation:17428820011` to filter for products in the **Fresh Fruits** department (`n:16318981`) that are **SNAP EBT Eligible** (`p_n_program_participation:17428820011`) on `amazon.com`. Use `p_36:<min>-<max>` for a price range, with prices multiplied by 100 (e.g., `p_36:300-500` for $3.00 to $5.00). Available filters depend on the query and are returned in `filters`, along with a `the API_link` to apply each of them.
dcstringParameter defines the exclusion of results from an auto-corrected query when the original query is spelled wrong. It can be set to `true` to exclude these results, or `false` to include them (default).
pagestringParameter defines the page number. It's used for pagination. (e.g., `1` (default) is the first page of results, `2` is the 2nd page of results, `3` is the 3rd page of results, etc.).
devicestringParameter defines the device to use to get the results. It can be set to `desktop` (default) to use a regular browser, `tablet` to use a tablet browser (currently using iPads), or `mobile` to use a mobile browser.
json_restrictorstringParameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.
Saved example response for this API; no live request is made when viewing it.
No saved response has been published. Run the API in Playground to inspect its response.
Explore more
| API | Price | Response |
|---|---|---|
Amazon Fresh SearchThis API Amazon | $0.01 per call | JSON |
Amazon | From $0.0033 per call | JSON |
Amazon | $0.00015 per call | Async JSON |
Amazon | $0.014286 per call | JSON |
Amazon | $0.014286 per call | JSON |
Amazon | From $0.00085 per call | JSON |
Questions
Send a POST request to https://api.sandbase.ai/v1/api/amazon/fresh with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
Required: delivery_zip (string). Optional: k (string), amazon_domain (string), language (string), s (string), node (string) and rh (string) and 4 more. The Parameters table and the Playground on this page list every field.
A JSON response returned in the same HTTP request (synchronous).
No. Amazon Fresh Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Amazon API access separately.