What you get
| 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 | tori.fi/recommerce/forsale/item/49389352 |
All 59 fields
Key fields
titlepricecurrencydateconditiondescriptionbrandurllocationad_view_type_labelavailabilitybuy_nowcategorycountry_codeeligible_for_shippingimagesis_webstoremap_urlreturn_policyskucondition_rating
Technical fields
ad_idad_typead_type_valuedistanceextrasflagsidimageimage_urlslabelsmain_search_keymetadataorganisation_nameprice_detailssrctimestamptrade_typetypeaccuracycategory_idcategory_parentcategory_parent_idcategory_parent_parentcategory_parent_parent_iddepthdetail_pricedisposededitedhas_been_publishedheightis_inactiveis_legacy_schemaschema_nameseller_pays_shippingshould_indextransactablewidthtyped_price
Every field with its type, and the schemas, are in contract.json.
Sample records
2 saved records. This is a saved sample, not a live run.
title |
price |
currency |
date |
condition |
description |
|---|---|---|---|---|---|
| Martela Kilta tuoli Väri: Violetti (Lila) | 370 € | EUR | 2026-11-02 | UsedCondition | Martela Kilta tuoleja Lähes virheettömät Hinta: 200,00 kpl tai yhteishinta: 370… |
| TEMPUR Pro Medium patja 80x200x21cm ETUSI 640e | 1 243 € | EUR | 2026-11-05 | NewCondition | — |
Scroll sideways to see more columns.
Inputs
-
searchstring | array of stringOptional. Text for the site's search box. Leave it out to read everything.
-
categorychoiceOptional. Filters by the site's category control. Default: 0.78.
-
brandchoiceOptional. Filters by the site's brand control.
-
locationchoiceOptional. Filters by the site's location control.
-
trade_typechoiceOptional. Filters by the site's trade type control.
-
shipping_typeschoiceOptional. Filters by the site's shipping types control.
-
conditionchoiceOptional. Filters by the site's condition control.
-
dealer_segmentchoiceOptional. Filters by the site's dealer segment control.
-
publishedbooleanFilters by the site's published control.
-
price_fromstring | integerOptional. Omit it to leave this side open.
-
price_tostring | integerOptional. Omit it to leave this side open.
-
sortchoiceOrder of the collection, as the site's own sort control offers it; omitted keeps the site's default order.
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 Run an API.
Request
POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_adaca3f15744afcc1d75f3eb/endpoints/generated_adaca3f15744afcc1d75f3eb_search/run
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
}'
Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.
version pins major v1, whose newest minor (1.0) answers. Leave it out and the call runs on the latest major.
Changelog
-
v1.0 (major) ·
Use it from an AI agent
Open in your coding agent
Add CleanedWeb to your agent as an MCP server, such as a custom connector in Claude or ChatGPT, then sign in with your CleanedWeb account. The agent can then find this API, run it and read the records. An API key with the read and run scopes works too.
https://api.cleanedweb.com/mcp?profile=catalog
Then ask, for example: Use CleanedWeb to get 25 records from the Tori Marketplace Listings API.
The agent calls get_api with generated_adaca3f15744afcc1d75f3eb, then run_api. Runs are charged like any other run. See Connect an MCP client.
Coverage
- Category
- Commerce
- Countries
- Finland
- Languages
- Finnish
Reach. A run reads until the source ends or your max_items, timeout_seconds or budget stops it.
CleanedWeb is not affiliated with Tori.