# Amazon Fresh Search API

> Search Amazon Fresh grocery products for a delivery ZIP code, with title, price, unit price, rating and availability.

Source: https://www.sandbase.ai/apis/amazon/fresh
API reference: https://www.sandbase.ai/apis/amazon/fresh#api

## Facts

- Provider: Amazon
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/amazon/fresh`
- Price: $0.01 per call
- Capabilities: api, amazon, ecommerce, grocery
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/amazon/fresh` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `delivery_zip` | string | yes |  |
| `k` | string | no |  |
| `amazon_domain` | string | no |  |
| `language` | string | no |  |
| `s` | string | no |  |
| `node` | string | no |  |
| `rh` | string | no |  |
| `dc` | string | no |  |
| `page` | string | no |  |
| `device` | string | no |  |
| `json_restrictor` | string | no |  |

## FAQ

### How do I use the Amazon Fresh Search API?

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.

### How much does the Amazon Fresh Search API cost?

$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Amazon Fresh Search API accept?

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.

### What does the Amazon Fresh Search API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Amazon developer account or API key?

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.

## README

### Amazon Fresh Search

Search Amazon Fresh grocery products for a delivery ZIP code, with title, price, unit price, rating and availability.

#### Request

```bash
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.

#### Parameters

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

#### Pricing

$0.010 per successful call. Failed calls are not charged.