Hobby Hall
Finland's Pigu Group marketplace hobbyhall.fi: EUR price for everyone and the member price, every seller offer, delivery dates and fees, full specifications.
/hobbyhall/v1/search3 creditsKeyword search on hobbyhall.fi (Finland, prices in EUR). Each row: product id and modification id (pass both to `product`), title, brand, hobbyhall.fi URL, image, the EUR price everyone pays, the loyalty member price when the shop shows one, monthly instalment from, rating and review count, seller id and supply type (1P = sold by Hobbyhall.fi itself, 3P = marketplace seller), delivery promise and its label in Finnish, promotion labels, sponsored flag, category id (feeds `category`). Plus the shop's own total and page count (60 rows a page). The price filter acts on the lowest payable price (the member price when there is one). Page on with `next_cursor`. One of `query` or `cursor` is required.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Search words, as typed in the hobbyhall.fi search box (Finnish gives the most rows; brand and model names work in any language). Required unless `cursor` is given. |
| min_price | optional | 0– | Lowest price in EUR. The shop applies the range to the LOWEST payable price, which is the member price when the row has one, so a row's `price` (for everyone) can be above `max_price` (measured: 200-400 returned rows with `price` up to 487 and `member_price` in range). |
| max_price | optional | 0– | Highest price in EUR (same rule as `min_price`). |
| sort = best_selling | optional | best_selling · price_asc · price_desc · delivery · rating | best_selling (the shop's default), price_asc, price_desc, delivery (fastest delivery first) or rating. Price sorts order by the lowest payable price. |
| page = 1 | optional | 1–500 | Result page, starting at 1 (59-60 rows per page, measured). |
| result_set | optional | algolia · classic · landing | The shop answers a keyword from one of two result sets, picked per request (lego technic: 451 or 261 hits). Pass the `result_set` of page 1 when asking for later pages; the engine asks again until the shop answers from that set (up to 3 times). `next_cursor` does this for you. |
| cursor | optional | — | `next_cursor` from the previous search answer of THIS engine. Carries the query, filters, sort, next page, page 1's result set and the product ids already returned; rows returned on earlier pages are dropped and counted in `duplicates_dropped`. Use it alone. A cursor keeps the shop it was made in. |
/hobbyhall/v1/category3 creditsOne hobbyhall.fi category listing by the category id a search row carries in `category_id`: the same row fields as `search` (59-60 rows a page), the category title in Finnish and the shop's own product count; 5 sort orders.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category_id | required | — | Numeric hobbyhall.fi category id, as a search row carries it in `category_id` (e.g. 2653 = LEGOT ja rakennuslelut, 11,229 products on 2026-11-22). Ids are per shop: a pigu.lt, 220.lv, kaup24.ee or hobbyhall.fi id is not the same category in another shop. |
| sort = best_selling | optional | best_selling · price_asc · price_desc · delivery · rating | best_selling (the shop's default), price_asc, price_desc, delivery (fastest delivery first) or rating. Price sorts order by the lowest payable price. |
| page = 1 | optional | 1–500 | Result page, starting at 1 (59-60 rows per page, measured). |
/hobbyhall/v1/product2 creditsOne hobbyhall.fi product by its product id AND modification id (both are on every search / category row): the main offer's EUR price for everyone and member price, the main seller with its rating, every other seller's offer (seller, rating, rating count, price, member price, delivery date as the shop prints it in Finnish), the delivery options with date and fee in EUR, rating, review count, the specification table, the description and the category.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | — | hobbyhall.fi product id exactly as a search or category row returns it (also the `id=` number of a hobbyhall.fi product URL). Ids are per shop. |
| modification_id | required | — | Modification id from the same hobbyhall.fi row. A modification that belongs to another product answers NOT_FOUND. |
curl -X POST https://api.reefapi.com/hobbyhall/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"lego technic"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.