# Amazon Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/amazon/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/amazon-search |

## Description

Efficiently scrape Amazon search results for real-time product data and insights across multiple Amazon marketplaces.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/amazon/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search 'playstation 5' on amazon.com

```json
[
  {
    "url": "https://www.amazon.com/PlayStation%C2%AE5-Digital-825GB-PlayStation-5/dp/B0FRGMYJMG/ref=sr_1_1",
    "asin": "B0FRGMYJMG",
    "price": null,
    "title": "PlayStation®5 Digital Edition – 825GB",
    "rating": 4.8,
    "real_price": 344.5,
    "reviews_count": 196
  },
  {
    "url": "https://www.amazon.com/PS5-Playstation-Digital-Wireless-Controller/dp/B0966NLTZS/ref=sr_1_2",
    "asin": "B0966NLTZS",
    "price": 414.42,
    "title": "PS5 - Sony PlayStation 5 Digital Edition Gaming Console + Wireless Controller",
    "rating": 4.4,
    "real_price": 362.62,
    "reviews_count": 248
  },
  {
    "url": "https://www.amazon.com/PlayStation-PS5-Console-Ragnar%C3%B6k-Bundle-5/dp/B0BHC395WW/ref=sr_1_7",
    "asin": "B0BHC395WW",
    "price": null,
    "title": "PlayStation PS5 Console – God of War Ragnarök Bundle",
    "rating": 4.8,
    "real_price": 448.92,
    "reviews_count": 13891
  },
  {
    "url": "https://www.amazon.com/Pok%C3%A9mon-Scarlet-Nintendo-Switch/dp/B09TM8XRND/ref=sr_1_24",
    "asin": "B09TM8XRND",
    "price": 48.99,
    "title": "Pokémon Scarlet - US Version",
    "rating": 4.7,
    "real_price": null,
    "reviews_count": 7396
  }
]
```

## Documentation

## Overview
Search for products across Amazon and retrieve structured result lists including ASINs, titles, prices, ratings, and review counts. Supports all major Amazon marketplaces via the `domain` parameter, and pagination to retrieve more results per query.

## Quickstart
```
GET https://api.piloterr.com/v2/amazon/search?query=playstation+5&domain=com
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword to search for on Amazon |
| `domain` | string | no | Amazon domain extension (default: `com`) |
| `page` | number | no | Page number for paginated results (default: `1`) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `asin` | string | Amazon Standard Identification Number |
| `url` | string | Product URL on Amazon |
| `title` | string | Product title |
| `price` | number\|null | Original listed price |
| `real_price` | number\|null | Actual price after discount |
| `rating` | number\|null | Average customer rating |
| `reviews_count` | number\|null | Total number of customer reviews |

## Notes
- Results include both organic and sponsored listings.
- Use the returned `asin` with the Amazon Product endpoint for full details.

## Main use cases
- Scrape keyword-level Amazon search results to track product rankings and competitive positioning
- Feed pricing intelligence tools with live Amazon product prices and discount data
- Build catalog enrichment pipelines by discovering new ASINs for a given product category
- Monitor which products appear in sponsored vs. organic positions for a target keyword