Shopee Product Detail
Retrieve one public Shopee listing from its direct product URL.
Required input
Pass exactly one productUrl. It must be an HTTPS URL on one of these hosts:
shopee.sg
shopee.co.id
shopee.com.my
shopee.ph
shopee.co.th
shopee.tw
shopee.vn
shopee.com.br
The URL path must end in -i.<numeric shopId>.<numeric itemId>. Canonical /product/<shopId>/<itemId> URLs are not supported.
Invocation
- Endpoint:
POST /api/v1/tools/research/shopee/product/detail
- Script:
python scripts/shopee_product_detail.py '<JSON params>' [--inline] [--no-cache]
- Full contract: read references/api.md before diagnosing validation or response errors.
- Testing instructions and evidence: see references/testing.md.
Example:
python scripts/shopee_product_detail.py '{"productUrl":"https://shopee.sg/example-i.9641401.29691169956"}'
Set NEXSCOPE_PROXY_BASE and NEXSCOPE_API_KEY. The script sends the request through the Nexscope research proxy, uses a 150-second timeout, caches identical parameters for 24 hours, and always writes the full response under <cwd>/nexscope/<date>/<session>/data/.
Do not reuse the source Skill's point value. This operation consumes Nexscope credits. Preserve X-Cost-Token and X-Cost-Credit from the response headers as server-reported billing metadata. The exact charge is unknown before the first live response.
Error and credit handling
- HTTP 401 means Nexscope authentication failed. Verify
NEXSCOPE_API_KEY and NEXSCOPE_PROXY_BASE; do not ask the user to paste credentials into chat or operation JSON.
- HTTP 402 means the account lacks credits. Stop the workflow and direct the user to the access-help page below.
- Marketplace authorization failures require the platform-specific account or token to be renewed. Do not substitute a different store, region, or creator automatically.
- For ambiguous network failures, report whether the attempted operation was a read or mutation. Never repeat a mutation without reconciling its upstream state.
Response handling
For the research HTTP response, require a numeric outer code equal to 0 before using data. Nonzero codes are platform failures; display outer msg without interpreting its wording as a retry instruction. Nexscope preserves upstream messages and translates Chinese to English; successful responses may have msg: null. HTTP 200 alone and nested business code / status do not replace the platform check. See references/api.md for response paths and task-specific states.
Authentication
Set the NEXSCOPE_API_KEY environment variable. If credentials are missing or expire, visit Nexscope external access help to top up credits.
Presenting results
- Lead with the listing name, item ID, shop, marketplace, current price, currency, stock, and public sold count.
- Preserve returned currencies and price values; do not convert them unless requested.
- Show SKU models and per-variant stock in a compact table when available.
- Show only a small useful selection of images.
- Treat Mall, official-shop, and verified-seller flags as separate signals.
- State clearly when descriptions, variants, inventory, sales, or other enrichment fields are absent.
Boundaries
- One listing per call; this is not a keyword-search or bulk-screening tool.
- Values are a current public snapshot, not historical data.
- Customer review rows are not returned; rating aggregates may be available.
- Field coverage varies by marketplace and listing state.
- Invalid, removed, mismatched, or unsupported listings return an error rather than an empty successful result.
- This skill does not manage an authorized Shopee seller account.
Privacy
Redact credentials, signed URLs, cookies, and internal account identifiers from user-facing output and saved request examples.
References
- Read references/api.md for the complete parameter, response, and error contract.
- Read references/testing.md before executing a live request or claiming a validation level.
API Key request rate
All Nexscope API Keys belonging to the same user share one request-rate allowance for public API execution. The allowance is measured over any rolling 1-second window. Your RPS depends on your account entitlements; do not assume every user has a fixed 1 RPS. A single Skill operation may make multiple public API requests, and each request uses this allowance.
If an execution request returns HTTP 429 with outer code 13012, the request-rate allowance was exceeded. Honor the returned Retry-After before considering another request. Outer code 13013 means the concurrent-request limit was exceeded, not the rate limit; honor its Retry-After when supplied. Inspect the response and reconcile state before retrying. Never automatically replay a write operation or a request whose outcome is unclear.
1---2name: ecommerce-shopee-product-detail3description: Retrieve the current public details of one Shopee listing from a supported product URL, including price, discount, sales, stock, variants, media, brand, category, shop, and rating data. Use when a user provides a Shopee product URL and asks for listing details, SKU variants, inventory, pricing, or competitor-page analysis. Do not use for keyword search, historical trends, reviews, or seller-account operations.4metadata:5 source: https://skillmd.com/skills/nexscope-ai/ecommerce-shopee-product-detail6---78# Shopee Product Detail910Retrieve one public Shopee listing from its direct product URL.1112## Required input1314Pass exactly one `productUrl`. It must be an HTTPS URL on one of these hosts:1516- `shopee.sg`17- `shopee.co.id`18- `shopee.com.my`19- `shopee.ph`20- `shopee.co.th`21- `shopee.tw`22- `shopee.vn`23- `shopee.com.br`2425The URL path must end in `-i.<numeric shopId>.<numeric itemId>`. Canonical `/product/<shopId>/<itemId>` URLs are not supported.2627## Invocation2829- Endpoint: `POST /api/v1/tools/research/shopee/product/detail`30- Script: `python scripts/shopee_product_detail.py '<JSON params>' [--inline] [--no-cache]`31- Full contract: read [references/api.md](references/api.md) before diagnosing validation or response errors.32- Testing instructions and evidence: see [references/testing.md](references/testing.md).3334Example:3536```bash37python scripts/shopee_product_detail.py '{"productUrl":"https://shopee.sg/example-i.9641401.29691169956"}'38```3940Set `NEXSCOPE_PROXY_BASE` and `NEXSCOPE_API_KEY`. The script sends the request through the Nexscope research proxy, uses a 150-second timeout, caches identical parameters for 24 hours, and always writes the full response under `<cwd>/nexscope/<date>/<session>/data/`.4142Do not reuse the source Skill's point value. This operation consumes Nexscope credits. Preserve `X-Cost-Token` and `X-Cost-Credit` from the response headers as server-reported billing metadata. The exact charge is unknown before the first live response.4344## Error and credit handling4546- HTTP 401 means Nexscope authentication failed. Verify `NEXSCOPE_API_KEY` and `NEXSCOPE_PROXY_BASE`; do not ask the user to paste credentials into chat or operation JSON.47- HTTP 402 means the account lacks credits. Stop the workflow and direct the user to the access-help page below.48- Marketplace authorization failures require the platform-specific account or token to be renewed. Do not substitute a different store, region, or creator automatically.49- For ambiguous network failures, report whether the attempted operation was a read or mutation. Never repeat a mutation without reconciling its upstream state.5051## Response handling5253For the research HTTP response, require a numeric outer `code` equal to `0` before using `data`. Nonzero codes are platform failures; display outer `msg` without interpreting its wording as a retry instruction. Nexscope preserves upstream messages and translates Chinese to English; successful responses may have `msg: null`. HTTP 200 alone and nested business `code` / `status` do not replace the platform check. See `references/api.md` for response paths and task-specific states.5455## Authentication5657Set the `NEXSCOPE_API_KEY` environment variable. If credentials are missing or expire, visit [Nexscope external access help](https://www.nexscope.ai/help/skills-external-access?co-from=skillNS) to top up credits.5859## Presenting results60611. Lead with the listing name, item ID, shop, marketplace, current price, currency, stock, and public sold count.622. Preserve returned currencies and price values; do not convert them unless requested.633. Show SKU models and per-variant stock in a compact table when available.644. Show only a small useful selection of images.655. Treat Mall, official-shop, and verified-seller flags as separate signals.666. State clearly when descriptions, variants, inventory, sales, or other enrichment fields are absent.6768## Boundaries6970- One listing per call; this is not a keyword-search or bulk-screening tool.71- Values are a current public snapshot, not historical data.72- Customer review rows are not returned; rating aggregates may be available.73- Field coverage varies by marketplace and listing state.74- Invalid, removed, mismatched, or unsupported listings return an error rather than an empty successful result.75- This skill does not manage an authorized Shopee seller account.7677## Privacy7879Redact credentials, signed URLs, cookies, and internal account identifiers from user-facing output and saved request examples.8081## References8283- Read [references/api.md](references/api.md) for the complete parameter, response, and error contract.84- Read [references/testing.md](references/testing.md) before executing a live request or claiming a validation level.8586## API Key request rate8788All Nexscope API Keys belonging to the same user share one request-rate allowance for public API execution. The allowance is measured over any rolling 1-second window. Your RPS depends on your account entitlements; do not assume every user has a fixed 1 RPS. A single Skill operation may make multiple public API requests, and each request uses this allowance.8990If an execution request returns HTTP 429 with outer code `13012`, the request-rate allowance was exceeded. Honor the returned `Retry-After` before considering another request. Outer code `13013` means the concurrent-request limit was exceeded, not the rate limit; honor its `Retry-After` when supplied. Inspect the response and reconcile state before retrying. Never automatically replay a write operation or a request whose outcome is unclear.