# Search products by term and store

> Search Amazon products by a search term within a given store.

`POST https://api.amzconnect.io/v1/search/products`

## Authentication

Include an `Authorization` header with the value `Bearer {YOUR_API_KEY}`. You can retrieve your API key from your dashboard.

## Request body (required)

- `store` (string, required): The store identifier (Amazon marketplace). Search covers fewer stores than product lookup.
  - Allowed values: `com`, `co.uk`, `de`, `fr`, `it`, `es`, `ca`, `com.au`, `co.jp`, `in`, `com.br`, `com.mx`, `nl`, `se`, `pl`, `com.tr`, `ae`, `sg`
  - Example: `com`
- `search_term` (string, required): The search term.
  - Example: `iPhone`

## Example request

```bash
curl --request POST \
  --url https://api.amzconnect.io/v1/search/products \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"store":"com","search_term":"iPhone"}'
```

## Responses

### `200`

Search results as a JSON array, one object per product in the order of the Amazon results page (`position`). Sponsored results carry `"sponsored": true`; organic ones have no `sponsored` field. The example shows 2 of the 17 results of a search for `iphone` in `com`.

```json
[
  {
    "position": 1,
    "title": "Amazon Renewed iPhone 17 Pro, US Version, 256GB, eSIM, Cosmic Orange- Unlocked (Renewed)",
    "asin": "B0FSB615TX",
    "link": "https://www.amazon.com/Apple-Version-Orange-Unlocked-Renewed/dp/B0FSB615TX/ref=sr_1_1?dib=eyJ2IjoiMSJ9.zVZYMoJDnJLpVoyvon44SStVd9CtVUDRKI2C114cMRtff5j_eXP0QSMUX_JbYWG9xpG22TYAvZ5TLSpDahSWcZszYuaEDnLmgOBoz0zKafFRt4GzhP0fpbBEk_dg1m-effKp2qDY2n3MA8XXTi5SrNz11VUGlb-A8tkRNae49iEv7kjPHxipAbrT7aoOzACYJIqLHvHXpTaZ2_YkQBaRuVeTAUQQIaWBPyR7WItONtc._jqZht4oMCnjfqmqahcGyGx_VMbG85_9Lz9wmvuyl60&dib_tag=se&keywords=iphone&qid=1791357397&sbo=GW1QB%2BmqAsHTPf1jTZRSDA%3D%3D&sr=8-1",
    "recent_sales": "500+ bought in past month",
    "brand": "Amazon Renewed",
    "availability": {
      "raw": "Only 1 left in stock - order soon."
    },
    "categories": [
      {
        "name": "All Departments",
        "id": "aps"
      }
    ],
    "image": "https://m.media-amazon.com/images/I/51--V4WSvZL._AC_UY218_.jpg",
    "is_prime": false,
    "is_amazon_fresh": false,
    "is_whole_foods_market": false,
    "rating": 4.2,
    "ratings_total": 501,
    "prices": [
      {
        "symbol": "$",
        "value": 998,
        "currency": "USD",
        "raw": "$998.00",
        "asin": "B0FSB615TX",
        "link": "https://www.amazon.com/Apple-Version-Orange-Unlocked-Renewed/dp/B0FSB615TX/ref=sr_1_1?dib=eyJ2IjoiMSJ9.zVZYMoJDnJLpVoyvon44SStVd9CtVUDRKI2C114cMRtff5j_eXP0QSMUX_JbYWG9xpG22TYAvZ5TLSpDahSWcZszYuaEDnLmgOBoz0zKafFRt4GzhP0fpbBEk_dg1m-effKp2qDY2n3MA8XXTi5SrNz11VUGlb-A8tkRNae49iEv7kjPHxipAbrT7aoOzACYJIqLHvHXpTaZ2_YkQBaRuVeTAUQQIaWBPyR7WItONtc._jqZht4oMCnjfqmqahcGyGx_VMbG85_9Lz9wmvuyl60&dib_tag=se&keywords=iphone&qid=1791357397&sbo=GW1QB%2BmqAsHTPf1jTZRSDA%3D%3D&sr=8-1"
      }
    ],
    "price": {
      "symbol": "$",
      "value": 998,
      "currency": "USD",
      "raw": "$998.00",
      "asin": "B0FSB615TX",
      "link": "https://www.amazon.com/Apple-Version-Orange-Unlocked-Renewed/dp/B0FSB615TX/ref=sr_1_1?dib=eyJ2IjoiMSJ9.zVZYMoJDnJLpVoyvon44SStVd9CtVUDRKI2C114cMRtff5j_eXP0QSMUX_JbYWG9xpG22TYAvZ5TLSpDahSWcZszYuaEDnLmgOBoz0zKafFRt4GzhP0fpbBEk_dg1m-effKp2qDY2n3MA8XXTi5SrNz11VUGlb-A8tkRNae49iEv7kjPHxipAbrT7aoOzACYJIqLHvHXpTaZ2_YkQBaRuVeTAUQQIaWBPyR7WItONtc._jqZht4oMCnjfqmqahcGyGx_VMbG85_9Lz9wmvuyl60&dib_tag=se&keywords=iphone&qid=1791357397&sbo=GW1QB%2BmqAsHTPf1jTZRSDA%3D%3D&sr=8-1"
    },
    "delivery": {
      "tagline": "FREE delivery Oct 13 - 14",
      "price": {
        "raw": "$998.00",
        "symbol": "$",
        "value": 998,
        "currency": "USD",
        "is_free": false
      }
    }
  },
  {
    "position": 3,
    "title": "Amazon Renewed iPhone 16e, 128GB, Black - Unlocked (Renewed)",
    "asin": "B0F4RM7Y2L",
    "link": "https://www.amazon.com/Apple-iPhone-128GB-eSIM-Black/dp/B0F4RM7Y2L/ref=sr_1_3?dib=eyJ2IjoiMSJ9.zVZYMoJDnJLpVoyvon44SStVd9CtVUDRKI2C114cMRtff5j_eXP0QSMUX_JbYWG9xpG22TYAvZ5TLSpDahSWcZszYuaEDnLmgOBoz0zKafFRt4GzhP0fpbBEk_dg1m-effKp2qDY2n3MA8XXTi5SrNz11VUGlb-A8tkRNae49iEv7kjPHxipAbrT7aoOzACYJIqLHvHXpTaZ2_YkQBaRuVeTAUQQIaWBPyR7WItONtc._jqZht4oMCnjfqmqahcGyGx_VMbG85_9Lz9wmvuyl60&dib_tag=se&keywords=iphone&qid=1791357397&sbo=GW1QB%2BmqAsHTPf1jTZRSDA%3D%3D&sr=8-3",
    "recent_sales": "5K+ bought in past month",
    "brand": "Amazon Renewed",
    "availability": {
      "raw": null
    },
    "categories": [
      {
        "name": "All Departments",
        "id": "aps"
      }
    ],
    "image": "https://m.media-amazon.com/images/I/51H8+zCj2cL._AC_UY218_.jpg",
    "is_prime": false,
    "is_amazon_fresh": false,
    "is_whole_foods_market": false,
    "rating": 4.2,
    "ratings_total": 2226,
    "prices": [
      {
        "symbol": "$",
        "value": 379,
        "currency": "USD",
        "raw": "$379.00",
        "asin": "B0F4RM7Y2L",
        "link": "https://www.amazon.com/Apple-iPhone-128GB-eSIM-Black/dp/B0F4RM7Y2L/ref=sr_1_3?dib=eyJ2IjoiMSJ9.zVZYMoJDnJLpVoyvon44SStVd9CtVUDRKI2C114cMRtff5j_eXP0QSMUX_JbYWG9xpG22TYAvZ5TLSpDahSWcZszYuaEDnLmgOBoz0zKafFRt4GzhP0fpbBEk_dg1m-effKp2qDY2n3MA8XXTi5SrNz11VUGlb-A8tkRNae49iEv7kjPHxipAbrT7aoOzACYJIqLHvHXpTaZ2_YkQBaRuVeTAUQQIaWBPyR7WItONtc._jqZht4oMCnjfqmqahcGyGx_VMbG85_9Lz9wmvuyl60&dib_tag=se&keywords=iphone&qid=1791357397&sbo=GW1QB%2BmqAsHTPf1jTZRSDA%3D%3D&sr=8-3"
      }
    ],
    "price": {
      "symbol": "$",
      "value": 379,
      "currency": "USD",
      "raw": "$379.00",
      "asin": "B0F4RM7Y2L",
      "link": "https://www.amazon.com/Apple-iPhone-128GB-eSIM-Black/dp/B0F4RM7Y2L/ref=sr_1_3?dib=eyJ2IjoiMSJ9.zVZYMoJDnJLpVoyvon44SStVd9CtVUDRKI2C114cMRtff5j_eXP0QSMUX_JbYWG9xpG22TYAvZ5TLSpDahSWcZszYuaEDnLmgOBoz0zKafFRt4GzhP0fpbBEk_dg1m-effKp2qDY2n3MA8XXTi5SrNz11VUGlb-A8tkRNae49iEv7kjPHxipAbrT7aoOzACYJIqLHvHXpTaZ2_YkQBaRuVeTAUQQIaWBPyR7WItONtc._jqZht4oMCnjfqmqahcGyGx_VMbG85_9Lz9wmvuyl60&dib_tag=se&keywords=iphone&qid=1791357397&sbo=GW1QB%2BmqAsHTPf1jTZRSDA%3D%3D&sr=8-3"
    },
    "delivery": {
      "tagline": "FREE delivery Fri, Oct 9 Or fastest delivery Tomorrow, Oct 8",
      "price": {
        "raw": "$379.00",
        "symbol": "$",
        "value": 379,
        "currency": "USD",
        "is_free": false
      }
    }
  }
]
```

### `400`

The store or search term is missing or invalid.

```json
{
  "code": "bad_request",
  "message": "Bad Request! Invalid store or search term."
}
```

### `403`

The API key is missing, unknown or expired (`invalid_key`, `expired_key`), or your search limit is reached (`too_many_requests`).

Example `invalid_key`:

```json
{
  "code": "invalid_key",
  "message": "Invalid API Key provided."
}
```

Example `expired_key`:

```json
{
  "code": "expired_key",
  "message": "API Key has expired."
}
```

Example `too_many_requests`:

```json
{
  "code": "too_many_requests",
  "message": "Too many Search API requests."
}
```

### `404`

No results for this search term in this store.

```json
{
  "code": "not_found",
  "message": "No search results for search term iPhone on store com"
}
```

---

Source: https://amzconnect.io/docs/api/reference/operations/searchproducts/