Search products by term and store

POST

/v1/search/products

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

• AMZ Connect API

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

Authorizations

• bearerAuth

Request Body^required

Media typeapplication/json

object

store

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.

string

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

required

The search term.

string

Example

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.

Media typeapplication/json

Example

[
  {
    "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.

Media typeapplication/json

Example

{
  "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).

Media typeapplication/json

Examples

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

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

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

404

No results for this search term in this store.

Media typeapplication/json

Example

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