Reef AI: ask for any data. Try it
Tori.fi API

Tori.fi second-hand listings as clean JSON in EUR

The Tori.fi API returns Tori, Finland's second-hand marketplace, as JSON in three actions, with prices in EUR.

endpoints
3
credit per call
1

1 credit per call≈ $1/1,000 calls1,000 free credits, no card

3 active endpoints. Every call is 1 credit.

  • POST/tori/v1/search1 credit
  • POST/tori/v1/listing1 credit
  • POST/tori/v1/categories1 credit
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Tori.fi API

3 of 3 endpoints, ready to run

View docs ↗

53 Tori ads per call: id, title, price in EUR (null for give-aways), place, publication time, private or business seller, ToriDiili and Osta heti flags, photos, with the true total and region counts.

1 credit0 required · 5 optional
POST/tori/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.

Try every endpoint in the playground

Endpoints

What Tori.fi endpoints does ReefAPI ship?

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

3 endpoints

search

1 cr

Search Tori (tori.fi, Finland) by keyword, category or region.

required
—
optional
query, category, location, page, sort, price_min, price_max, condition, seller_type, listing_type, shipping, published_today, max_rotations

listing

1 cr

One Tori listing in full by id or tori.fi URL.

required
listing_id
optional
max_rotations

categories

1 cr

Tori's category tree with live listing counts.

required
—
optional
query, max_rotations

Every parameter, every allowed value →

Missing a Tori.fi endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Tori.fi API works

Tori.fi 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 746 engines.

02
Call
POST /tori/v1/…

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

03
Pay
1 credit per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

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

Recipe

Watch a Finnish second-hand segment, newest first

This is the same data as /blocket-api with the site fixed to tori.fi; calls to POST /blocket/v1/... with country fi keep working unchanged. Shops on Tori sometimes list an item at 1 euro as an ask-for-price placeholder, so treat a 1 as a label, not a price.

01search
POST/tori/v1/search
{"query": "toyota", "sort": "newest"}

53 newest Tori ads for the keyword; "toyota" matched 11,518 on 2026-11-22. Rows priced exactly 1 EUR (1 to 2 per page on five customer searches) are placeholders.

02listing
POST/tori/v1/listing
{"listing_id": <listing_id from a row>}

The full ad with description, condition, attributes, map position and, for a shop, its name, phone and registry link.

New Tori supply for a keyword or category with EUR prices, seller type and place.

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

What a Tori field holds

Fields as they came back from live tori.fi calls on 2026-11-22.

FieldWhat it holds on Tori
listing_idThe number at the end of tori.fi/recommerce/forsale/item/34408459; listing also takes the whole URL.
price, currencyThe asking price in EUR. null for a give-away (is_free true); a 0 is never returned. A 1 can be a shop's ask-for-price placeholder.
seller_type, seller_nameprivate or business; the name is the shop's on business rows (8 of 53 on "polkupyörä"). Tori shows no private seller name.
shipping_available, buy_nowTori's own delivery (ToriDiili) and Osta heti flags: 2 of 53 rows each on "polkupyörä".
conditionTori's five-step scale with its Finnish label, e.g. good / "Hyvä". Optional for sellers: the shop ad measured had none.
seller.company_registry_urlFor a shop, the YTJ business register entry (tietopalvelu.ytj.fi), plus organisation id, phone and website.

Category codes such as 2.69.3963.257 (Polkupyörät) are the same codes Blocket, FINN and DBA use; the names come back in Finnish.

Coverage

Tori, measured on 2026-11-22

Every number below came from live tori.fi calls on 2026-11-22 (search, categories, listing and 11 side-by-side checks against /blocket-api).

Site and currency

tori.fi, Finland's second-hand marketplace (/recommerce/forsale), prices in EUR: 53 of 53 rows of a "polkupyörä" search linked to www.tori.fi and were priced in EUR.

Search

"polkupyörä" matched 29,816 ads; one call returns 53, price on 52 of 53 (5 to 499 EUR) and 1 give-away with price null. Customer searches the same day: "toyota" 11,518, "porsche" 2,084, "volvo v50" 1,419, "911" 608.

