# Shopee Details API (shopee.profile)

- Canonical page: [https://everyinfra.com/en/shopee-api/profile](https://everyinfra.com/en/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 | Specifies the full Shopee product URL for `profile` and `product_detail`. `profile` extracts identifiers using the `i.shop_id.product_id` pattern. Shortened links must be resolved to their landing page URL first and are not guaranteed to parse directly. |
| country | enum: br / cl / co / id / mx / my / ph / sg / th / tw / vn | no | not declared | Sets the region code and takes precedence over `region` and URL inference. For `search`, `profile`, and `shop`, defaults to `id` (Indonesia) when unspecified. Configured domain detection includes `sg`, `my`, `th`, `ph`, `vn`, `br`, `tw`, `mx`, `co`, and `cl`, though a recognized domain does not guarantee data for every region. `product_detail` usually reads the region from the product URL. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| shop_id | platform-native meaning |
| item_id | platform-native meaning |
| name | Name of the object itself, for account, product and business capabilities. |
| url | Link to the record on the platform. |
| description | Summary or description, usually shorter than text. |
| price | Price as a number without a currency symbol; see currency. For product detail (product_detail), a call that returns no price is not charged; the other fields still come back. |
| price_min | platform-native meaning |
| price_max | platform-native meaning |
| original_price | platform-native meaning |
| discount_pct | platform-native meaning |
| 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. |
| sold_count | platform-native meaning |
| stock | platform-native meaning |
| liked_count | platform-native meaning |
| view_count | Views or plays. null means not disclosed, not 0. |
| brand | platform-native meaning |
| is_pre_order | platform-native meaning |
| has_video | platform-native meaning |
| 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. |
| 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
