momo購物網 (momoshop) API & Scraper
momo購物網 (momoshop.com.tw) is Taiwan's largest B2C online store.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
This API reads it as JSON. `search` takes Traditional Chinese or English words with momo's own filters (search category, brand id, price range, fast delivery, coupon, in stock, 0% instalments, convenience-store pickup or payment, TV shopping, video, instant discount, cash on delivery, chilled delivery, subscription, large-appliance delivery, ship-from) and seven sorts, and returns per product: code, title, the headline price and the struck market price (市售價) in TWD, total stock, rating and rating count, momo's sales band, the fast-delivery mark, coupon and gift flags, whether momo or a third-party shop sells it, and paid placements kept apart. `category` lists a momo category page. `product` returns one product in full: every price the page prints with its label (促銷價, 市售價, and 限時折後價 during a time-limited discount), every variant with its own stock and delivery promise, delivery options with fees and free-shipping thresholds, payment methods, warranty, gifts, the category path, the spec table and description, and for third-party listings the shop's name, rating, reply rate and defect rate. `reviews` returns the reviews with the average and the count per star.
What a momoshop field actually contains
Fields that read differently from how they look. Every row was measured against live momoshop.com.tw pages on 2026-10-14.
| Field | What it holds |
|---|---|
| product_id | momo's product code, a string: digits for items momo sells itself (13414517), TP plus 14 digits for third-party shops (TP00042480000305). Pass it unchanged to product and reviews; a product URL works too. Search to product returned the same code on 29 of 29 rows. |
| price, list_price | price is the headline price momo shows; list_price is the struck 市售價, given only when it is above the price (momo's product page does not print an equal one). The card price matched the product page on 29 of 29 products, and the product page matched momo's own structured data on 24 of 24. |
| prices.price_label, promo_price | During a time-limited discount the headline is 限時折後價 and the promotion price moves aside: one Xiaomi earbud showed 473 after the discount, 促銷價 599, 市售價 999, with the rule 滿1件享79折 in the subtitle. |
| stock (search) | The card's stock is the product's total stock; it equals the sum of the variants on the product page (14 = 5+3+3+3; 3,923 across four colours). |
| variants[].stock, stock_capped | For items momo sells itself, a variant shows at most 10 or 20 units; stock_capped is true when it sits exactly at one of those, and the real stock may be higher. Third-party variants are not capped. |
| category_path vs search_category_code | momo runs two category trees. category_path is the shop tree from the breadcrumb (4200000000 3C週邊 …) and is what the category action takes; search_category_code is the search tree (1100700011) and is what search's category filter takes. |
| rating_count | Exact on search rows (49,342). On product and reviews momo writes large counts rounded (4.9萬 = about 49,000); the text is given next to the number and an _is_approx flag says when it was rounded. |
| seller | Third-party listings only: the shop's name, rating out of 5, reply rate, defect rate and product count, as momo shows them on the product page. |
All prices are New Taiwan dollars (TWD). Prices, stock and delivery promises were identical when read from inside and outside Taiwan (30 of 30 search rows, 5 of 5 products).
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/momoshop/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "耳機"
}
}{
"ok": true,
"meta": {
"api": "momoshop",
"endpoint": "search",
"mode": "live",
"latency_ms": 1428.6,
"record_count": 24,
"bytes": 155571,
"cache_hit": false,
"total": 16489,
"ads_count": 6,
"tiles_dropped": 0,
"total_known": true,
"pagination": {
"page": 1,
"total_pages": 550,
"has_more": true
},
"price_basis": "TWD, momo's displayed price (tax included)",
"upstream_requests": 1,
"charged_credits": 2,
"version": "0.1.0",
"request_id": "c3e4dba50db74a5e",
"queue_ms": 1.1,
"fetched_at": "2026-10-14T18:57:28.492Z"
},
"data": {
"query": "耳機",
"sort": "relevance",
"page": 1,
"total": 16489,
"total_pages": 550,
"has_more": true,
"results": [
{
"product_id": "9399625",
"title": "【JLab】Go POP +真無線藍牙耳機(Type-C 專屬APP 快速連線 續航力強)",
"subtitle": "CP值再升級百美元內銷售冠軍",
"url": "https://www.momoshop.com.tw/product/9399625",
"image": "https://img3.momoshop.com.tw/goodsimg/0009/399/625/9399625_OL.jpg?t=1743486315",
"title_brand": "JLab",
"price": 799,
"list_price": 1180,
"price_note": null,
"currency": "TWD",
"stock": 323,
"is_sold_out": false,
"rating": 4.8,
"rating_count": 2486,
"total_sales_text": "總銷量>3萬",
"total_sales_min": 30000,
"fast_delivery": true,
"icons": [
"速",
"折價券",
"登記"
],
"has_coupon": true,
"has_gift": false,
"instant_discount": false,
"adult_only": false,
"on_sale_from": null,
"seller_type": "momo",
"is_ad": false
},
{
"product_id": "11700821",
"title": "【Havit 海威特】環繞立體音高續航耳罩式藍芽耳機H630BT(55H高續航/高回彈氣墊/4種聆聽模式/舒適配戴)",
"subtitle": "滿1件折476",
"url": "https://www.momoshop.com.tw/product/11700821",
"image": "https://img3.momoshop.com.tw/goodsimg/0011/700/821/11700821_OL.jpg?t=1725331700",
"title_brand": "Havit 海威特",
"price": 999,
"list_price": 2499,
"price_note": null,
"currency": "TWD",
"stock": 245,
"is_sold_out": false,
"rating": 4.8,
"rating_count": 1730,
"total_sales_text": "總銷量>1萬",
"total_sales_min": 10000,
"fast_delivery": true,
"icons": [
"速",
"折價券",
"登記"
],
"has_coupon": true,
"has_gift": false,
"instant_discount": true,
"adult_only": false,
"on_sale_from": null,
"seller_type": "momo",
"is_ad": false
},
{
"product_id": "11115416",
"title": "【DA】Air Pro 6無感配戴夾耳式藍芽耳機(HiFi音質/超長續航30小時/夾式耳機/氣傳導/無線)",
"subtitle": "滿1件享83折",
"url": "https://www.momoshop.com.tw/product/11115416",
"image": "https://img3.momoshop.com.tw/goodsimg/0011/115/416/11115416_OL.jpg?t=1718687006",
"title_brand": "DA",
"price": 904,
"list_price": 4980,
"price_note": null,
"currency": "TWD",
"stock": 1738,
"is_sold_out": false,
"rating": 4.7,
"rating_count": 1386,
"total_sales_text": "總銷量>1萬",
"total_sales_min": 10000,
"fast_delivery": true,
"icons": [
"速",
"折價券",
"登記"
],
"has_coupon": true,
"has_gift": false,
"instant_discount": true,
"adult_only": false,
"on_sale_from": null,
"seller_type": "momo",
"is_ad": false
}
],
"ads": [
{
"product_id": "TP00021310000596",
"title": "【JV3C】BH03AE 真無線降噪耳機 ANC 主動式降噪 ENC 降噪 HIFI音質 藍牙耳機 藍芽耳機 無線耳機",
"subtitle": "雙重降噪技術 附一年保固",
"url": "https://www.momoshop.com.tw/TP/TP0002131/goodsDetail/TP00021310000596",
"image": "https://i5.momoshop.com.tw/1791294298/goodsimg/TP000/2131/0000/596/TP00021310000596_O_m.jpg",
"title_brand": "JV3C",
"price": 550,
"list_price": null,
"price_note": null,
"currency": "TWD",
"stock": 4429,
"is_sold_out": false,
"rating": 4.8,
"rating_count": 694,
"total_sales_text": "總銷量>3,000",
"total_sales_min": 3000,
"fast_delivery": false,
"icons": [
"跨店折",
"折價券",
"登記"
],
"has_coupon": true,
"has_gift": false,
"instant_discount": false,
"adult_only": false,
"on_sale_from": null,
"seller_type": "third_party",
"is_ad": true
},
{
"product_id": "12797351",
"title": "【Marshall】Minor IV 真無線藍芽耳機 第四代(經典黑)",
"subtitle": "台灣公司貨18個月保固非水貨",
"url": "https://www.momoshop.com.tw/product/12797351",
"image": "https://img3.momoshop.com.tw/goodsimg/0012/797/351/12797351_OL.jpg?t=1722221701",
"title_brand": "Marshall",
"price": 3990,
"list_price": null,
"price_note": null,
"currency": "TWD",
"stock": 6,
"is_sold_out": false,
"rating": null,
"rating_count": null,
"total_sales_text": "總銷量>3,000",
"total_sales_min": 3000,
"fast_delivery": true,
"icons": [
"速",
"折價券",
"登記"
],
"has_coupon": true,
"has_gift": false,
"instant_discount": false,
"adult_only": false,
"on_sale_from": null,
"seller_type": "momo",
"is_ad": true
},
{
"product_id": "15085749",
"title": "【KINYO】藍牙5.4 雙降噪AI智慧藍牙耳機 (BTE-A021)",
"subtitle": "跨語言溝通/聽音樂/通電話",
"url": "https://www.momoshop.com.tw/product/15085749",
"image": "https://img3.momoshop.com.tw/goodsimg/0015/085/749/15085749_OL.jpg?t=1789645946",
"title_brand": "KINYO",
"price": 899,
"list_price": 1090,
"price_note": null,
"currency": "TWD",
"stock": 18,
"is_sold_out": false,
"rating": null,
"rating_count": null,
"total_sales_text": "總銷量>50",
"total_sales_min": 50,
"fast_delivery": true,
"icons": [
"速",
"折價券",
"登記"
],
"has_coupon": true,
"has_gift": false,
"instant_discount": false,
"adult_only": false,
"on_sale_from": null,
"seller_type": "momo",
"is_ad": true
}
],
"facets": {
"categories": [
{
"code": "1100000000",
"name": "手機",
"count": 10204
},
{
"code": "1200000000",
"name": "資訊電腦",
"count": 2043
},
{
"code": "2000000000",
"name": "鞋/包/箱",
"count": 890
}
],
"brands": [
{
"name": "Apple",
"brand_id": "20160808155618011",
"count": 100
},
{
"name": "SONY 索尼",
"brand_id": "20160808155934745",
"count": 440
},
{
"name": "Anker soundcore",
"brand_id": "20220126125607909",
"count": 42
}
]
}
}
}What the momo購物網 (momoshop) API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Keyword search on momoshop.com.tw. Each row carries the headline price and the struck 市售價, total stock, rating and rating count, the source's sales band (總銷量>1,000), the fast-delivery mark, coupon / gift / instant-discount flags and whether momo or a third-party shop sells it; paid placements are kept apart in `ads`. Filters: search category, brand id, price range, fast delivery, coupon, in stock, 0% instalments, convenience-store pickup or payment, TV shopping, video, instant discount, cash on delivery, chilled delivery, subscription, large-appliance delivery, ship-from; seven sorts. Every filter was measured against the unfiltered total; ones the site ignores are not offered. Facets (search categories and brands with counts) come with every answer. | Pricing teams call search to get keyword search on momoshop.com.tw. | query, category, brand_id, min_price, max_price, ... |
| category | Every product of one momo shop category (the category pages of momoshop.com.tw), 20 per page, with the same row shape as `search`, the category's breadcrumb and its brand list with counts. Takes the shop-tree code from a product's `category_path[].code` (e.g. `4201700090` 真無線 earbuds, `4200000000` 3C週邊). | Marketplace operators call category to get every product of one momo shop category (the category pages of momoshop.com.tw), 20 per page,…. | category, min_price, max_price, page |
| product | One momo product in full: title and subtitle, brand and brand id, images, video, the shop category path and the search category, every price the page prints (headline price and its label — 促銷價, or 限時折後價 during a time-limited discount — the promotion price and the market price), every variant with its own stock and delivery promise, delivery options with their fees and free-shipping thresholds, payment methods and the card offer, warranty, gifts, the sales band and category ranking, the spec table and description text, and for third-party listings the shop (name, rating, reply rate, defect rate, product count). One extra call adds the rating and rating count. | Catalog enrichment teams call product to get one momo product in full. | product_id, url |
| reviews | Reviews (評價) of one momo product, 20 per page: star rating, text, date, the buyer's masked name as momo shows it, the variant bought, photos and video, likes, the seller's reply; plus the product's average rating, rating count, the count per star, and the aspect scores (商品品質 …). | Retail analysts call reviews to get reviews (評價) of one momo product, 20 per page. | product_id, url, filter, page |
Call search from your stack
curl -X POST https://api.reefapi.com/momoshop/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"耳機"}'import requests
r = requests.post(
"https://api.reefapi.com/momoshop/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "耳機"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/momoshop/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "耳機"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.momoshop.search with {"query":"耳機"}.Who uses this API and why
- Track momo's prices, market prices and time-limited discounts on a product list every day.
- Monitor stock per colour and size for products sold on momo.
- Compare third-party shops on momo by rating, reply rate and defect rate.
- Collect momo reviews with star ratings for sentiment and quality analysis.
- Map a Taiwanese category's assortment, brands and price bands from momo's category pages.
Questions developers ask before integrating
Do I need a momo account?
No. Everything is read logged out, and you call reefapi.com from anywhere. Member-only and card-conditional prices are not shown to logged-out visitors, so they are not returned.
Which price should I use?
prices.price is what momo shows as the price; list_price is the struck market price. During a time-limited discount price_label reads 限時折後價 and promo_price holds the price before that discount.
Which search filters are there?
Each was checked against the unfiltered count in the same run: "耳機" 16,488 → fast delivery 3,806, coupon 7,632, in stock 16,131, 0% instalments 6,248, convenience-store pickup 12,513, TV shopping 63, with video 2,178, instant discount 3,206, cash on delivery 12,111, ships from momo's warehouse 3,818, 1,000-2,000 TWD 2,325, Apple 100. Chilled delivery cut "冷凍水餃" 271 to 159.
How do I filter by brand?
Pass brand_id, momo's numeric brand id, which every search answer lists in facets.brands with its count. momo's search ignores brand names.
How many results can I page through?
30 cards per search page (up to 6 of them paid placements, returned apart in ads) and 20 per category page. "衣服" counted 249,618 products over 8,321 pages. A page past the last answers not found.
Do you return the stock?
Yes. Search rows carry the total stock; product carries each variant's stock, with the cap noted above for items momo sells itself.
Can I get every review?
Yes, 20 per page. Choose written reviews (default), reviews with photos or video, or one star level. Each answer carries the average, the count per star and the aspect scores (商品品質, 商品符合度, 出貨速度).
What is not returned?
The end time of a flash discount (momo's product data carries none), member-only coupons and prices, and the ranking pages. A product's own ranking line (熱銷第 1 名 in a list) is returned.
What is the momo購物網 (momoshop) API?
momo購物網 (momoshop) API is a ReefAPI endpoint group for taiwan's largest online store: search with momo's own filters, category listings, every price a product page prints, stock per variant, delivery promise, third-party shop details and reviews. It returns live JSON through POST requests under /momoshop/v1.
Is the momo購物網 (momoshop) API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. momo購物網 (momoshop) calls use the same shared credit balance as every other ReefAPI engine.
Do I need a momo購物網 (momoshop) login or account?
No login to momo購物網 (momoshop) is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the momo購物網 (momoshop) data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the momo購物網 (momoshop) API use?
momo購物網 (momoshop) actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call momo購物網 (momoshop) from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call momoshop actions with the same key, credit pool and JSON envelope used by normal REST requests.