Tori.fi
Tori second-hand ads from Finland as JSON: prices in EUR, region counts, the full ad and the shop behind it.
/tori/v1/search1 creditSearch Tori (tori.fi, Finland) by keyword, category or region: listing id, title, price in EUR (null for give-away ads), give-away flag, place, publication time, private or business seller (business shop name), shipping and buy-now availability, brand, images and attributes, 53 listings per page with the true total and category / region counts. Filter by price, condition, seller type, ad type, shipping and ads published today; sort by relevance, newest or price. Pages 1-50.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Keyword, in Finnish (or Swedish) as Tori users write it (polkupyörä, sohva, iphone 15, lastenvaunut). Optional when `category` or `location` is given. |
| category | optional | — | Tori category code from `categories` or a search's `category_facets`: 0.<id> (top level, e.g. 0.69 Urheilu ja ulkoilu), 1.<id>.<id> (sub-category, e.g. 1.69.3963 Pyöräily) or 2.<id>.<id>.<id> (leaf, e.g. 2.69.3963.257 Polkupyörät). |
| location | optional | — | Finnish region (maakunta) code from a search's `region_facets`, e.g. 0.100018 Uusimaa, 0.100011 Pirkanmaa, 0.100016 Varsinais-Suomi, 0.100002 Pohjois-Pohjanmaa. |
| page = 1 | optional | 1–50 | Result page, 1-50 (53 listings per page). The sites stop at page 50 whatever the total. |
| sort = relevance | optional | relevance · newest · price_asc · price_desc | Order of results. Anything else is rejected (the sites silently fall back to relevance). |
| price_min | optional | 0– | Lowest price in whole euros (EUR). |
| price_max | optional | 0– | Highest price in whole euros (EUR). |
| condition | optional | new · like_new · good · fair · needs_repair | Item condition, on the sites' shared five-step scale. |
| seller_type | optional | private · business | Only private sellers or only businesses. |
| listing_type | optional | sell · give_away · wanted | Kind of ad. Give-away ads have no price. |
| shipping | optional | shipping · free_shipping | Only ads that can be shipped through Tori's own delivery service (ToriDiili), or only ads where the seller pays shipping. |
| published_today | optional | — | Only ads published today. |
| max_rotations = 3 | optional | 1–5 | Advanced: how many times to retry a difficult request (1-5). |
/tori/v1/listing1 creditOne Tori listing in full by id or tori.fi URL: title, full description, price in EUR, give-away flag, status (active or sold), condition on Tori's five-step scale, category path with its search code, all attributes, every image, postal code, place and map position, last-edited time, shipping and buy-now availability, and the seller: for a business the shop name, organisation id, YTJ company registry link, address, phone, website and its other listings; for a private seller the seller type and Tori's seller id (Tori shows no private seller name to logged-out visitors).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| listing_id | required | — | Tori listing id (the number at the end of tori.fi/recommerce/forsale/item/34408459) or the full tori.fi listing URL. |
| max_rotations = 3 | optional | 1–5 | Advanced: how many times to retry a difficult request (1-5). |
/tori/v1/categories1 creditTori's category tree with live listing counts: 11 top-level categories, three levels, each node with the code to pass as `category` to search, plus the region counts. Optionally counted for one keyword.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Optional keyword: counts are then for that keyword. |
| max_rotations = 3 | optional | 1–5 | Advanced: how many times to retry a difficult request (1-5). |
curl -X POST https://api.reefapi.com/tori/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"polkupyörä"}'{
"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.