Tori.fi API

Search Tori.fi, Finland's major marketplace, and pull ads with prices, locations and photos as JSON.

The API.SH Tori.fi API turns public Tori.fi pages into structured JSON. Search Finnish marketplace ads by keyword with category, location, a radius around a point, price, condition, seller type, trade type, shipping, published today and sort, plus any other filter the site lists. Each result has the price in euros, location and coordinates, published time, photos and labels. Fetch one ad for its full description, attributes, category path, postcode, shipping options and, for business sellers, the shop profile. Private sellers' names and contact details are never returned.

Get a free API key Try it in the playground

2 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Search Tori.fi ads

GET https://api.api.sh/tori/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Tori.fi API

New ad alerts (hakuvahti)

Poll a search with published today, or ask the listing route for the latest matching ad, and push new Tori.fi ads to Discord, Telegram or email.

/search /listing

Second-hand price research

Search a product across Finland with price and condition filters to see what used items really sell for.

/search

Local radius search

Search around a point with a radius in kilometers to find items near a city or postcode.

/search

Free item and giveaway tracking

Filter by trade type to find giveaways or wanted ads in a category or area.

/search

Business seller monitoring

Filter for business sellers and read their shop profiles and listings to follow competitors on Tori.

/search /listing

Tori.fi data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Tori.fi API endpoints and prices

Every Tori.fi endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Search Tori.fi ads

/tori/v1/search

$1 · $2 PAYG

1 credit

Products, listings and places1

Tori.fi ad details

/tori/v1/listing

$1 · $2 PAYG

1 credit

Call the Tori.fi API

Search Tori.fi ads: GET https://api.api.sh/tori/v1/search

curl "https://api.api.sh/tori/v1/search?q=sohva" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/tori/v1/search",
    params={"q": "sohva"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/tori/v1/search");
url.searchParams.set("q", "sohva");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/tori/v1/search", "q", "sohva")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Tori.fi" and "Search Tori.fi ads".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Tori.fi data

Public data only: no Tori.fi login, cookies or account needed
One key and one response shape for Tori.fi and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Tori.fi API

Tori.fi does not offer an official public API for outside developers. Existing tools such as Discord bots and browser extensions are unofficial. API.SH reads public Tori.fi ads and returns them as JSON with no account.

Instead of maintaining a GitHub script or Discord bot that breaks when Tori.fi changes, API.SH gives one key, one JSON shape and a fixed price per call.

Tori.fi API questions

What Tori.fi data can I get?+

Ad search with category, location, radius, price, condition, seller type, trade type and shipping filters (/tori/v1/search) and one full ad with description, attributes, location, photos, shipping and shop profile (/tori/v1/listing).

How much does the Tori.fi API cost?+

Every Tori.fi endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /tori/v1/listing at 1 credit each.

Is there an official Tori.fi API?+

No. Tori.fi has no public developer API. API.SH reads public ads and returns them as JSON.

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

No. API.SH reads public Tori.fi pages only. No endpoint uses a login, cookies or anyone's account.

Can I use the Tori.fi API from Python?+

Yes. Call the endpoints with any HTTP client or the Python SDK. Prices come back in euros as numbers, ready for analysis.

Can I build a search alert for new Tori.fi ads?+

Yes. Call /tori/v1/listing with latest=1 and your search parameters for the newest matching ad, or poll /tori/v1/search with published_today and sort, and compare ids between runs.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /tori/v1/search with q=sohva and a location, then pass an ad id to /tori/v1/listing. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.