# Amazon Details API (amazon.profile)

- Canonical page: https://everyinfra.com/en/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 Details reads one product from its link: ASIN, title, brand, price and list price, rating and rating count, stock status, category, every image, the feature bullets, description, seller, bestseller ranks and whether it carries the Amazon's Choice badge. Use it to take a competitor's product apart, enrich your product records or track prices.

Pass a product link such as https://www.amazon.com/dp/<ASIN>; details here mean the product, not a user profile. Set `lang` for the page language, with `zhcn` for Simplified Chinese. Read the currency from `currency`; `list_price` is the struck-through price, so together with `price` it gives the discount.

## 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 | Specifies an Amazon product URL, such as https://www.amazon.com/dp/<ASIN>. The reviews action extracts a 10-character uppercase alphanumeric ASIN from /dp/, /gp/product/, or /product-reviews/ paths; store homepages are not supported. For this parameter, profile fetches the product details page rather than user profile data. |
| 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 | Specifies the page language for supported Amazon endpoints using valid codes such as en or ja. Use zhcn for Simplified Chinese and zhtw for Traditional Chinese instead of a generic zh code. Requests accept only the language codes listed for the action, and selecting a language alters the rendered content rather than changing the target country store. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| asin | Amazon Standard Identification Number, the product's unique ID within a store. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| url | Link to the record on the platform. |
| brand | Brand. |
| price | Price as a number without a currency symbol; see currency. |
| list_price | List (strike-through) price. |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| rating | Rating. **The scale varies by platform**: rating_scale on the same row gives the maximum (usually 5; Booking, Douban, iQIYI and NAVER use 10). Convert with rating_scale before comparing across platforms, or the comparison can come out backwards. |
| rating_scale | Maximum of rating in the same row: 5 for five-star scales, 10 for ten-point scales. Present only when the row has a rating. |
| rating_count | Number of people who rated. null means not disclosed, not 0. |
| in_stock | Whether the product is in stock. |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| description | Summary or description, usually shorter than text. |
| is_amazon_choice | Whether the product carries the Amazon's Choice badge. |
| seller_name | Seller name. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| images | Array of image links in the platform's display order; absent when there are no images. |
| features | Bullet-point feature list from the product page (search, profile), as written; absent when there is none. |
| bestseller_ranks | Best Sellers ranks (search, profile): each item has rank and category, one entry per category; the rank at read time, not a sales figure. |

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

### Does Details return a user profile?

No. On Amazon it reads product details: pass a product link and get the product's price, rating, images, seller and related data. No user information is involved at any point.

### How do I work out a product's discount?

Compare `list_price`, the struck-through price, with `price`, the current price, in the currency given by `currency`. When there is no `list_price`, do not assume the product is discounted.

### Can I compare ratings with other marketplaces directly?

Convert first: `rating_scale` gives the maximum, five on Amazon, so scale ratings before comparing across marketplaces. Read them with `rating_count` too, since ratings from few people swing widely.

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