> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegoro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon search results

> Amazon search result pages for one or more keywords. Each product carries its ASIN, title, price and retail price, rating and review count, Prime and sponsored 

Amazon search result pages for one or more keywords. Each product carries its ASIN, title, price and retail price, rating and review count, Prime and sponsored flags, image and product URL, and the position it held in the results.

<Note>Use to find products on Amazon by keyword, to see where a listing ranks for a search term, or to pull a competitive set with prices and ratings. Use amazon.product instead when you already know the ASINs.</Note>

## Price

**\$0.0003 per result.** That is the rate you pay for each result the call returns, so the total depends on how many it produces.

Billing follows actual usage, so a call that returns fewer results costs less. `discover` and `inspect` also return a ceiling for your specific request, which is a maximum you will never be charged above.

## Input

| Field   | Type    | Required | Notes                                                                                                                        |
| ------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `input` | `array` | yes      | One entry per keyword search. Every product returned is billed, so each extra entry and each extra page multiplies the cost. |

<Note>
  Goro forwards your input to the underlying tool unchanged, so any field the
  tool accepts works here even if it is not listed above.
</Note>

## Example

```bash theme={null}
curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"amazon.search","input":{"input":["example"]}}'
```

## Response

One row of the response. Values are illustrative.

```json theme={null}
{
  "asin": "B07CMS5Q6P",
  "dpUrl": "https://www.amazon.com/dp/B07CMS5Q6P",
  "price": 39.99,
  "prime": true,
  "imgUrl": "https://m.media-amazon.com/images/I/31zy93Vq31L.jpg",
  "keyword": "wireless mouse",
  "sponsored": false,
  "domainCode": "com",
  "statusCode": 200,
  "countReview": 39211,
  "currentPage": 1,
  "resultCount": 2000,
  "retailPrice": 49.99,
  "salesVolume": "10K+ bought in past month",
  "sortStrategy": "relevanceblender",
  "productRating": "4.6 out of 5 stars",
  "statusMessage": "success",
  "productDescription": "Logitech G305 Lightspeed Wireless Gaming Mouse",
  "searchResultPosition": 1
}
```