{"name":"FINN Torget Item Details API","description":"One FINN Torget marketplace ad per URL, with title, price, description, condition, location and image.","api_id":"generated_182806d1757cefa896f8f0a6","slug":"finn-torget-item-details-api","source":{"name":"Finn.no Marketplace Listings","domain":"finn.no","url":"https://www.finn.no/"},"category":"commerce","countries":[],"languages":[],"record_types":[],"tags":[],"limitations":[],"updated":"2026-11-22","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.0","versions":[{"major":1,"latest_minor":"1.0","status":"current","sunset_at":null}],"changelog":[{"version":"1.0","date":"2026-11-21T09:14:37.000Z","kind":"major","changes":[]}],"version_note":"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.","endpoints":[{"endpoint_id":"generated_182806d1757cefa896f8f0a6_search","name":"Get FINN Torget Item Details by URL","description":"Return the one record of a page of this kind, given the page's URL on the site.","definition_version":"4a3f1b3f0b00f4a5dd80567cdf93b6ac7954d8242f57f4f27461115febc2bf5e","method":"POST","path":"/v1/catalog/public/apis/generated_182806d1757cefa896f8f0a6/endpoints/generated_182806d1757cefa896f8f0a6_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_182806d1757cefa896f8f0a6/endpoints/generated_182806d1757cefa896f8f0a6_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","minLength":1,"description":"A page of the same kind as the build page, on finn.no: its path matches /recommerce/forsale/item/{int}. It need not be the build page.","examples":["https://www.finn.no/recommerce/forsale/item/463444606"]}},"required":["url"],"additionalProperties":false},"output_schema":{"type":"object","properties":{"title":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"bildegalleri":{"type":"string"},"description":{"type":"string"},"sku":{"type":"string"},"brand":{"type":"string"},"price":{"type":"string"},"currency":{"type":"string"},"availability":{"type":"string"},"condition":{"type":"string"},"image":{"type":"string"},"ad_view_type_label":{"type":"string"},"category_id":{"type":"string"},"category":{"type":"string"},"category_parent_id":{"type":"string"},"category_parent":{"type":"string"},"category_parent_parent_id":{"type":"string"},"category_parent_parent":{"type":"string"},"disposed":{"type":["boolean","string"]},"cameras_slr_type":{"type":"string"},"images":{"type":"array","items":{"properties":{"height":{"type":["null","number","string"]},"uri":{"type":["null","string"]},"width":{"type":["null","number","string"]}},"type":["null","object"]}},"is_webstore":{"type":["boolean","string"]},"location_position_accuracy":{"type":["number","string"]},"location_position_map_image":{"type":"string"},"location":{"type":"string"},"location_country_code":{"type":"string"},"location_country_name":{"type":"string"},"meta_edited":{"type":"string"},"meta_has_been_published":{"type":["boolean","string"]},"meta_is_inactive":{"type":["boolean","string"]},"meta_is_legacy_schema":{"type":["boolean","string"]},"meta_is_own_ad":{"type":["boolean","string"]},"meta_schema_name":{"type":"string"},"meta_should_index":{"type":["boolean","string"]},"meta_user_owner":{"type":["boolean","string"]},"beskrivelse_av_varen":{"type":"string"},"photo_equipment_type":{"type":"string"}},"additionalProperties":true,"required":["title","url"]},"output_schema_note":"Some fields the source returns are not published here (identifiers, personal details and page-building noise). A record can carry fields this schema does not list, so additionalProperties is true. Do not reject a record for an extra field. The live contract, linked as live_contract, lists every field the saved definition declares.","examples":[{"kind":"saved_validation_records","saved_at":"2026-11-21T09:14:37.503Z","live_verified":false,"request":{"input":{"url":"https://www.finn.no/recommerce/forsale/item/463444606"}},"records_shown":1,"records_saved":1,"records":[{"ad_view_type_label":"Til salgs","availability":"InStock","beskrivelse_av_varen":"Beskrivelse av varen\nTilstand: Pent brukt - I god stand\nMerke: Leica\nType: Digital\nTilgjengelige objektiver – selges separat, førstemann til mølla :\nErnst Leitz Elmar 90mm f/4 – M-fatning, vintage\n2 500 kr\nErnst Leitz Elmar 50mm f/2.8 – M-fatning, vintage.\n4500 kr\nM-grip / Gmp products til Leica M6\n1000 kr\nRena / Oslo. Ta gjerne kontakt for spørsmål.\n2450 Rena","bildegalleri":"(1/11)  37Legg til som favoritt","brand":"Leica","cameras_slr_type":"Digital","category":"Systemkameraer","category_id":"66","category_parent":"Foto og video","category_parent_id":"3904","category_parent_parent":"Elektronikk og hvitevarer","category_parent_parent_id":"93","condition":"UsedCondition","currency":"NOK","description":"Tilgjengelige objektiver – selges separat, førstemann til mølla : Ernst Leitz Elmar 90mm f/4 – M-fatning, vintage 2 500 kr Ernst Leitz Elmar 50mm f/2.8 – M-fa","disposed":false,"image":"https://images.finncdn.no/dynamic/1280w/item/463444606/23f70b90-6b86-49d9-8cdf-87fcbc8e7f75","is_webstore":false,"location":"Rena","location_country_code":"NO","location_country_name":"Norge","location_position_accuracy":5,"location_position_map_image":"https://maptiles.finncdn.no/staticmap?lat=61.13479934896168&lng=11.364092866033056&zoom=12&size=400x300&maptype=norwayVector&showPin=false","meta_edited":"2026-06-19T16:33:20.085624+02:00","meta_has_been_published":true,"meta_is_inactive":false,"meta_is_legacy_schema":false,"meta_is_own_ad":false,"meta_schema_name":"recommerce-sell","meta_should_index":true,"meta_user_owner":true,"price":"123","sku":"463444606","title":"Leica M objektiver","url":"https://www.finn.no/recommerce/forsale/item/463444606"}]}],"request_example":{"body":{"input":{"url":"https://www.finn.no/recommerce/forsale/item/463444606"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_182806d1757cefa896f8f0a6/endpoints/generated_182806d1757cefa896f8f0a6_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"url\": \"https://www.finn.no/recommerce/forsale/item/463444606\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_182806d1757cefa896f8f0a6/endpoints/generated_182806d1757cefa896f8f0a6_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/finn-torget-item-details-api/","markdown":"https://cleanedweb.com/catalog/finn-torget-item-details-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_182806d1757cefa896f8f0a6/endpoints/generated_182806d1757cefa896f8f0a6_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/finn-torget-item-details-api/","markdown":"https://cleanedweb.com/catalog/finn-torget-item-details-api/index.md","contract":"https://cleanedweb.com/catalog/finn-torget-item-details-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
