# PChome 24h API — search Taiwan's 24-hour online store and read products with list, web and discount prices, stock state, variants, delivery type and reviews

> 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).
> ReefAPI engine `pchome` · 6 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/pchome/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free except verified SHEIN NOT_FOUND on product/detail and price (4 credits).
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Send the key as `Authorization: Bearer <key>`, or put it in the URL (`?key=<key>`) when the client has no header field, as ChatGPT does.

## Endpoints

### POST https://api.reefapi.com/pchome/v1/search — 2 credits
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).

**Parameters:**
- `query` (string, required) — Search words in any form PChome's own search box takes: Traditional or Simplified Chinese (衛生紙 / 卫生纸 return the same results), English, model numbers. Full-width characters are normalised.
- `scope` (enum, optional, default "all") — Which part of PChome to search: everything, only products that arrive within 24 hours (24h到貨), only products shipped by the supplier (廠商出貨), or the 24h bookstore. 24h and vendor do not add up exactly to all. [one of: all, 24h, vendor, books]
- `category` (string, optional) — PChome category id (15 digits) from the `categories` action or a row's category_ids, e.g. 141001002001000. Narrows the search to that category and its children.
- `brand` (string, optional) — PChome brand id from the `brands` action or a product's brand_id, e.g. 1_665 (Apple).
- `min_price` (integer, optional) — Lowest card price in TWD.
- `max_price` (integer, optional) — Highest card price in TWD.
- `delivery` (enum, optional) — Only products offering this pickup or delivery method. [one of: convenience_store, ipost, express, quick_install]
- `in_stock_only` (boolean, optional, default false) — true drops products PChome shows as restocking (補貨中).
- `sort` (enum, optional, default "relevance") — Result order (PChome's own options). Price sorts use the card price. [one of: relevance, popular, newest, price_asc, price_desc]
- `page` (integer, optional, default 1) — Result page. PChome serves at most 100 pages.
- `page_size` (integer, optional, default 20) — Rows per page: 10, 20, 30 … 100 (PChome serves only multiples of 10).

**Returns:** results[]{product_id, title, description, url, image, price, card_web_price, currency (TWD), rating, review_count, category_ids[], coupon_activity_ids[], publisher (books), author, publish_date, is_book, is_adult, sold_by_pchome, business_unit} + total, pages, page, page_size, has_more, pages_capped

**Example request body:**
```json
{
  "query": "iphone",
  "scope": "24h"
}
```

### POST https://api.reefapi.com/pchome/v1/product — 3 credits
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).

**Parameters:**
- `product_id` (string, required) — PChome product id exactly as a search row returns it (6 + 9 characters, e.g. DYAJ2X-1900KFLI4). The 20-character form with a -000 suffix and a 24h.pchome.com.tw/prod/... URL are accepted too.

**Returns:** product{product_id, item_id, url, name, nickname, sales_name, tagline, brands[], brand_id, price, price_type, currency, prices{list_price, web_price, discount_price, prime_price, original_web_price, discount_text}, is_subscription, subscription{periods, amount_per_period, total}?, availability{button_type, status, in_stock, orderable_qty, orderable_qty_capped}, fulfilment, ship_type, arrives_24h, preorder_date, seller{name, type, fulfilment}, store_id, region_id, category_ids[], has_variants, variants[]{variant_id, spec, orderable_qty, status, in_stock, prices, image}, is_bundle, bundle_components[], images[], video_url, isbn, flags{}, details{selling_points[], statement, equipment, author, translator, publisher, publish_date, approvals{}}, reviews{total, average_rating, distribution{}}}

**Example request body:**
```json
{
  "product_id": "DYAJ2X-1900KFLI4"
}
```

### POST https://api.reefapi.com/pchome/v1/reviews — 1 credit
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.

**Parameters:**
- `product_id` (string, required) — PChome product id exactly as a search row returns it (6 + 9 characters, e.g. DYAJ2X-1900KFLI4). The 20-character form with a -000 suffix and a 24h.pchome.com.tw/prod/... URL are accepted too.
- `sort` (enum, optional, default "relevant") — Review order (PChome's own options). [one of: relevant, newest, highest, lowest]
- `with_photos` (boolean, optional, default false) — true = only reviews with photos (附圖片評價). PChome's total stays the all-reviews total; `pages` reflects the filter.
- `page` (integer, optional, default 1) — Review page.
- `page_size` (integer, optional, default 20) — Reviews per page, 1 to 100.

**Returns:** reviews[]{review_id, reviewer, rating, product_name, variant, comment, seller_reply, tags[]{name, text}, date, photos[], likes} + summary{total, average_rating, source_average_rounded, distribution{}}, page, pages, has_more

**Example request body:**
```json
{
  "product_id": "DYAJNV-1900KFKV5",
  "sort": "newest"
}
```

### POST https://api.reefapi.com/pchome/v1/prices — 3 credits
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.

**Parameters:**
- `product_ids` (string, required) — Up to 50 product ids, comma-separated or as a list, exactly as search rows return them.

**Returns:** products[]{product_id, item_id, name, price, price_type, prices{}, availability{}, fulfilment, arrives_24h, preorder_date, is_subscription, variants[]{variant_id, prices{}, availability{}}} + not_found[]

**Example request body:**
```json
{
  "product_ids": "DYAJ2X-1900KFLI4,DYAJNV-1900KFKV5"
}
```

### POST https://api.reefapi.com/pchome/v1/categories — 1 credit
PChome's category tree for a search, with the number of matching products in each category — the ids feed search's `category` filter.

**Parameters:**
- `query` (string, required) — Search words in any form PChome's own search box takes: Traditional or Simplified Chinese (衛生紙 / 卫生纸 return the same results), English, model numbers. Full-width characters are normalised.
- `scope` (enum, optional, default "all") — Which part of PChome to search: everything, only products that arrive within 24 hours (24h到貨), only products shipped by the supplier (廠商出貨), or the 24h bookstore. 24h and vendor do not add up exactly to all. [one of: all, 24h, vendor, books]

**Returns:** categories[]{category_id, name, count, children[]}

**Example request body:**
```json
{
  "query": "衛生紙"
}
```

### POST https://api.reefapi.com/pchome/v1/brands — 1 credit
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.

**Parameters:**
- `query` (string, required) — Search words in any form PChome's own search box takes: Traditional or Simplified Chinese (衛生紙 / 卫生纸 return the same results), English, model numbers. Full-width characters are normalised.
- `scope` (enum, optional, default "all") — Which part of PChome to search: everything, only products that arrive within 24 hours (24h到貨), only products shipped by the supplier (廠商出貨), or the 24h bookstore. 24h and vendor do not add up exactly to all. [one of: all, 24h, vendor, books]

**Returns:** brands[]{brand_id, name, count}

**Example request body:**
```json
{
  "query": "衛生紙"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=pchome
- Human docs page: https://reefapi.com/docs/pchome
- Overview page: https://reefapi.com/pchome-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt