PChome 24h API

Search Taiwan's 24-hour online store, then read any product's prices, stock state, variants and reviews

PChome 24h is the online store of PChome Online in Taiwan, known for delivery within 24 hours.

no credit card1,000 free credits · instant API key · pay by card or crypto
Missing a PChome 24h endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
P
/pchome/v1

6 active endpoints, on 1, 2 and 3 credit tiers.

  • POST/pchome/v1/search
  • POST/pchome/v1/product
  • POST/pchome/v1/reviews
  • POST/pchome/v1/prices
  • POST/pchome/v1/categories
  • POST/pchome/v1/brands

What PChome 24h endpoints does ReefAPI ship?

6 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

6 endpoints

search

2 cr

Search PChome 24h products by keyword with the site's own filters.

required
query
optional
scope, category, brand, min_price, max_price, delivery, in_stock_only, sort, page, page_size

product

3 cr

Full PChome 24h product by product_id.

required
product_id
optional
—

reviews

1 cr

Buyer reviews of a PChome 24h product.

required
product_id
optional
sort, with_photos, page, page_size

prices

3 cr

Price and stock check for up to 50 PChome products in ONE call (PChome's own multi-product en…

required
product_ids
optional
—

categories

1 cr

PChome's category tree for a search, with the number of matching products in each category.

required
query
optional
scope

brands

1 cr

Brands PChome lists for a search, with the number of matching products per brand.

required
query
optional
scope

Every parameter, every allowed value →

PChome 24h API

5 of 6 endpoints, ready to run

View docs ↗

iPhones that arrive within 24 hours, cheapest first

2 credits1 required · 2 optional
POST/pchome/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

How the PChome 24h API works

PChome 24h is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 491 engines.

02
Call
POST /pchome/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 or 2 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

From a keyword to a daily price and stock feed

Find the category and brand ids, search with them, then check prices and stock of the products you follow every day.

01categories?query=衛生紙
GET/pchome/v1/categories?query=衛生紙

PChome's category tree for the keyword with counts; brands works the same way for brand ids.

02search?query=衛生紙&category=<category_id>&sort=price_asc&page_size=100
GET/pchome/v1/search?query=衛生紙&category=<category_id>&sort=price_asc&page_size=100

Up to 100 products per page with the card price, web price, rating and review count; page until has_more is false.

03prices?product_ids=<id1>,<id2>,...
GET/pchome/v1/prices?product_ids=<id1>,<id2>,...

Up to 50 products per call: list, web and discount price, availability, orderable quantity and every variant.

04product?product_id=<product_id>
GET/pchome/v1/product?product_id=<product_id>

The full record when you need it: subscription plan, bundle contents, fulfilment, 24h arrival, images, selling points and review summary.

A dated TWD price and stock feed of PChome 24h products, with discount prices kept apart from web and list prices.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "pchome",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}

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.

FieldWhat it holds
product_idPChome'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_priceThe 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_priceThe 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_priceweb_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.
subscriptionSome 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_qtyHow 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_24hpchome_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_ratingThe 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.

PChome 24h coverage, measured

Every number below was read from live PChome 24h responses on 2026-10-14, in two consecutive runs of 78 calls each, 156 of 156 answered as expected.

Market

Taiwan, prices in TWD. iphone matched 48,464 products, 衛生紙 2,733, dyson 701, nike 9,184.

Filters that bite

iphone 48,464 → 24h arrival 9,750, supplier-shipped 38,555, bookstore 677, category 457, brand Apple 491, 10,000 to 20,000 TWD 111, convenience-store pickup 29,541, locker pickup 9,363, express 9,369, quick install 18, in stock only 47,771.

Price accuracy

On 18 product pages: the price matched the page's own offer price on 17 (the 18th is a subscription phone whose page lists the 12-month total) and the price block the page prints on 17 (the 18th prints no list price at all).

Reviews

Review count matched the product page on 18 of 18 products, the average rating on 18 of 18.

Identity

Search to product returned the same id, price and web price on 14 of 14 rows.

Limits

At most 100 pages per search; orderable quantity stops at 20; no shipping fee, no payment methods, no seller other than PChome.

What people build with PChome 24h

The jobs this data is most often used for.

6

endpoints

1/2/3

credits per call

01

Track Taiwanese retail prices: list, web and discount price per product, with the discount PChome is running today.

02

Monitor stock state of 50 products per call, including each colour or size.

03

Compare which products arrive within 24 hours and which the supplier ships.

04

Collect buyer reviews with ratings, tags and seller replies for product research.

What PChome 24h data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 491 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
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"}'
python
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"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up PChome 24h.

Get a free key →
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.

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 490 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-14.