Shopee Item Search API (V1)
Search for Shopee items by keyword in the selected marketplace site. Supply a marketplace site and a keyword. Sample fields include currency codes and titles. Use it for catalog research or marketplace monitoring. Use the results to organize a research workflow and cross-check the relevant source records.
- Selected price
- $0.030769 / callPublished pricing
- Sellers / implementations
- 1 / 1
- Requests · 30d
- —Loading...
- Success rate · 30d
- —Loading...
| Seller | Pricing | Requests · 30d | Performance | Access |
|---|---|---|---|---|
justoneapiCurrent Shopee Item Search API (V1) · GET | $0.030769 / call | — | —successP50— |
Run sends a real API request. Charges follow the published API contract.
Response structure
codeintegerdataobjectcard_countintegercardsobject[]currencystringdisplay_model_idintegerdisplay_priceintegerimage_altstringimage_urlstringitem_idintegermodel_selection_logicintegerprice_textsstring[]shop_idintegersold_textnulltitlestring
marketstringqueryobjectkeywordstringlimitinteger
semanticsobjectauthoritative_inventory_includedbooleancomplete_sku_catalogbooleandisplay_price_includedbooleanidentity_levelstring
sitestring
messagenullrecordTimenull
// Inferred from response examples. Fields are optional and other fields may be returned.
export type ApiResponse = {
code?: number;
data?: {
card_count?: number;
cards?: Array<{
currency?: string;
display_model_id?: number;
display_price?: number;
image_alt?: string;
image_url?: string;
item_id?: number;
model_selection_logic?: number;
price_texts?: Array<string>;
shop_id?: number;
sold_text?: null;
title?: string;
}>;
market?: string;
query?: {
keyword?: string;
limit?: number;
};
semantics?: {
authoritative_inventory_included?: boolean;
complete_sku_catalog?: boolean;
display_price_included?: boolean;
identity_level?: string;
};
site?: string;
};
message?: null;
recordTime?: null;
};- Method
- GET
- Endpoint
https://api.openany.si/v1/agent-apis/justoneapi/api/shopee/search-item-list/v1- Content type
- application/json
- Authentication
Authorization: Bearer $OPENANY_API_KEY
curl \
'https://api.openany.si/v1/agent-apis/justoneapi/api/shopee/search-item-list/v1?keyword=%3CREPLACE_KEYWORD%3E&site=TW' \
-X GET \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json'Input parameters
Fields in this listing; additional options and input encoding can vary by provider.
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
site | URL query parametersquery | string | Yes | Shopee marketplace site.
Available Values:
- `TW`: Taiwan
- `ID`: Indonesia
- `TH`: Thailand enum: "TW", "ID", "TH" |
keyword | URL query parametersquery | string | Yes | Product search keyword. |
Required markers inside a nested object or variant apply when that object or variant is used.
Sample response
Sample response · Documented HTTP 200 Example from the provider's documentation. Field values in your results will differ.
{
"code": 0,
"data": {
"card_count": 20,
"cards": [
{
"currency": "TWD",
"display_model_id": 252378793352,
"display_price": 719,
"image_alt": "西雅圖咖啡 21公克 X 100入 好市多代購 一張訂單限下單一箱 即品拿鐵 咖啡 二合一 三合一 沖泡咖啡 MJB",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134201-820lg-muix5n37co3p0b",
"item_id": 24490004921,
"model_selection_logic": 3,
"price_texts": [
"$ 719"
],
"shop_id": 1280321358,
"sold_text": null,
"title": "西雅圖咖啡 21公克 X 100入 好市多代購 一張訂單限下單一箱 即品拿鐵 咖啡 二合一 三合一 沖泡咖啡 MJB"
},
{
"currency": "TWD",
"display_model_id": 295536462220,
"display_price": 200,
"image_alt": "限時優惠 左旋肉堿黑咖啡 黑咖啡 飽腹咖啡 能量咖啡 即溶咖啡 代餐咖啡 歡迎批發團購",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7ras9-m190tidh29lgc6",
"item_id": 29613806698,
"model_selection_logic": 3,
"price_texts": [
"$ 200"
],
"shop_id": 494578820,
"sold_text": null,
"title": "限時優惠 左旋肉堿黑咖啡 黑咖啡 飽腹咖啡 能量咖啡 即溶咖啡 代餐咖啡 歡迎批發團購"
},
{
"currency": "TWD",
"display_model_id": 311335106768,
"display_price": 310,
"image_alt": "【限時秒殺】星巴克門市專用款 咖啡豆2Kg 美式意式拿鐵阿拉比卡深度烘焙黑咖啡 可磨粉 咖啡豆 咖啡粉 coffee",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-820l5-mrljyzu8z8xu18",
"item_id": 47715623890,
"model_selection_logic": 3,
"price_texts": [
"$ 310",
"$ 788"
],
"shop_id": 1549801016,
"sold_text": null,
"title": "【限時秒殺】星巴克門市專用款 咖啡豆2Kg 美式意式拿鐵阿拉比卡深度烘焙黑咖啡 可磨粉 咖啡豆 咖啡粉 coffee"
},
{
"currency": "TWD",
"display_model_id": 315290811108,
"display_price": 655,
"image_alt": "「現貨」免運好市多Darling親愛的白咖啡三合一30g80入2027/11月",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-81ztg-mi69ge33wr2f04",
"item_id": 56903002476,
"model_selection_logic": 3,
"price_texts": [
"$ 655"
],
"shop_id": 301578636,
"sold_text": null,
"title": "「現貨」免運好市多Darling親愛的白咖啡三合一30g80入2027/11月"
},
{
"currency": "TWD",
"display_model_id": 435565417708,
"display_price": 499,
"image_alt": "西雅圖 即品拿鐵 二合一 三合一 咖啡 極品嚴焙大濾掛咖啡 約克夏奶茶 100入 每包21克《蝦皮&超商取貨只能一箱》",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7r98z-lwmrh4nbqhio6c",
"item_id": 25332346344,
"model_selection_logic": 3,
"price_texts": [
"$ 499",
"$ 625"
],
"shop_id": 1267498561,
"sold_text": null,
"title": "西雅圖 即品 拿鐵 二合一 三合一 咖啡 極品嚴焙大濾掛咖啡 約克夏奶茶 100入 每包21克《蝦皮&超商取貨只能一箱》"
},
{
"currency": "TWD",
"display_model_id": 335964199886,
"display_price": 710,
"image_alt": "100包,好市多代購,西雅圖 即品拿鐵 21公克 X 100入,三合一咖啡,二合一咖啡",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-820la-momtrzadsrnx8b",
"item_id": 47156289806,
"model_selection_logic": 3,
"price_texts": [
"$ 710"
],
"shop_id": 1747382869,
"sold_text": null,
"title": "100包,好市多代購,西雅圖 即品拿鐵 21公克 X 100入,三合一咖啡,二合一咖啡"
},
{
"currency": "TWD",
"display_model_id": 211038316018,
"display_price": 809,
"image_alt": "鮮一杯老舊金山 -原味拿鐵咖啡二合一(無加糖) 20g*100包(無盒裝).好市多COSTCO熱銷【里德Coffee】",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7r98y-lyq7k7mn483870",
"item_id": 17378081376,
"model_selection_logic": 3,
"price_texts": [
"$ 809"
],
"shop_id": 6304988,
"sold_text": null,
"title": "鮮一杯老舊金山 -原味拿鐵咖啡二合一(無加糖) 20g*100包(無盒裝).好市多COSTCO熱銷【里德Coffee】"
},
{
"currency": "TWD",
"display_model_id": 243895520317,
"display_price": 555,
"image_alt": "STARBUCKS (臺灣 24H✈️)特價 星巴克咖啡豆 黃金烘焙咖啡豆 早餐綜閤咖啡豆 包裝",
"image_url": "https://down-tw.img.susercontent.com/file/sg-11134201-824ha-meny6g8sytxgc7",
"item_id": 40319008417,
"model_selection_logic": 3,
"price_texts": [
"$ 555",
"$ 2,010"
],
"shop_id": 20874871,
"sold_text": null,
"title": "STARBUCKS (臺灣 24H✈️)特價 星巴克咖啡豆 黃金烘焙咖啡豆 早餐綜閤咖啡豆 包裝"
},
{
"currency": "TWD",
"display_model_id": 1488593088,
"display_price": 567,
"image_alt": "🍒免運折扣【品皇】 二合一金色大道(特濃)量販盒咖啡13公克(100包)",
"image_url": "https://down-tw.img.susercontent.com/file/9fe9536957e81bf7cb7ab15b43c8a361",
"item_id": 93373236,
"model_selection_logic": 3,
"price_texts": [
"$ 567",
"$ 600"
],
"shop_id": 9340289,
"sold_text": null,
"title": "🍒免運折扣【品皇】 二合一金色大道(特濃)量販盒咖啡13公克(100包)"
},
{
"currency": "TWD",
"display_model_id": 52474612952,
"display_price": 749,
"image_alt": "【現貨特價】西雅圖 無糖即品拿鐵 2合1 咖啡BARISTA 無加糖 Costco 好市多(每張單最多買2箱)",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-820l8-mrleiskwglc44e",
"item_id": 727800301,
"model_selection_logic": 3,
"price_texts": [
"$ 749",
"$ 829"
],
"shop_id": 3518189,
"sold_text": null,
"title": "【現貨特價】西雅圖 無糖即品拿鐵 2合1 咖啡BARISTA 無加糖 Costco 好市多(每張單最多買2箱)"
},
{
"currency": "TWD",
"display_model_id": 258860575108,
"display_price": 727,
"image_alt": "🔥好市多現貨免運特價到11/22🔥西雅圖 即品拿鐵三合一咖啡 21公克 X 100入",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134201-820lf-mujb6r3hh4w065",
"item_id": 43667593989,
"model_selection_logic": 3,
"price_texts": [
"$ 727"
],
"shop_id": 7984545,
"sold_text": null,
"title": "🔥好市多現貨免運特價到11/22🔥西雅圖 即品拿鐵三合一咖啡 21公克 X 100入"
},
{
"currency": "TWD",
"display_model_id": 197005003992,
"display_price": 700,
"image_alt": "100包,有原盒,好市多Costco代購,西雅圖 即品拿鐵 21公克 ,三合一拿鐵,二合一拿鐵,有糖拿鐵咖啡粉,無糖拿鐵",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-820lf-mpfgmluit1q9eb",
"item_id": 4987965156,
"model_selection_logic": 3,
"price_texts": [
"$ 700"
],
"shop_id": 22665083,
"sold_text": null,
"title": "100包,有原盒,好市多Costco代購,西雅圖 即品拿鐵 21公克 ,三合一拿鐵,二合一拿鐵,有糖拿鐵咖啡粉,無糖拿鐵"
},
{
"currency": "TWD",
"display_model_id": 215998663932,
"display_price": 725,
"image_alt": "[現貨/免運/開發票] 親愛的白咖啡 Darling White Coffee 糙米白咖啡 二合一 三 合一 卡布奇諾",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7rbk1-m8n5bg45vo9sd5",
"item_id": 29383665785,
"model_selection_logic": 3,
"price_texts": [
"$ 725"
],
"shop_id": 1424510,
"sold_text": null,
"title": "[現貨/免運/開發票] 親愛的白咖啡 Darling White Coffee 糙米白咖啡 二合一 三合一 卡布奇諾"
},
{
"currency": "TWD",
"display_model_id": 256273996203,
"display_price": 600,
"image_alt": "親愛的白咖啡 30gx80 有糖/無糖/有糖卡布奇諾/有糖糙米",
"image_url": "https://down-tw.img.susercontent.com/file/388cd7fd11d09166fbfed14c35c55066",
"item_id": 953301476,
"model_selection_logic": 3,
"price_texts": [
"$ 600"
],
"shop_id": 38497689,
"sold_text": null,
"title": "親愛的白咖啡 30gx80 有糖/無糖/有糖卡布奇諾/有糖糙米"
},
{
"currency": "TWD",
"display_model_id": 195781610957,
"display_price": 749,
"image_alt": "西雅圖大濾掛咖啡12g*50入",
"image_url": "https://down-tw.img.susercontent.com/file/1e4b2aa7f025cbf988e93c478a15a79b",
"item_id": 803395047,
"model_selection_logic": 3,
"price_texts": [
"$ 749"
],
"shop_id": 16765158,
"sold_text": null,
"title": "西雅圖大濾掛咖啡12g*50入"
},
{
"currency": "TWD",
"display_model_id": 175439977816,
"display_price": 300,
"image_alt": "🍒5送1【品皇】黃金咖啡2合1◆3合1咖啡經濟包38入🍒咖樂趣",
"image_url": "https://down-tw.img.susercontent.com/file/5e3c131c6dc72bef48b264cde25f1ef8",
"item_id": 80329268,
"model_selection_logic": 3,
"price_texts": [
"$ 300"
],
"shop_id": 9340289,
"sold_text": null,
"title": "🍒5送1【品皇】黃金咖啡2合1◆3合1咖啡經濟包38入🍒咖樂趣"
},
{
"currency": "TWD",
"display_model_id": 178797586918,
"display_price": 99,
"image_alt": "【台灣出貨 】白芸豆凍乾黑咖啡 益生菌速溶黑咖啡 速溶純黑 黑咖啡 速溶咖啡 拿鐵咖啡",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7qukz-lg0rxnvdk269b3",
"item_id": 18888118492,
"model_selection_logic": 3,
"price_texts": [
"$ 99",
"$ 158"
],
"shop_id": 322126933,
"sold_text": null,
"title": "【台灣出貨 】白芸豆凍乾黑咖啡 益生菌速溶黑咖啡 速溶純黑 黑咖啡 速溶咖啡 拿鐵咖啡"
},
{
"currency": "TWD",
"display_model_id": 195628731425,
"display_price": 725,
"image_alt": "西雅圖 即品拿鐵 21gX100入 極品拿鐵 三合一咖啡 西雅圖即品拿鐵 有糖",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7rase-m3lv6xgttfru46",
"item_id": 28820252134,
"model_selection_logic": 3,
"price_texts": [
"$ 725"
],
"shop_id": 2793015,
"sold_text": null,
"title": "西雅圖 即品拿鐵 21gX100入 極品拿鐵 三合一咖啡 西雅圖即品拿鐵 有糖"
},
{
"currency": "TWD",
"display_model_id": 128794952531,
"display_price": 469,
"image_alt": "-{泰菲印越} 越南 G7 三合一咖啡 咖啡 大包裝 16g*100入 (1單最多4包) (隔日到貨3包)",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7r990-loaq6ezesnk22d",
"item_id": 23586711076,
"model_selection_logic": 3,
"price_texts": [
"$ 469"
],
"shop_id": 261006724,
"sold_text": null,
"title": "-{泰菲印越} 越南 G7 三合一咖啡 咖啡 大包裝 16g*100入 (1單最多4包) (隔日到貨3包)"
},
{
"currency": "TWD",
"display_model_id": 236430864827,
"display_price": 370,
"image_alt": "【Costco好市多】 KIRKLAND SIGNATURE 科克蘭即溶咖啡粉 大包裝 454g (蝦皮代開電子發票)",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7r98t-lwe9syith0rq2d",
"item_id": 29352438301,
"model_selection_logic": 3,
"price_texts": [
"$ 370"
],
"shop_id": 1096473801,
"sold_text": null,
"title": "【Costco好市多】 KIRKLAND SIGNATURE 科克蘭即溶咖啡粉 大包裝 454g (蝦皮代開電子發票)"
}
],
"market": "Taiwan",
"query": {
"keyword": "coffee",
"limit": 20
},
"semantics": {
"authoritative_inventory_included": false,
"complete_sku_catalog": false,
"display_price_included": true,
"identity_level": "search_card_display_model"
},
"site": "TW"
},
"message": null,
"recordTime": null
}Agent integration
Copy the resource contract without sharing an API key.
View API Markdown
# Shopee Item Search API (V1)
Search for Shopee items by keyword in the selected marketplace site. Supply a marketplace site and a keyword. Sample fields include currency codes and titles. Use it for catalog research or marketplace monitoring. Use the results to organize a research workflow and cross-check the relevant source records.
## Available implementations
justoneapi · Shopee Item Search API (V1): https://openany.si/markets/apis/capabilities/shopee-item-search-api-v1?offering=d2cf9126-1f49-4cbb-8415-ee06345ba855 · $0.030769 / call
## Selected API contract
Documentation: https://openany.si/markets/apis/capabilities/shopee-item-search-api-v1
Method: GET
Endpoint: https://api.openany.si/v1/agent-apis/justoneapi/api/shopee/search-item-list/v1
Price: $0.030769 / call
Provider: justoneapi
Contract revision: 3
Price source: OpenAny public API contract and documented provider unit rates. Price update time: not supplied.
Use OPENANY_API_KEY from the environment. API Key calls use your shared balance.
## Prepared request
```bash
curl \
'https://api.openany.si/v1/agent-apis/justoneapi/api/shopee/search-item-list/v1?keyword=%3CREPLACE_KEYWORD%3E&site=TW' \
-X GET \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json'
```
## API contract
```json
{
"resource_type": "api",
"name": "Shopee Item Search API (V1)",
"endpoint": "https://api.openany.si/v1/agent-apis/justoneapi/api/shopee/search-item-list/v1",
"method": "GET",
"content_type": "none",
"execution_mode": "sync",
"authentication": {
"type": "bearer",
"environment_variable": "OPENANY_API_KEY"
},
"inputs": [
{
"description": "Shopee marketplace site.\n\nAvailable Values:\n- `TW`: Taiwan\n- `ID`: Indonesia\n- `TH`: Thailand",
"enum_values": [
"TW",
"ID",
"TH"
],
"location": "query",
"name": "site",
"nullable": false,
"required": true,
"type": "string"
},
{
"description": "Product search keyword.",
"location": "query",
"name": "keyword",
"nullable": false,
"required": true,
"type": "string"
}
],
"billing": {
"currency": "USD",
"mode": "fixed",
"priceMicroUsd": "30769",
"rounding": null,
"unit": "call",
"unitQuantity": null
},
"examples": [
{
"http_status": 200,
"name": "Official example · Historical response; independent request temp",
"request": {
"body": null,
"headers": {},
"path": {},
"query": {
"keyword": "<REPLACE_KEYWORD>",
"site": "TW"
}
},
"response_body": {
"code": 0,
"data": {
"card_count": 20,
"cards": [
{
"currency": "TWD",
"display_model_id": 252378793352,
"display_price": 719,
"image_alt": "西雅圖咖啡 21公克 X 100入 好市多代購 一張訂單限下單一箱 即品拿鐵 咖啡 二合一 三合一 沖泡咖啡 MJB",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134201-820lg-muix5n37co3p0b",
"item_id": 24490004921,
"model_selection_logic": 3,
"price_texts": [
"$ 719"
],
"shop_id": 1280321358,
"sold_text": null,
"title": "西雅圖咖啡 21公克 X 100入 好市多代購 一張訂單限下單一箱 即品拿鐵 咖啡 二合一 三合一 沖泡咖啡 MJB"
},
{
"currency": "TWD",
"display_model_id": 295536462220,
"display_price": 200,
"image_alt": "限時優惠 左旋肉堿黑咖啡 黑咖啡 飽腹咖啡 能量咖啡 即溶咖啡 代餐咖啡 歡迎批發團購",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7ras9-m190tidh29lgc6",
"item_id": 29613806698,
"model_selection_logic": 3,
"price_texts": [
"$ 200"
],
"shop_id": 494578820,
"sold_text": null,
"title": "限時優惠 左旋肉堿黑咖啡 黑咖啡 飽腹咖啡 能量咖啡 即溶咖啡 代餐咖啡 歡迎批發團購"
},
{
"currency": "TWD",
"display_model_id": 311335106768,
"display_price": 310,
"image_alt": "【限時秒殺】星巴克門市專用款 咖啡豆2Kg 美式意式拿鐵阿拉比卡深度烘焙黑咖啡 可磨粉 咖啡豆 咖啡粉 coffee",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-820l5-mrljyzu8z8xu18",
"item_id": 47715623890,
"model_selection_logic": 3,
"price_texts": [
"$ 310",
"$ 788"
],
"shop_id": 1549801016,
"sold_text": null,
"title": "【限時秒殺】星巴克門市專用款 咖啡豆2Kg 美式意式拿鐵阿拉比卡深度烘焙黑咖啡 可磨粉 咖啡豆 咖啡粉 coffee"
},
{
"currency": "TWD",
"display_model_id": 315290811108,
"display_price": 655,
"image_alt": "「現貨」免運好市多Darling親愛的白咖啡三合一30g80入2027/11月",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-81ztg-mi69ge33wr2f04",
"item_id": 56903002476,
"model_selection_logic": 3,
"price_texts": [
"$ 655"
],
"shop_id": 301578636,
"sold_text": null,
"title": "「現貨」免運好市多Darling親愛的白咖啡三合一30g80入2027/11月"
},
{
"currency": "TWD",
"display_model_id": 435565417708,
"display_price": 499,
"image_alt": "西雅圖 即品拿鐵 二合一 三合一 咖啡 極品嚴焙大濾掛咖啡 約克夏奶茶 100入 每包21克《蝦皮&超商取貨只能一箱》",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7r98z-lwmrh4nbqhio6c",
"item_id": 25332346344,
"model_selection_logic": 3,
"price_texts": [
"$ 499",
"$ 625"
],
"shop_id": 1267498561,
"sold_text": null,
"title": "西雅圖 即品拿鐵 二合一 三合一 咖啡 極品嚴焙大濾掛咖啡 約克夏奶茶 100入 每包21克《蝦皮&超商取貨只能一箱》"
},
{
"currency": "TWD",
"display_model_id": 335964199886,
"display_price": 710,
"image_alt": "100包,好市多代購,西雅圖 即品拿鐵 21公克 X 100入,三合一咖啡,二合一咖啡",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-820la-momtrzadsrnx8b",
"item_id": 47156289806,
"model_selection_logic": 3,
"price_texts": [
"$ 710"
],
"shop_id": 1747382869,
"sold_text": null,
"title": "100包,好市多代購,西雅圖 即品拿鐵 21公克 X 100入,三合一咖啡,二合一咖啡"
},
{
"currency": "TWD",
"display_model_id": 211038316018,
"display_price": 809,
"image_alt": "鮮一杯老舊金山 -原味拿鐵咖啡二合一(無加糖) 20g*100包(無盒裝).好市多COSTCO熱銷【里德Coffee】",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7r98y-lyq7k7mn483870",
"item_id": 17378081376,
"model_selection_logic": 3,
"price_texts": [
"$ 809"
],
"shop_id": 6304988,
"sold_text": null,
"title": "鮮一杯老舊金山 -原味拿鐵咖啡二合一(無加糖) 20g*100包(無盒裝).好市多COSTCO熱銷【里德Coffee】"
},
{
"currency": "TWD",
"display_model_id": 243895520317,
"display_price": 555,
"image_alt": "STARBUCKS (臺灣 24H✈️)特價 星巴克咖啡豆 黃金烘焙咖啡豆 早餐綜閤咖啡豆 包裝",
"image_url": "https://down-tw.img.susercontent.com/file/sg-11134201-824ha-meny6g8sytxgc7",
"item_id": 40319008417,
"model_selection_logic": 3,
"price_texts": [
"$ 555",
"$ 2,010"
],
"shop_id": 20874871,
"sold_text": null,
"title": "STARBUCKS (臺灣 24H✈️)特價 星巴克咖啡豆 黃金烘焙咖啡豆 早餐綜閤咖啡豆 包裝"
},
{
"currency": "TWD",
"display_model_id": 1488593088,
"display_price": 567,
"image_alt": "🍒免運折扣【品皇】 二合一金色大道(特濃)量販盒咖啡13公克(100包)",
"image_url": "https://down-tw.img.susercontent.com/file/9fe9536957e81bf7cb7ab15b43c8a361",
"item_id": 93373236,
"model_selection_logic": 3,
"price_texts": [
"$ 567",
"$ 600"
],
"shop_id": 9340289,
"sold_text": null,
"title": "🍒免運折扣【品皇】 二合一金色大道(特濃)量販盒咖啡13公克(100包)"
},
{
"currency": "TWD",
"display_model_id": 52474612952,
"display_price": 749,
"image_alt": "【現貨特價】西雅圖 無糖即品拿鐵 2合1 咖啡BARISTA 無加糖 Costco 好市多(每張單最多買2箱)",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-820l8-mrleiskwglc44e",
"item_id": 727800301,
"model_selection_logic": 3,
"price_texts": [
"$ 749",
"$ 829"
],
"shop_id": 3518189,
"sold_text": null,
"title": "【現貨特價】西雅圖 無糖即品拿鐵 2合1 咖啡BARISTA 無加糖 Costco 好市多(每張單最多買2箱)"
},
{
"currency": "TWD",
"display_model_id": 258860575108,
"display_price": 727,
"image_alt": "🔥好市多現貨免運特價到11/22🔥西雅圖 即品拿鐵三合一咖啡 21公克 X 100入",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134201-820lf-mujb6r3hh4w065",
"item_id": 43667593989,
"model_selection_logic": 3,
"price_texts": [
"$ 727"
],
"shop_id": 7984545,
"sold_text": null,
"title": "🔥好市多現貨免運特價到11/22🔥西雅圖 即品拿鐵三合一咖啡 21公克 X 100入"
},
{
"currency": "TWD",
"display_model_id": 197005003992,
"display_price": 700,
"image_alt": "100包,有原盒,好市多Costco代購,西雅圖 即品拿鐵 21公克 ,三合一拿鐵,二合一拿鐵,有糖拿鐵咖啡粉,無糖拿鐵",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-820lf-mpfgmluit1q9eb",
"item_id": 4987965156,
"model_selection_logic": 3,
"price_texts": [
"$ 700"
],
"shop_id": 22665083,
"sold_text": null,
"title": "100包,有原盒,好市多Costco代購,西雅圖 即品拿鐵 21公克 ,三合一拿鐵,二合一拿鐵,有糖拿鐵咖啡粉,無糖拿鐵"
},
{
"currency": "TWD",
"display_model_id": 215998663932,
"display_price": 725,
"image_alt": "[現貨/免運/開發票] 親愛的白咖啡 Darling White Coffee 糙米白咖啡 二合一 三合一 卡布奇諾",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7rbk1-m8n5bg45vo9sd5",
"item_id": 29383665785,
"model_selection_logic": 3,
"price_texts": [
"$ 725"
],
"shop_id": 1424510,
"sold_text": null,
"title": "[現貨/免運/開發票] 親愛的白咖啡 Darling White Coffee 糙米白咖啡 二合一 三合一 卡布奇諾"
},
{
"currency": "TWD",
"display_model_id": 256273996203,
"display_price": 600,
"image_alt": "親愛的白咖啡 30gx80 有糖/無糖/有糖卡布奇諾/有糖糙米",
"image_url": "https://down-tw.img.susercontent.com/file/388cd7fd11d09166fbfed14c35c55066",
"item_id": 953301476,
"model_selection_logic": 3,
"price_texts": [
"$ 600"
],
"shop_id": 38497689,
"sold_text": null,
"title": "親愛的白咖啡 30gx80 有糖/無糖/有糖卡布奇諾/有糖糙米"
},
{
"currency": "TWD",
"display_model_id": 195781610957,
"display_price": 749,
"image_alt": "西雅圖大濾掛咖啡12g*50入",
"image_url": "https://down-tw.img.susercontent.com/file/1e4b2aa7f025cbf988e93c478a15a79b",
"item_id": 803395047,
"model_selection_logic": 3,
"price_texts": [
"$ 749"
],
"shop_id": 16765158,
"sold_text": null,
"title": "西雅圖大濾掛咖啡12g*50入"
},
{
"currency": "TWD",
"display_model_id": 175439977816,
"display_price": 300,
"image_alt": "🍒5送1【品皇】黃金咖啡2合1◆3合1咖啡經濟包38入🍒咖樂趣",
"image_url": "https://down-tw.img.susercontent.com/file/5e3c131c6dc72bef48b264cde25f1ef8",
"item_id": 80329268,
"model_selection_logic": 3,
"price_texts": [
"$ 300"
],
"shop_id": 9340289,
"sold_text": null,
"title": "🍒5送1【品皇】黃金咖啡2合1◆3合1咖啡經濟包38入🍒咖樂趣"
},
{
"currency": "TWD",
"display_model_id": 178797586918,
"display_price": 99,
"image_alt": "【台灣出貨 】白芸豆凍乾黑咖啡 益生菌速溶黑咖啡 速溶純黑 黑咖啡 速溶咖啡 拿鐵咖啡",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7qukz-lg0rxnvdk269b3",
"item_id": 18888118492,
"model_selection_logic": 3,
"price_texts": [
"$ 99",
"$ 158"
],
"shop_id": 322126933,
"sold_text": null,
"title": "【台灣出貨 】白芸豆凍乾黑咖啡 益生菌速溶黑咖啡 速溶純黑 黑咖啡 速溶咖啡 拿鐵咖啡"
},
{
"currency": "TWD",
"display_model_id": 195628731425,
"display_price": 725,
"image_alt": "西雅圖 即品拿鐵 21gX100入 極品拿鐵 三合一咖啡 西雅圖即品拿鐵 有糖",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7rase-m3lv6xgttfru46",
"item_id": 28820252134,
"model_selection_logic": 3,
"price_texts": [
"$ 725"
],
"shop_id": 2793015,
"sold_text": null,
"title": "西雅圖 即品拿鐵 21gX100入 極品拿鐵 三合一咖啡 西雅圖即品拿鐵 有糖"
},
{
"currency": "TWD",
"display_model_id": 128794952531,
"display_price": 469,
"image_alt": "-{泰菲印越} 越南 G7 三合一咖啡 咖啡 大包裝 16g*100入 (1單最多4包) (隔日到貨3包)",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7r990-loaq6ezesnk22d",
"item_id": 23586711076,
"model_selection_logic": 3,
"price_texts": [
"$ 469"
],
"shop_id": 261006724,
"sold_text": null,
"title": "-{泰菲印越} 越南 G7 三合一咖啡 咖啡 大包裝 16g*100入 (1單最多4包) (隔日到貨3包)"
},
{
"currency": "TWD",
"display_model_id": 236430864827,
"display_price": 370,
"image_alt": "【Costco好市多】 KIRKLAND SIGNATURE 科克蘭即溶咖啡粉 大包裝 454g (蝦皮代開電子發票)",
"image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7r98t-lwe9syith0rq2d",
"item_id": 29352438301,
"model_selection_logic": 3,
"price_texts": [
"$ 370"
],
"shop_id": 1096473801,
"sold_text": null,
"title": "【Costco好市多】 KIRKLAND SIGNATURE 科克蘭即溶咖啡粉 大包裝 454g (蝦皮代開電子發票)"
}
],
"market": "Taiwan",
"query": {
"keyword": "coffee",
"limit": 20
},
"semantics": {
"authoritative_inventory_included": false,
"complete_sku_catalog": false,
"display_price_included": true,
"identity_level": "search_card_display_model"
},
"site": "TW"
},
"message": null,
"recordTime": null
}
}
]
}
```Error handling
| Status | Next step |
|---|---|
400 | Check the offering and request fields. |
401 / 403 | Verify your credentials and access permissions. |
402 | Inspect the selected access mode and returned payment requirements. |
429 | Respect the returned rate limit and retry guidance. |
5xx | Inspect the error and usage record before retrying a paid operation. |
Official example · Historical response; independent request temp
Example from the provider's documentation. Field values in your results will differ.
Prepare your environment
Use a terminal with cURL installed.
Use an OpenAny API key with shared-balance access. Confirm availability and price before running; a call may charge your balance.
Set the key in your terminal using the hidden prompt below. Keep its value out of source files and logs.
Terminal · macOS / Linuxprintf 'OpenAny API key: ' read -r -s OPENANY_API_KEY export OPENANY_API_KEY printf '\n'Run the request
Paste the complete command below into your terminal.
Values to replace before running 2
Review these request fields before running. Keep the published provider and request method unchanged.
site- Shopee marketplace site. Available Values: - `TW`: Taiwan - `ID`: Indonesia - `TH`: Thailand
keyword- Product search keyword.
Terminal · cURLcurl \ 'https://api.openany.si/v1/agent-apis/justoneapi/api/shopee/search-item-list/v1?keyword=%3CREPLACE_KEYWORD%3E&site=TW' \ -X GET \ -H "Authorization: Bearer $OPENANY_API_KEY" \ -H 'Content-Type: application/json'Check the response
Sample response · Documented HTTP 200
Sample response{ "code": 0, "data": { "card_count": 20, "cards": [ { "currency": "TWD", "display_model_id": 252378793352, "display_price": 719, "image_alt": "西雅圖咖啡 21公克 X 100入 好市多代購 一張訂單限下單一箱 即品拿鐵 咖啡 二合一 三合一 沖泡咖啡 MJB", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134201-820lg-muix5n37co3p0b", "item_id": 24490004921, "model_selection_logic": 3, "price_texts": [ "$ 719" ], "shop_id": 1280321358, "sold_text": null, "title": "西雅圖咖啡 21公克 X 100入 好市多代購 一張訂 單限下單一箱 即品拿鐵 咖啡 二合一 三合一 沖泡咖啡 MJB" }, { "currency": "TWD", "display_model_id": 295536462220, "display_price": 200, "image_alt": "限時優惠 左旋肉堿黑咖啡 黑咖啡 飽腹咖啡 能量咖啡 即溶咖啡 代餐咖啡 歡迎批發團購", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7ras9-m190tidh29lgc6", "item_id": 29613806698, "model_selection_logic": 3, "price_texts": [ "$ 200" ], "shop_id": 494578820, "sold_text": null, "title": "限時優惠 左旋肉堿黑咖啡 黑咖啡 飽腹咖啡 能量咖啡 即溶咖啡 代餐咖啡 歡迎批發團購" }, { "currency": "TWD", "display_model_id": 311335106768, "display_price": 310, "image_alt": "【限時秒殺】星巴克門市專用款 咖啡豆2Kg 美式意式拿鐵阿拉比卡深度烘焙黑咖啡 可磨粉 咖啡豆 咖啡粉 coffee", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-820l5-mrljyzu8z8xu18", "item_id": 47715623890, "model_selection_logic": 3, "price_texts": [ "$ 310", "$ 788" ], "shop_id": 1549801016, "sold_text": null, "title": "【限時秒殺】星巴克門市專用款 咖啡豆2Kg 美式意式拿鐵阿拉比卡深度烘焙黑咖啡 可磨粉 咖啡豆 咖啡粉 coffee" }, { "currency": "TWD", "display_model_id": 315290811108, "display_price": 655, "image_alt": "「現貨」免運好市多Darling親愛的白咖啡三合一30g80入2027/11月", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-81ztg-mi69ge33wr2f04", "item_id": 56903002476, "model_selection_logic": 3, "price_texts": [ "$ 655" ], "shop_id": 301578636, "sold_text": null, "title": "「現貨」免運好市多Darling親愛的白咖啡三合一30g80入2027/11月" }, { "currency": "TWD", "display_model_id": 435565417708, "display_price": 499, "image_alt": "西雅圖 即品拿鐵 二合一 三合一 咖啡 極品嚴焙大濾掛咖啡 約克夏奶茶 100入 每包21克《蝦皮&超商取貨只能一箱》", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7r98z-lwmrh4nbqhio6c", "item_id": 25332346344, "model_selection_logic": 3, "price_texts": [ "$ 499", "$ 625" ], "shop_id": 1267498561, "sold_text": null, "title": "西雅圖 即品拿鐵 二合一 三合一 咖啡 極品嚴焙大濾掛咖啡 約克夏奶茶 100入 每包21克《蝦皮&超商取貨只能一箱》" }, { "currency": "TWD", "display_model_id": 335964199886, "display_price": 710, "image_alt": "100包,好市多代購,西雅圖 即品拿鐵 21公克 X 100入,三合一咖啡,二合一咖啡", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-820la-momtrzadsrnx8b", "item_id": 47156289806, "model_selection_logic": 3, "price_texts": [ "$ 710" ], "shop_id": 1747382869, "sold_text": null, "title": "100包,好市多代購,西雅圖 即品拿鐵 21公克 X 100入,三合一咖啡,二合一咖啡" }, { "currency": "TWD", "display_model_id": 211038316018, "display_price": 809, "image_alt": "鮮一杯老舊金山 -原味拿鐵咖啡二合一(無加糖) 20g*100包(無盒裝).好市多COSTCO熱銷【里德Coffee】", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7r98y-lyq7k7mn483870", "item_id": 17378081376, "model_selection_logic": 3, "price_texts": [ "$ 809" ], "shop_id": 6304988, "sold_text": null, "title": "鮮一杯老舊金山 -原味拿鐵咖啡二合一(無加糖) 20g*100包(無盒裝).好市多COSTCO熱銷【里德Coffee】" }, { "currency": "TWD", "display_model_id": 243895520317, "display_price": 555, "image_alt": "STARBUCKS (臺灣 24H✈️)特價 星巴克咖啡豆 黃金烘焙咖啡豆 早餐綜閤咖啡豆 包裝", "image_url": "https://down-tw.img.susercontent.com/file/sg-11134201-824ha-meny6g8sytxgc7", "item_id": 40319008417, "model_selection_logic": 3, "price_texts": [ "$ 555", "$ 2,010" ], "shop_id": 20874871, "sold_text": null, "title": "STARBUCKS (臺灣 24H✈️)特價 星巴克咖啡豆 黃金烘焙咖啡豆 早餐綜閤咖啡豆 包裝" }, { "currency": "TWD", "display_model_id": 1488593088, "display_price": 567, "image_alt": "🍒免運折扣【品皇】 二合一金色大道(特濃)量販盒咖 啡13公克(100包)", "image_url": "https://down-tw.img.susercontent.com/file/9fe9536957e81bf7cb7ab15b43c8a361", "item_id": 93373236, "model_selection_logic": 3, "price_texts": [ "$ 567", "$ 600" ], "shop_id": 9340289, "sold_text": null, "title": "🍒免運折扣【品皇】 二合一金色大道(特濃)量販盒咖啡13公克(100包)" }, { "currency": "TWD", "display_model_id": 52474612952, "display_price": 749, "image_alt": "【現貨特價】西雅圖 無糖即品拿鐵 2合1 咖啡BARISTA 無加糖 Costco 好市多(每張單最多買2箱)", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-820l8-mrleiskwglc44e", "item_id": 727800301, "model_selection_logic": 3, "price_texts": [ "$ 749", "$ 829" ], "shop_id": 3518189, "sold_text": null, "title": "【現貨特價】西雅圖 無糖即品拿鐵 2合1 咖啡BARISTA 無加糖 Costco 好市多(每張單最多買2箱)" }, { "currency": "TWD", "display_model_id": 258860575108, "display_price": 727, "image_alt": "🔥好市多現貨免運特價到11/22🔥西雅圖 即品拿鐵三合一咖啡 21公克 X 100入", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134201-820lf-mujb6r3hh4w065", "item_id": 43667593989, "model_selection_logic": 3, "price_texts": [ "$ 727" ], "shop_id": 7984545, "sold_text": null, "title": "🔥好市多現貨免運特價到11/22🔥西雅圖 即品拿鐵三合一咖啡 21公克 X 100入" }, { "currency": "TWD", "display_model_id": 197005003992, "display_price": 700, "image_alt": "100包,有原盒,好市多Costco代購,西雅圖 即品拿鐵 21公克 ,三合一拿鐵,二合一拿鐵,有糖拿鐵咖啡粉,無糖拿鐵", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-820lf-mpfgmluit1q9eb", "item_id": 4987965156, "model_selection_logic": 3, "price_texts": [ "$ 700" ], "shop_id": 22665083, "sold_text": null, "title": "100包,有原盒,好市多Costco代購,西雅圖 即品拿鐵 21公克 ,三合一拿鐵,二合一拿鐵,有糖拿鐵咖啡粉,無糖拿鐵" }, { "currency": "TWD", "display_model_id": 215998663932, "display_price": 725, "image_alt": "[現貨/免運/開發票] 親愛的白咖啡 Darling White Coffee 糙米白咖啡 二合一 三合一 卡布奇諾", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7rbk1-m8n5bg45vo9sd5", "item_id": 29383665785, "model_selection_logic": 3, "price_texts": [ "$ 725" ], "shop_id": 1424510, "sold_text": null, "title": "[現貨/免運/開發票] 親愛的白咖啡 Darling White Coffee 糙米白咖啡 二合一 三合一 卡布奇諾" }, { "currency": "TWD", "display_model_id": 256273996203, "display_price": 600, "image_alt": "親愛的白咖啡 30gx80 有糖/無糖/有糖卡布奇諾/有糖糙米", "image_url": "https://down-tw.img.susercontent.com/file/388cd7fd11d09166fbfed14c35c55066", "item_id": 953301476, "model_selection_logic": 3, "price_texts": [ "$ 600" ], "shop_id": 38497689, "sold_text": null, "title": "親愛的白咖啡 30gx80 有糖/無糖/有糖卡布奇諾/有糖糙米" }, { "currency": "TWD", "display_model_id": 195781610957, "display_price": 749, "image_alt": "西雅圖大濾掛咖啡12g*50入", "image_url": "https://down-tw.img.susercontent.com/file/1e4b2aa7f025cbf988e93c478a15a79b", "item_id": 803395047, "model_selection_logic": 3, "price_texts": [ "$ 749" ], "shop_id": 16765158, "sold_text": null, "title": "西雅圖大濾掛咖啡12g*50入" }, { "currency": "TWD", "display_model_id": 175439977816, "display_price": 300, "image_alt": "🍒5送1【品皇】黃金咖啡2合1◆3合1咖啡經濟包38入🍒咖樂趣", "image_url": "https://down-tw.img.susercontent.com/file/5e3c131c6dc72bef48b264cde25f1ef8", "item_id": 80329268, "model_selection_logic": 3, "price_texts": [ "$ 300" ], "shop_id": 9340289, "sold_text": null, "title": "🍒5送1【品皇】黃金咖啡2合1◆3合1咖啡經濟包38入🍒咖樂趣" }, { "currency": "TWD", "display_model_id": 178797586918, "display_price": 99, "image_alt": "【台灣出貨 】白芸豆凍乾黑咖啡 益生菌速溶黑咖啡 速溶純黑 黑咖啡 速溶咖啡 拿鐵咖啡", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7qukz-lg0rxnvdk269b3", "item_id": 18888118492, "model_selection_logic": 3, "price_texts": [ "$ 99", "$ 158" ], "shop_id": 322126933, "sold_text": null, "title": "【台灣出貨 】白芸豆凍乾黑咖啡 益生菌速溶黑咖啡 速溶純黑 黑咖啡 速溶咖啡 拿鐵咖啡" }, { "currency": "TWD", "display_model_id": 195628731425, "display_price": 725, "image_alt": "西雅圖 即品拿鐵 21gX100入 極品拿鐵 三合一咖啡 西雅圖即品拿鐵 有糖", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7rase-m3lv6xgttfru46", "item_id": 28820252134, "model_selection_logic": 3, "price_texts": [ "$ 725" ], "shop_id": 2793015, "sold_text": null, "title": "西雅圖 即品拿鐵 21gX100入 極品拿鐵 三合一咖啡 西雅圖即品拿鐵 有糖" }, { "currency": "TWD", "display_model_id": 128794952531, "display_price": 469, "image_alt": "-{泰菲印越} 越南 G7 三合一咖啡 咖啡 大包裝 16g*100入 (1單最多4包) (隔日到貨3包)", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7r990-loaq6ezesnk22d", "item_id": 23586711076, "model_selection_logic": 3, "price_texts": [ "$ 469" ], "shop_id": 261006724, "sold_text": null, "title": "-{泰菲印越} 越南 G7 三合一咖啡 咖啡 大包裝 16g*100入 (1單最多4包) (隔日到貨3包)" }, { "currency": "TWD", "display_model_id": 236430864827, "display_price": 370, "image_alt": "【Costco好市多】 KIRKLAND SIGNATURE 科克 蘭即溶咖啡粉 大包裝 454g (蝦皮代開電子發票)", "image_url": "https://down-tw.img.susercontent.com/file/tw-11134207-7r98t-lwe9syith0rq2d", "item_id": 29352438301, "model_selection_logic": 3, "price_texts": [ "$ 370" ], "shop_id": 1096473801, "sold_text": null, "title": "【Costco好市多】 KIRKLAND SIGNATURE 科克蘭即溶咖啡粉 大包裝 454g (蝦皮代開電子發票)" } ], "market": "Taiwan", "query": { "keyword": "coffee", "limit": 20 }, "semantics": { "authoritative_inventory_included": false, "complete_sku_catalog": false, "display_price_included": true, "identity_level": "search_card_display_model" }, "site": "TW" }, "message": null, "recordTime": null }
Common questions
Do I need a separate key for every provider?
Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.
Are these providers interchangeable?
No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.
How is this API billed?
API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.
Where do the price and contract come from?
The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.
How do OpenAny Balance and x402 differ?
OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.
Does Playground send a paid request?
Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.
Use Shopee Item Search API (V1) with your agent
Inspect endpoint contracts and confirm availability and pricing before a paid call.