# Amazon 主页或对象详情 API (amazon.profile)

- Canonical page: https://everyinfra.com/amazon-api/profile
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "amazon", "action": "profile", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

Amazon 商品详情（能力名为主页或对象详情）按商品链接读取一件商品：ASIN、标题、品牌、价格与划线原价、评分和评分人数、库存状态、分类、全部图片、卖点要点、描述、卖家、畅销榜排名，以及是否带 Amazon's Choice 标。它回答「这件商品的卖点、价格和位置如何」，适合竞品拆解、商品资料补全和价格监测。

`url` 用 https://www.amazon.com/dp/<ASIN> 这样的商品链接；这里的「详情」指商品，不是用户资料。`lang` 可以指定页面语言，简体中文填 `zhcn`。价格的币种看 `currency`；`list_price` 是划线原价，和 `price` 一起能算出折扣。

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | Amazon 商品链接，例如 https://www.amazon.com/dp/<ASIN>。reviews 从 /dp/、/gp/product/ 或 /product-reviews/ 路径提取 10 位大写字母/数字 ASIN；不能用店铺首页代替。profile 在这里指商品详情，不是用户资料。 |
| 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。只接受当前接口列出的语言代码，选择语言不等于切换国家站点。 |

## 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": "profile",
  "params": {
    "url": "https://www.amazon.com/dp/B09B8V1LZ3"
  }
}'
```

```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": "profile",
        "params": {
            "url": "https://www.amazon.com/dp/B09B8V1LZ3",
        },
    },
    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. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "amazon",
  "action": "profile",
  "results": {
    "asin": "B09B8V1LZ3",
    "title": "Amazon Echo Dot (newest model) - Vibrant sounding speaker, Designed for Alexa+, Great for bedrooms, dining rooms and offices, Charcoal",
    "url": "https://www.amazon.com/dp/B09B8V1LZ3",
    "brand": "Amazon",
    "price": 79.99,
    "currency": "$",
    "rating": 4.7,
    "rating_count": 200079,
    "in_stock": true,
    "category": "",
    "image_url": "https://m.media-amazon.com/images/I/61J2sQtBYDL._AC_SY300_SX300_QL70_FMwebp_.jpg",
    "is_amazon_choice": false,
    "seller_name": "Amazon.com",
    "platform": "amazon",
    "images": [
      "https://m.media-amazon.com/images/I/61J2sQtBYDL._AC_SL1500_.jpg",
      "https://m.media-amazon.com/images/I/71hNp8d9WvL._AC_SL1500_.jpg",
      "https://m.media-amazon.com/images/I/71kDL97LTgL._AC_SL1500_.jpg"
    ],
    "features": [
      "Your favorite music and content – Play music, audiobooks, and podcasts from Amazon Music, Apple Music, Spotify and others or via Bluetooth throughout your home.",
      "Alexa is happy to help – Ask Alexa for weather updates and to set hands-free timers, get answers to your questions and even hear jokes. Need a few extra minutes in the morning? Just tap your Echo Dot to snooze your alarm.",
      "Keep your home comfortable – Control compatible smart home devices with your voice and routines triggered by built-in motion or indoor temperature sensors. Create routines to automatically turn on lights when you walk into a room, or start a fan if the inside temperature goes abo…"
    ],
    "bestseller_ranks": [
      {
        "rank": 1,
        "category": "Wireless Multiroom Digital Music Systems"
      }
    ],
    "rating_scale": 5
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### 这里的「主页或对象详情」是用户主页吗？

不是。在 Amazon 这里，它读取的是商品详情：传商品链接，返回这件商品的价格、评分、图片、卖家等信息，不涉及任何用户资料。

### 怎么算商品的折扣？

用 `list_price`（划线原价）和 `price`（当前价）计算，币种看 `currency`。没有 `list_price` 时，不要假设这件商品在打折。

### 评分能和其他平台直接比吗？

要先换算：`rating_scale` 给出满分，Amazon 是五星制，跨平台比较前按满分换算；再结合 `rating_count` 看评分人数，人数少的评分波动大。

## 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