FINN.no
FINN torget second-hand ads from finn.no as JSON: prices in NOK, county counts, the full ad and the shop behind it.
/finn/v1/search1 creditSearch FINN torget (finn.no, Norway) by keyword, category or county: listing id (finnkode), title, price in NOK (null for give-away ads), give-away flag, place, publication time, private or business seller (business shop name), shipping and buy-now (Fiks ferdig) availability, brand, images and attributes, 53 listings per page with the true total and category / county 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 Norwegian as FINN users write it (sykkel, sofa, iphone 15, barnevogn). Optional when `category` or `location` is given. |
| category | optional | — | FINN torget category code from `categories` or a search's `category_facets`: 0.<id> (top level, e.g. 0.69 Sport og friluftsliv), 1.<id>.<id> (sub-category, e.g. 1.69.3963 Sykkelsport) or 2.<id>.<id>.<id> (leaf, e.g. 2.69.3963.257 Sykler). |
| location | optional | — | Norwegian county (fylke) code from a search's `region_facets`, e.g. 0.20061 Oslo, 0.20003 Akershus, 0.22046 Vestland, 0.20016 Trøndelag, 0.20012 Rogaland. |
| 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 Norwegian kroner (NOK). |
| price_max | optional | 0– | Highest price in whole Norwegian kroner (NOK). |
| 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 FINN's own delivery service, 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). |
/finn/v1/listing1 creditOne FINN torget listing in full by finnkode or finn.no URL: title, full description, price in NOK, give-away flag, status (active or sold), condition on FINN'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, Brønnøysund company registry link, address, phone, website and its other listings; for a private seller the seller type and FINN's seller id (FINN shows no private seller name to logged-out visitors).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| listing_id | required | — | FINN listing id (the finnkode: the number at the end of finn.no/recommerce/forsale/item/478570197) or the full finn.no listing URL. |
| max_rotations = 3 | optional | 1–5 | Advanced: how many times to retry a difficult request (1-5). |
/finn/v1/categories1 creditFINN torget'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 county 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/finn/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"sykkel"}'{
"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.