PChome 24h API & Scraper
PChome 24h is the online store of PChome Online in Taiwan, known for delivery within 24 hours.
🤖 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 a keyword in Chinese or English with PChome's own filters (24h arrival, supplier-shipped or bookstore, category, brand, price range in TWD, convenience-store or locker pickup, in-stock only) and five sort orders, and returns per product: id, title, short description, the price on the card, the web price, rating and review count, category ids and, for books, author, publisher and publish date. `product` returns one product in full: list price, web price (網路價) and discount price (折扣價), a subscription plan when the product is sold by monthly instalments, whether it can be bought now or is restocking, how many units one order may take, every colour or size with its own state, bundle contents, whether PChome ships it from its own warehouse within 24 hours or the supplier ships it, pre-order date, images, selling points and the review summary. `reviews` returns the buyer reviews with rating, comment, tags, variant bought and the seller's reply, and `prices` checks up to 50 products in one call.
What a PChome 24h field actually contains
Fields that read differently from how they look. Every row was measured against live PChome 24h pages on 2026-10-14.
| Field | What it holds |
|---|---|
| product_id | PChome's 16-character product code (DYAJ2X-1900KFLI4). Pass it unchanged from a search row to product, reviews or prices; the 20-character form ending in -000 and a product URL work too. Search to product returned the same id on 14 of 14 rows. |
| price (search) | The price the search card shows: PChome's discount price (折扣價) when it runs one, otherwise the web price. It matched product's price on 14 of 14 products. |
| card_web_price | The second price on the search card. It is the web price (網路價), not a list price: it equalled the card price on 223 of 280 rows and the list price on only 78. |
| prices.list_price | The crossed-out price PChome prints next to the price. null when PChome has none: 2 of 18 audited products had no list price, and on one of them PChome's own page prints no usable value in that spot. |
| prices.web_price, prices.discount_price | web_price is 網路價. discount_price is 折扣價, shown in front of a crossed-out web price; when it is set, it is what the buyer pays and it is the price in product.price. |
| subscription | Some phones are sold as a 12-month plan. Then PChome's web price is the plan total (29,184 = 12 x 2,432) and the one-off price is in prices.original_web_price; product.price is the one-off price and price_type says so. |
| availability.orderable_qty | How many units one order may take, not the warehouse stock. PChome stops at 20: 102 of 200 products said exactly 20. status is for_sale, restocking (補貨中) or not_ready. |
| fulfilment, arrives_24h | pchome_warehouse = PChome ships from its own warehouse; arrives_24h says whether it is in the 24h-arrival programme. supplier_direct = the supplier ships it (廠商出貨), outside the 24-hour promise. |
| reviews.average_rating | The exact average computed from PChome's own 1-5 star counts (4.99 for 272 five-star and 3 four-star reviews), next to PChome's rounded figure. |
Every product in PChome 24h is sold by PChome itself, so there is no third-party seller field; what differs is who ships it. Prices, stock and search results came back identical when read from inside Taiwan and from the United States in the same minute.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/pchome/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "iphone",
"scope": "24h"
}
}{
"ok": true,
"meta": {
"api": "pchome",
"endpoint": "search",
"mode": "live",
"latency_ms": 1601,
"record_count": 20,
"bytes": 12282,
"cache_hit": false,
"total": 9749,
"pages": 100,
"pagination": {
"page": 1,
"has_more": true
},
"upstream_requests": 1,
"charged_credits": 2,
"version": "0.1.0",
"request_id": "aecee67e077f4d41",
"queue_ms": 1.6,
"fetched_at": "2026-10-14T18:57:30.612Z"
},
"data": {
"query": {
"query": "iphone",
"scope": "24h",
"sort": "relevance",
"page": 1,
"page_size": 20
},
"total": 9749,
"pages": 100,
"page": 1,
"page_size": 20,
"has_more": true,
"pages_capped": true,
"results": [
{
"product_id": "DYAJNV-1900KFKV5",
"title": "Apple 蘋果 iPhone 18 Pro (256GB)",
"description": "4800 萬像素融合主相機具備可變光圈 A20 Pro 晶片 電池續航力大舉躍升",
"url": "https://24h.pchome.com.tw/prod/DYAJNV-1900KFKV5",
"image": "https://img.pchome.com.tw/cs/items/DYAJNV1900KFKV5/000001_1789711278.jpg",
"price": 44900,
"card_web_price": 44900,
"currency": "TWD",
"rating": 5,
"review_count": 277,
"category_ids": [
"141001002001000"
],
"coupon_activity_ids": null,
"publisher": null,
"author": null,
"publish_date": null,
"is_book": false,
"is_adult": false,
"sold_by_pchome": true,
"business_unit": "ec"
},
{
"product_id": "DYAJNW-1900KFKUN",
"title": "Apple 蘋果 iPhone 18 Pro (512GB)",
"description": "4800 萬像素融合主相機具備可變光圈 A20 Pro 晶片 電池續航力大舉躍升",
"url": "https://24h.pchome.com.tw/prod/DYAJNW-1900KFKUN",
"image": "https://img.pchome.com.tw/cs/items/DYAJNW1900KFKUN/000001_1789711377.jpg",
"price": 51900,
"card_web_price": 51900,
"currency": "TWD",
"rating": 5,
"review_count": 88,
"category_ids": [
"141001002001000"
],
"coupon_activity_ids": null,
"publisher": null,
"author": null,
"publish_date": null,
"is_book": false,
"is_adult": false,
"sold_by_pchome": true,
"business_unit": "ec"
},
{
"product_id": "DYAJNV-A900KG3IL",
"title": "Apple 蘋果 iPhone 18 Pro (256GB)",
"description": "4800 萬像素融合主相機具備可變光圈 A20 Pro 晶片 電池續航力大舉躍升",
"url": "https://24h.pchome.com.tw/prod/DYAJNV-A900KG3IL",
"image": "https://img.pchome.com.tw/cs/items/DYAJNVA900KG3IL/000001_1789438857.jpg",
"price": 44900,
"card_web_price": 44900,
"currency": "TWD",
"rating": 5,
"review_count": 8,
"category_ids": [
"141001002001000"
],
"coupon_activity_ids": null,
"publisher": null,
"author": null,
"publish_date": null,
"is_book": false,
"is_adult": false,
"sold_by_pchome": true,
"business_unit": "ec"
}
]
}
}What the PChome 24h API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search PChome 24h products by keyword with the site's own filters: scope (all / 24h arrival / supplier-shipped / bookstore), category id, brand id, price range in TWD, pickup or delivery method, in-stock only, and 5 sort orders. Each row: product id, title, short description, URL, image, the card price (the discount price when PChome runs one, else the web price), the card's web price, rating, review count, category ids, coupon activity ids, book author, publisher and publish date. Plus PChome's own total and page count (capped at 100 pages). | Pricing teams call search to search PChome 24h products by keyword with the site's own filters. | query, scope, category, brand, min_price, ... |
| product | Full PChome 24h product by product_id: name, tagline, brand, list price, web price (網路價), discount price (折扣價), member price, subscription plan when the product is sold by monthly instalments, the buy button state (for sale / restocking), orderable quantity, variants (colour / size) each with its own quantity and state, bundle components, fulfilment (PChome warehouse or supplier direct), 24h-arrival flag, pre-order date, category ids, images, video, ISBN, selling points, warranty statement, book metadata and the review summary (count, exact average, 1-5 star distribution). | Marketplace operators call product to get full PChome 24h product by product_id. | product_id |
| reviews | Buyer reviews of a PChome 24h product: rating 1-5, comment, tags, variant bought, PChome's or the supplier's reply, photos, date, likes, reviewer name as PChome shows it (masked by PChome). Sort by relevance, newest, highest or lowest; photo reviews only. Plus the total, exact average and 1-5 star distribution. | Catalog enrichment teams call reviews to get buyer reviews of a PChome 24h product. | product_id, sort, with_photos, page, page_size |
| prices | Price and stock check for up to 50 PChome products in ONE call (PChome's own multi-product endpoint): list, web and discount price, subscription flag, buy button state, orderable quantity, fulfilment, 24h arrival — plus every variant row PChome returns for those products. Ids PChome does not know are listed in not_found. | Retail analysts call prices to get price and stock check for up to 50 PChome products in ONE call (PChome's own multi-product en…. | product_ids |
| categories | PChome's category tree for a search, with the number of matching products in each category — the ids feed search's `category` filter. | Pricing teams call categories to get pChome's category tree for a search, with the number of matching products in each category. | query, scope |
| brands | Brands PChome lists for a search, with the number of matching products per brand — the ids feed search's `brand` filter. PChome lists at most 100. | Marketplace operators call brands to get brands PChome lists for a search, with the number of matching products per brand. | query, scope |
Call search from your stack
curl -X POST https://api.reefapi.com/pchome/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone","scope":"24h"}'import requests
r = requests.post(
"https://api.reefapi.com/pchome/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone",
"scope": "24h"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/pchome/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "iphone",
"scope": "24h"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.pchome.search with {"query":"iphone","scope":"24h"}.Who uses this API and why
- Track Taiwanese retail prices: list, web and discount price per product, with the discount PChome is running today.
- Monitor stock state of 50 products per call, including each colour or size.
- Compare which products arrive within 24 hours and which the supplier ships.
- Collect buyer reviews with ratings, tags and seller replies for product research.
- Map a product category with its subcategories, brands and counts before pulling listings.
Questions developers ask before integrating
Do I need a PChome account?
No. Everything is read logged out, and you call reefapi.com from anywhere.
Can I search in Chinese?
Yes. Traditional and Simplified Chinese return the same results (衛生紙 and 卫生纸 both 2,733 products), and full-width letters are normalised.
Which filters are there?
Scope, category id, brand id, price range, pickup or delivery method and in-stock only. Each was checked against the unfiltered count in the same run: iphone 48,464 → 24h arrival 9,750, supplier-shipped 38,555, bookstore 677, one category 457, brand Apple 491, 10,000 to 20,000 TWD 111, convenience-store pickup 29,541, in stock only 47,771.
How deep can I page?
PChome serves at most 100 pages per search. Rows per page can be 10, 20, 30 up to 100. pages_capped tells you when the total is larger than what 100 pages can show (iphone: 48,464 products).
How do I get the colours and sizes?
product returns them in variants, each with its own state and orderable quantity. For an iPhone 18 Pro bundle, black was restocking and the other three colours were for sale at the same moment.
Can I check many prices at once?
Yes. prices takes up to 50 product ids in one call and returns list, web and discount price, availability and every variant row. Ids PChome does not know are listed in not_found.
Do you return all reviews?
Yes, page by page, up to 100 per page, sorted by relevance, newest, highest or lowest, or only reviews with photos. Reviewer names are returned the way PChome shows them, already shortened by PChome.
Do you return the shipping fee?
No. PChome shows the delivery fee threshold only on the product page itself; this API returns the fulfilment type and the 24h-arrival flag.
What is the PChome 24h API?
PChome 24h API is a ReefAPI endpoint group for taiwan's 24-hour online store: prices, discount prices, stock state, variants, delivery type and reviews. It returns live JSON through POST requests under /pchome/v1.
Is the PChome 24h API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. PChome 24h calls use the same shared credit balance as every other ReefAPI engine.
Do I need a PChome 24h login or account?
No login to PChome 24h 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 PChome 24h 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 PChome 24h API use?
PChome 24h 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 PChome 24h from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call pchome actions with the same key, credit pool and JSON envelope used by normal REST requests.