# Shopee 主页或对象详情 API (shopee.profile)

- Canonical page: [https://everyinfra.com/shopee-api/profile](https://everyinfra.com/shopee-api/profile?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "shopee", "action": "profile", "params": {...}}
- Price: $0.005597 per call ($5.6 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | Shopee 商品完整链接，路径需含 i.店铺ID.商品ID；短链需先取得落地页地址，不能保证直接解析。 |
| country | enum: br / cl / co / id / mx / my / ph / sg / th / tw / vn | no | not declared | 商品所属商城地区代码，支持 id/sg/my/th/ph/vn/br/tw/mx/co/cl；显式值优先于 URL 域名推断，需与链接所属市场一致。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| shop_id | 店铺 ID。 |
| item_id | 商品 ID。 |
| name | 名称。用于账号/商品/商家类能力，指该对象本身的名字。 |
| url | 该记录在原平台上的可访问链接。 |
| description | 简介或描述，通常比 text 短。 |
| price | 价格数值，不含货币符号；币种见 currency。商品详情（product_detail）缺价格时这次调用不扣费，其余数据照常返回。 |
| price_min | 多规格价格下限。 |
| price_max | 多规格价格上限。 |
| original_price | 原价。 |
| discount_pct | 折扣百分比。 |
| 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。 |
| sold_count | 销量。 |
| stock | 库存。 |
| liked_count | 商品被收藏数。 |
| view_count | 浏览/播放数。null 表示不公开，不等于 0。 |
| brand | 品牌。 |
| is_pre_order | 是否为预售。 |
| has_video | 是否有视频。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
| images | 图片链接数组，按平台展示顺序；没有图片时不出现这个字段。 |
| shop | platform-native meaning |

## 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": "shopee",
  "action": "profile",
  "params": {
    "url": "https://shopee.co.id/Case-Casing-for-iPhone-XS-X-6-6s-13-XR-SE2-8-7Plus-15-PlusProMax-12-Max-SE3-Plus-14-XS-11-soft-case-hp-lucu-unik-KQ04060401-i.1761879954.56511647417"
  }
}'
```

```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": "shopee",
        "action": "profile",
        "params": {
            "url": "https://shopee.co.id/Case-Casing-for-iPhone-XS-X-6-6s-13-XR-SE2-8-7Plus-15-PlusProMax-12-Max-SE3-Plus-14-XS-11-soft-case-hp-lucu-unik-KQ04060401-i.1761879954.56511647417",
        },
    },
    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": "shopee",
  "action": "profile",
  "results": {
    "shop_id": 1761879954,
    "item_id": 56511647417,
    "name": "Case Casing for iPhone XS X 6 6s 13 XR SE2 8 7Plus 15 PlusProMax 12 Max SE3 Plus 14 XS 11 soft case hp lucu unik KQ04060401",
    "description": "Selamat datang!\nPesanan yang dilakukan sebelum pukul 12 siang akan dikirim pada hari yang sama dan pesanan yang dilakukan setelah pukul 12 siang akan dikirim keesokan harinya dalam kondisi normal (kecuali dalam kondisi khusus), kecuali hari libur dan acara khusus.\n\n\nPengiriman Lo…",
    "price": 17000,
    "price_min": 17000,
    "price_max": 17000,
    "discount_pct": 73,
    "currency": "IDR",
    "rating": 4.9,
    "rating_count": [],
    "sold_count": 5000,
    "is_pre_order": false,
    "has_video": true,
    "platform": "shopee",
    "images": [
      "https://down-id.img.susercontent.com/file/sg-11134201-823qk-mp1vma3mmole2f",
      "https://down-id.img.susercontent.com/file/sg-11134201-823pe-mp1vmbgs9t7149",
      "https://down-id.img.susercontent.com/file/sg-11134201-823q5-mp1vmcnrxrf175"
    ],
    "shop": {
      "shop_id": 1761879954,
      "name": "case lucu id",
      "username": "•••",
      "location": "KAB. TANGERANG",
      "rating": 4.872473,
      "item_count": 2815,
      "follower_count": 1764,
      "response_rate": 97,
      "is_official_shop": false,
      "is_shopee_verified": false
    },
    "rating_scale": 5
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

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