# Tori Marketplace Listings API

> Second-hand listings from Tori.fi, Finland's online marketplace, with title, price, condition, location, images and listing link, filtered by search text, category, condition, location and price.

- Page: https://cleanedweb.com/catalog/tori-marketplace-listings-api/
- Contract (JSON): https://cleanedweb.com/catalog/tori-marketplace-listings-api/contract.json
- Source: tori.fi (https://www.tori.fi/)
- Category: Commerce
- Countries: Finland
- Languages: Finnish
- Updated: 2026-11-10

A run reads until the source ends or your `max_items`, `timeout_seconds` or budget stops it.

## Key fields

| Field | Type | Sample value |
| --- | --- | --- |
| `title` | string | `Martela Kilta tuoli Väri: Violetti (Lila)` |
| `price` | string | `370 €` |
| `currency` | string | `EUR` |
| `date` | string | `2026-11-02` |
| `condition` | string | `UsedCondition` |
| `description` | string | `Martela Kilta tuoleja Lähes virheettömät Hinta: 200,00 kpl tai yhteishinta: 370…` |
| `brand` | string | not in the saved sample |
| `url` | string | `https://www.tori.fi/recommerce/forsale/item/49389352` |

Sample values come from one saved record, not a live run. Every field with its type, and the schemas, are in https://cleanedweb.com/catalog/tori-marketplace-listings-api/contract.json. Some fields the source returns are not published, so a record can carry fields the schema does not list.

## Inputs

- `search` (string \| array of string): Optional. Text for the site's search box. Leave it out to read everything.
- `category` (string \| number): Optional. Filters by the site's category control. Default: 0.78. Options: Koti ja sisustus (0.78), Piha ja remontointi (0.67), Lapset ja vanhemmat (0.68), Urheilu ja ulkoilu (0.69), Vaatteet, kosmetiikka ja asusteet (0.71), Antiikki ja taide (0.76), Eläimet ja eläintarvikkeet (0.77), Viihde ja harrastukset (0.86), and 591 more in https://cleanedweb.com/catalog/tori-marketplace-listings-api/contract.json.
- `brand` (string \| number): Optional. Filters by the site's brand control. Options: 9411, 9797, Muut (1), 9293, 9235, 9403, 9232, 13, and 913 more in https://cleanedweb.com/catalog/tori-marketplace-listings-api/contract.json.
- `location` (string \| number): Optional. Filters by the site's location control. Options: Lappi (0.100001), Pohjois-Pohjanmaa (0.100002), Kainuu (0.100003), Keski-Pohjanmaa (0.100004), Pohjanmaa (0.100005), Etelä-Pohjanmaa (0.100006), Keski-Suomi (0.100007), Pohjois-Savo (0.100008), and 306 more in https://cleanedweb.com/catalog/tori-marketplace-listings-api/contract.json.
- `trade_type` (string \| number): Optional. Filters by the site's trade type control. Options: Annetaan (2), Ostetaan (3), Myydään (1).
- `shipping_types` (string \| number): Optional. Filters by the site's shipping types control. Options: ToriDiili (0), Ilmainen toimitus (1).
- `condition` (string \| number): Optional. Filters by the site's condition control. Options: Uusi (1), Kuin uusi (2), Hyvä (3), Kohtalainen (4), Vaatii korjausta (5).
- `dealer_segment` (string \| number): Optional. Filters by the site's dealer segment control. Options: Yksityinen (1), Yritys (3).
- `published` (boolean): Filters by the site's published control.
- `price_from` (string \| integer): Optional. Omit it to leave this side open.
- `price_to` (string \| integer): Optional. Omit it to leave this side open.
- `sort` (string): Order of the collection, as the site's own sort control offers it; omitted keeps the site's default order. Options: Alhaisin hinta (PRICE_ASC), Korkein hinta (PRICE_DESC), Osuvimmat ensin (RELEVANCE), Vanhimmat ensin (PUBLISHED_ASC).

`enrich_records` is on by default and adds the fields that only appear on each record's detail page. Send `false` to read list fields only. See https://cleanedweb.com/docs/run-api/

## Request

`POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_adaca3f15744afcc1d75f3eb/endpoints/generated_adaca3f15744afcc1d75f3eb_search/run`

```bash
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_adaca3f15744afcc1d75f3eb/endpoints/generated_adaca3f15744afcc1d75f3eb_search/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "category": "0.78"
  },
  "version": 1,
  "max_items": 25
}'
```

Send an `Idempotency-Key` header with every run and save it before you send. Reuse it only to retry the same request. If the run does not end within `wait_seconds`, read the result with the same API key and key:

`GET https://api.cleanedweb.com/v1/catalog/public/apis/generated_adaca3f15744afcc1d75f3eb/endpoints/generated_adaca3f15744afcc1d75f3eb_search/result`

## Versions

Current: `1.0`. Pin a major with "version": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.

- v1: current, newest minor `1.0`

### Changelog

- `1.0` (major) 2026-11-06

The same changelog, as data, is in https://cleanedweb.com/catalog/tori-marketplace-listings-api/contract.json

## Use it from an AI agent

MCP server: https://api.cleanedweb.com/mcp?profile=catalog (Streamable HTTP). Sign in with a CleanedWeb account when the client asks (OAuth), or send an API key with the `read` and `run` scopes as `Authorization: Bearer`. Call `get_api` with `api_id` `generated_adaca3f15744afcc1d75f3eb`, then `run_api` with the `run_with` arguments it returns. See https://cleanedweb.com/docs/mcp/

## Run it

Reading the catalog needs no credential. Running needs a CleanedWeb account and an API key with the `run` scope; the first 5,000 records are free, then $1 per 1,000 records. See https://cleanedweb.com/docs/run-catalog-api/

CleanedWeb is not affiliated with Tori.
