{"name":"FINN Car Details API","description":"One FINN car ad per URL, with title, price, make, model, model year, mileage, fuel, transmission, body type, power, colour and seats.","api_id":"generated_1f178825ecbdbc54bf906cc0","slug":"finn-car-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:15:26.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_1f178825ecbdbc54bf906cc0_search","name":"Get FINN Car Details by URL","description":"Return the one record of a page of this kind, given the page's URL on the site.","definition_version":"28233b0bdb92d36100951cc39f65ce1985573d229a2ef337897a321c0b3bc691","method":"POST","path":"/v1/catalog/public/apis/generated_1f178825ecbdbc54bf906cc0/endpoints/generated_1f178825ecbdbc54bf906cc0_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_1f178825ecbdbc54bf906cc0/endpoints/generated_1f178825ecbdbc54bf906cc0_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 /mobility/item/{int}. It need not be the build page.","examples":["https://www.finn.no/mobility/item/474489290"]}},"required":["url"],"additionalProperties":false},"output_schema":{"type":"object","properties":{"title":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"beskrivelse":{"type":"string"},"sted":{"type":"string"},"annonseinformasjon":{"type":"string"},"images":{"type":"array","items":{"properties":{"url":{"type":["null","string"]}},"type":["null","object"]}},"make":{"type":"string"},"price":{"type":["number","string"]},"currency":{"type":"string"},"availability":{"type":"string"},"condition":{"type":"string"},"image":{"type":"string"},"pris_ekskl_omreg":{"type":"string"},"arsavgift":{"type":"string"},"model":{"type":"string"},"modellar":{"type":"string"},"body_type":{"type":"string"},"fuel":{"type":"string"},"power":{"type":"string"},"slagvolum":{"type":"string"},"mileage":{"type":"string"},"transmission":{"type":"string"},"hjuldrift":{"type":"string"},"vekt":{"type":"string"},"seats":{"type":"string"},"color":{"type":"string"},"bilen_star_i":{"type":"string"},"neste_frist_for_eu_kontroll":{"type":"string"},"avgiftsklasse":{"type":"string"},"spec_1_gang_registrert":{"type":"string"},"eiere":{"type":"string"},"salgsform":{"type":"string"},"year":{"type":"string"},"category":{"type":"string"},"category_path":{"type":"array","items":{"type":["null","string"]}},"kjente_feil_mangler_eller_synlige_skader":{"type":"string"},"er_det_gjort_storre_reparasjoner":{"type":"string"},"er_eller_har_motoren_vaert_trimmet":{"type":"string"},"har_bilen_heftelser_gjeld":{"type":"string"},"fra_1_423_kr_mnd_url":{"type":"string"},"maksimal_tilhengervekt":{"type":"string"},"dorer":{"type":"string"},"storrelse_pa_bagasjerom":{"type":"string"},"fra_2_056_kr_mnd_url":{"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:15:26.199Z","live_verified":false,"request":{"input":{"url":"https://www.finn.no/mobility/item/474489290"}},"records_shown":1,"records_saved":1,"records":[{"annonseinformasjon":"FINN-kode 474489290 Sist oppdatert 20. september 2026, 11:13","arsavgift":"Les mer","availability":"InStock","avgiftsklasse":"Personbil","beskrivelse":"Satt ned prisen før den blir satt bort for vinterlagring Byttet reg.reim, vannpumpe og justert ventiler i juli. Meget pen bil, strøkne seter og dørtrekk og har ikke de typiske merkene av skader og slitasje som man ofte ser på disse i interiørene. Skal få tatt interiørbilder. I mai fikk den rustfrieksos fra front der eksos kommer ned ved bunnpanne, rustfri kat, ragazzone demper. Sitter zender bakpotte uten dempere på den. Bare eksos kostet 22.000kr Ny olje og filter i juli. Den mister noen ganger litt kraft rundt 4500rpm og mistenker temp.sensor da denne ikke er byttet og pleier å vise feil verdi i følge de som kjenner bilene. Morsom bil med ren kjøreglede og god lyd. Kan vurdere innbytte i noe annet","bilen_star_i":"Norge","body_type":"Coupe","category":"GTV","category_path":["Bil","Biler","Alfa Romeo","GTV"],"color":"Rød","condition":"UsedCondition","currency":"NOK","eiere":"5","er_det_gjort_storre_reparasjoner":"Nei","er_eller_har_motoren_vaert_trimmet":"Nei","fra_1_423_kr_mnd_url":"https://www.finn.no/finance/marketplace/loan/474489290?initialDownPayment=35680&initialPeriod=5&initialPrice=101942","fuel":"Bensin","har_bilen_heftelser_gjeld":"Nei","hjuldrift":"Forhjulsdrift","image":"https://images.finncdn.no/dynamic/default/item/474489290/5f476357-769f-4e01-93b6-649a89ecb0a2","kjente_feil_mangler_eller_synlige_skader":"Nei","make":"Alfa Romeo","mileage":"119 500 km","model":"GTV","modellar":"1995","neste_frist_for_eu_kontroll":"18.03.2027","power":"200 hk","price":101942,"pris_ekskl_omreg":"100 000 kr","salgsform":"Bruktbil til salgs","seats":"4","slagvolum":"2 L","spec_1_gang_registrert":"30.09.1995","sted":"3320 Vestfossen","title":"Alfa Romeo GTV","transmission":"Manuell","url":"https://www.finn.no/mobility/item/474489290","vekt":"1 430 kg","year":"1995"}]}],"request_example":{"body":{"input":{"url":"https://www.finn.no/mobility/item/474489290"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_1f178825ecbdbc54bf906cc0/endpoints/generated_1f178825ecbdbc54bf906cc0_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/mobility/item/474489290\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_1f178825ecbdbc54bf906cc0/endpoints/generated_1f178825ecbdbc54bf906cc0_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-car-details-api/","markdown":"https://cleanedweb.com/catalog/finn-car-details-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_1f178825ecbdbc54bf906cc0/endpoints/generated_1f178825ecbdbc54bf906cc0_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/finn-car-details-api/","markdown":"https://cleanedweb.com/catalog/finn-car-details-api/index.md","contract":"https://cleanedweb.com/catalog/finn-car-details-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
