# Amazon 关键词搜索 API (amazon.search)

- Canonical page: https://everyinfra.com/amazon-api/search
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "amazon", "action": "search", "params": {...}}
- Price: $0.002236 per call ($2.24 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 10, max 50 per call
- Mode: sync; add "mode": "async" for slow tasks

Amazon 关键词搜索按 `keyword` 检索 Amazon 商品，返回 ASIN、标题、品牌、价格与划线原价、评分和评分人数、是否有货、分类、图片、卖家，以及是否带 Amazon's Choice 标。它回答「这个关键词下有哪些商品、价位和口碑如何」，适合跨境选品、竞品价格扫描和观察关键词下的市场格局。

用 `domain` 指定国家站点，例如 amazon.co.uk；用 `lang` 指定页面语言，简体和繁体中文分别是 `zhcn` 和 `zhtw`，选择语言不等于切换站点。结果里的 `asin` 可以拼出商品链接，交给 Amazon 的商品详情或评价能力继续深挖；`rating_count` 少的商品，评分的参考价值有限。

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=amazon&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | 随接口区分：search 是商品搜索词；bestsellers 优先传 Amazon 类目畅销榜完整 URL，也接受用于拼接榜单路径的类目短名；sellers 可传商品/卖家相关页面 URL，普通文字则先构造商品搜索页，并非按卖家 ID 精确查找。 |
| domain | not declared | no | not declared | Amazon 国家站点域名，例如 amazon.com、amazon.co.uk、amazon.co.jp；不要带 https:// 或页面路径，默认 amazon.com。search 用它构造这个站点的搜索页。 |
| fast | not declared | no | not declared | 快速模式。只接受 JSON 布尔值 `true` / `false`，默认 `false`；字符串 `"true"` 会被拒。只需要标题、价格、评分和链接时传 `true`：通常 10–20 秒返回，回包顶层多一个 `"fast": true`，每行不含 `brand`、`in_stock`、`category`、`description`、`seller_name`、`images`、`features`、`bestseller_ranks` 这 8 个字段。价格和不传时一样。只能同步调用，也不能和 `lang` 一起传，否则回 422。只支持部分站点，站点不支持时回 422，报错里列出支持的站点。不传或传 `false` 时一切照旧。 |
| lang | enum: ar / bn / cs / da / de / en / es / fr / he / hi / ja / kn / ko / ml / mrta / nl / pl / pt / sv / ta / te / tr / zhcn / zhtw | no | not declared | 页面内容语言。en / ja 等为英文 / 日文；简体和繁体中文使用 zhcn / zhtw，不是通用 zh。只接受当前接口列出的语言代码，选择语言不等于切换国家站点。 |
| limit | integer (1–50) | no | 10 | 这次调用最多返回的条数，整数，1–50；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| asin | Amazon 标准识别号，站内唯一商品标识。 |
| title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
| url | 该记录在原平台上的可访问链接。 |
| brand | 品牌。 |
| price | 价格数值，不含货币符号；币种见 currency。 |
| list_price | 划线原价。 |
| currency | 价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。 |
| rating | 评分。**分制随平台而异**，同一行的 `rating_scale` 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。 |
| rating_scale | 上一列 `rating` 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。 |
| rating_count | 参与评分的人数。null 表示不公开，不等于 0。 |
| in_stock | 是否有货。 |
| category | 分类名称，取值为原平台的分类体系，未做跨平台归一。 |
| image_url | 图片链接。多图能力可能返回 image_urls 数组。 |
| description | 简介或描述，通常比 text 短。 |
| is_amazon_choice | 是否有 Amazon's Choice 标。 |
| seller_name | 卖家名称。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
| images | 图片链接数组，按平台展示顺序；没有图片时不出现这个字段。 |
| features | 商品页上的卖点要点列表（search / profile），按页面原文；没有时没有这个字段。 |
| bestseller_ranks | Best Sellers 排名列表（search / profile）：每项含 rank（名次）和 category（所在类目），同一商品在不同类目的名次分开列；是采集时的名次，不是销量。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "amazon",
  "action": "search",
  "params": {
    "keyword": "coffee grinder"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "amazon",
        "action": "search",
        "params": {
            "keyword": "coffee grinder",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 10. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "amazon",
  "action": "search",
  "results": [
    {
      "asin": "B0GWHGT8C6",
      "title": "SHARDOR Burr Coffee Grinder Electric with 32 Grinding Sizes, 2026 Upgraded",
      "url": "https://www.amazon.com/dp/B0GWHGT8C6",
      "brand": "SHARDOR",
      "price": 39.98,
      "list_price": 49.99,
      "currency": "$",
      "rating": 4.4,
      "rating_count": 23,
      "in_stock": true,
      "category": "Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Grinders > Electric Burr Grinders",
      "image_url": "https://m.media-amazon.com/images/I/71umDJaSBGL._AC_SY300_SX300_QL70_FMwebp_.jpg",
      "is_amazon_choice": false,
      "seller_name": "KDSXG",
      "platform": "amazon",
      "images": [
        "https://m.media-amazon.com/images/I/71umDJaSBGL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71WkUEs07pL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71h+360x8gL._AC_SL1500_.jpg"
      ],
      "features": [
        "CONSISTENT DAILY GRINDING Designed for home coffee routines, this flat burr grinder helps prepare beans for drip, pour over, french press, cold brew, moka pot, and espresso style drinks. The compact body fits small counters, apartments, office corners, and coffee stations without…",
        "SMALL BATCH CONTROL The adjustable time based grinding design lets users grind only what they need for fresh cups, single serve brewers, or family coffee prep. To help protect the motor, the built in safety program supports up to 120 seconds of continuous operation before a short…",
        "32 SIZE OPTIONS Choose from 32 grind settings to match different brewing needs, from finer grounds for espresso style preparation to coarser grounds for french press and cold brew. The grinder includes a chamber, cleaning brush, and hopper for daily use and simple upkeep."
      ],
      "bestseller_ranks": [
        {
          "rank": 19549,
          "category": "Home & Kitchen"
        },
        {
          "rank": 7,
          "category": "Burr Coffee Grinders"
        }
      ],
      "rating_scale": 5
    },
    {
      "asin": "B0HB98V4SP",
      "title": "Flat Burr Coffee Grinder Electric, Adjustable Coffee Bean Grinder with 17 Grinding Sizes, Burr Mill for Espresso & French Press, 2-12 Cup, Silver",
      "url": "https://www.amazon.com/dp/B0HB98V4SP",
      "brand": "Rounexes",
      "price": 39.99,
      "currency": "$",
      "rating": 5,
      "rating_count": 17,
      "in_stock": true,
      "category": "Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Grinders > Electric Burr Grinders",
      "image_url": "https://m.media-amazon.com/images/I/81lB7SOI39L._AC_SY300_SX300_QL70_FMwebp_.jpg",
      "is_amazon_choice": false,
      "seller_name": "MeiDing",
      "platform": "amazon",
      "images": [
        "https://m.media-amazon.com/images/I/81lB7SOI39L._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/81khWIt-ThL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/712ulwCFZuL._AC_SL1500_.jpg"
      ],
      "features": [
        "[17 Precise Grind Settings] From fine espresso to coarse French press, dial in the perfect grind across 17 calibrated levels—ideal for drip, pour-over, or cold brew, and designed to unlock your beans’ full aroma every morning.",
        "[Uniform Flat Burr & Anti-Overheating] Heavy-duty stainless steel flat burrs ensure even grinding for consistent extraction and richer flavor. Low-speed operation prevents overheating, preserving delicate oils and freshness.",
        "[2–12 Cup Quantity Control] Set your desired yield (2–12 cups) with the intuitive cup selector knob and 7 oz. bean hopper—grind just what you need, with zero waste."
      ],
      "bestseller_ranks": [
        {
          "rank": 68800,
          "category": "Home & Kitchen"
        },
        {
          "rank": 28,
          "category": "Burr Coffee Grinders"
        }
      ],
      "rating_scale": 5
    }
  ],
  "count": 10,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### 怎么搜英国、日本等其他站点？

用 `domain` 传站点域名，例如 amazon.co.uk、amazon.co.jp，不带 https:// 和路径；不传时默认 amazon.com。`lang` 只改变页面语言，不会切换站点。

### `lang` 该怎么填？

只接受接口列出的语言代码，例如 `en`、`ja`、`de`；简体中文填 `zhcn`，繁体中文填 `zhtw`，不能写成笼统的 zh。语言只影响页面文字，不影响商品所在的站点。

### 搜到商品后怎么看评价？

用结果的 `asin` 拼出 https://www.amazon.com/dp/<ASIN> 这样的商品链接（换成搜索时的站点），传给 Amazon 的评价能力；非美国站还要在评价能力的 `domain` 里传同一个站点，否则按 amazon.com 读。

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=amazon
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md