Seller

45 of 53 rows were private and 8 businesses (shop names such as PKS Kierrätyskeskus and Nettomatti); Tori shows no private seller's name. On one narrow search 14 of 53 rows carried no seller type at all.

The 1 euro placeholder

Shops sometimes list an item at 1 EUR as ask-for-price; 1 or 2 rows per page carried exactly 1 EUR on five newest-first searches. It is returned as Tori shows it.

Regions

19 regions with the code to filter on: Uusimaa 0.100018 (10,276 for "polkupyörä"), Pirkanmaa 0.100011 (3,134), Pohjois-Pohjanmaa 0.100002 (2,600), Varsinais-Suomi 0.100016 (2,269).

Categories

11 top-level categories and 604 nodes, 3,709,007 live ads in total; Vaatteet, kosmetiikka ja asusteet was the largest (752,313).

A shop's ad

PKS Kierrätyskeskus, 180 EUR bicycle: shop name, organisation id, a tietopalvelu.ytj.fi registry link, street address, phone, website and 10 other ads. The shop left condition empty.

Limits

Search rows carried no attributes on the searches measured; listing has them. Shipping flags were rare (2 of 53 ToriDiili on "polkupyörä").

Use cases

What people build with Tori.fi

The jobs this data is most often used for.

3

endpoints

1

credit per call

01

Track second-hand car, bike and electronics asking prices in Finland with search sorted by newest.

02

Watch new give-away and low-price ads in one region with listing_type, location and price filters.

03

Size supply per category and region from total_results and the facet counts.

04

Follow a shop's stock through listing's seller block and the shop's other ads.

Pricing

What Tori.fi 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 746 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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/tori/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"polkupyörä"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/tori/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
        "query": "polkupyörä"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Tori.fi.

Is there a Tori.fi API?▾

Yes: this API returns Tori's second-hand marketplace as JSON — search, full listing and categories — with no Tori account.

Which currency are Tori prices in?▾

EUR: 53 of 53 rows of a "polkupyörä" search on 2026-11-22 were priced in EUR and linked to www.tori.fi. Give-aways come back with price null and is_free true.

Why do some Tori ads cost 1 euro?▾

Shops sometimes use 1 EUR as an ask-for-price placeholder; 1 or 2 rows per page carried exactly 1 EUR on five newest-first searches on 2026-11-22. The number is returned as Tori shows it, so filter price above 1 for real asking prices.

Does it return the seller?▾

For a shop, yes: listing returns the shop name, organisation id, YTJ registry link, address, phone, website and its other ads. Tori shows no private seller name, so the seller type and Tori's seller id come back and the name is null.

How many Tori ads can one search reach?▾

53 per page and 50 pages, so 2,650 per query. Split by category, region or price to reach the rest.

Is this different from the Blocket API?▾

It is the same data as /blocket-api with the site fixed to tori.fi, at the same price. Calls to POST /blocket/v1/... with country fi keep working unchanged.

What is the Tori.fi API?▾

Tori.fi API is a ReefAPI endpoint group for tori second-hand ads from finland as json: prices in eur, region counts, the full ad and the shop behind it. It returns live JSON through POST requests under /tori/v1.

Is the Tori.fi API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. Tori.fi calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Tori.fi login or account?▾

No login to Tori.fi 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 Tori.fi 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 Tori.fi API use?▾

Tori.fi actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Tori.fi from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call tori actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Tori.fi API a Tori.fi scraper?▾

It is the managed alternative to a DIY Tori.fi scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same tori second-hand ads from finland as json: prices in eur, region counts, the full ad and the shop behind it back as clean JSON.

Why does my Tori.fi scraper keep getting blocked?▾

Most Tori.fi scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.

Same key

126 Classifieds & Second-hand APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Tori.fi, you are one call away from the rest of the category — no second contract, no second integration.

Contact

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 745 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-11-22.