Scope
Product search, product detail, site lookup, category lookup, supply price, inventory, sales, revenue, ratings, and recent trend fields.
Public-market research only. It does not access or modify a Temu seller account.
Read references/api.md for the authoritative source-derived request and response contract.
Operations
| Script | Nexscope route |
|---|---|
geekbi_temu_category_list.py |
POST /api/v1/tools/research/geekbi/temu/categoryList |
geekbi_temu_goods_detail.py |
POST /api/v1/tools/research/geekbi/temu/goodsDetail |
geekbi_temu_goods_search.py |
POST /api/v1/tools/research/geekbi/temu/goodsSearch |
geekbi_temu_site_list.py |
POST /api/v1/tools/research/geekbi/temu/siteList |
Authentication and safety
- Set
NEXSCOPE_PROXY_BASEandNEXSCOPE_API_KEY. Send the Nexscope key asAuthorization: Bearer <key>. - No marketplace account authorization is required; these operations read public-market data.
- Provider credentials and upstream tokens remain backend-owned. Never accept, print, or persist them.
- Treat HTTP 401 as Nexscope authentication failure and HTTP 402 as insufficient Nexscope credits.
- Do not substitute another account, market, region, creator, product, or operation after an authorization or ambiguous network failure.
- This operation consumes credits. Preserve
X-Cost-TokenandX-Cost-Creditfrom response headers as server-reported billing metadata.
Workflow
- Identify the exact operation, market/account context, filters, dates, pagination, and requested output.
- Validate required fields, types, enums, ranges, and operation-specific limits against
references/api.mdbefore any request. - Explain that additional pages, markets, or operations may consume more credits and obtain approval before a paid call.
- Run only the selected entry script, for example:
python scripts/geekbi_temu_category_list.py '<JSON parameters>' --no-cachewhen the script supports that flag. - Preserve the full response under
nexscope/<date>/<session>/data; return a concise summary and the saved path. - On an ambiguous timeout or upstream failure, do not retry automatically. Report the trace ID and reconcile state first.
Output rules
- Distinguish the Nexscope transport envelope from the nested business response.
- Report only returned facts. Preserve absent values as unknown and keep provider-specific metric definitions intact.
- Never expose API keys, provider tokens, presigned URL query strings, internal account records, or raw secrets.
- Do not submit feedback or make any unrelated external mutation unless the user explicitly requests it.
Authentication
Set the NEXSCOPE_API_KEY environment variable. If credentials are missing or expire, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to top up credits.