{"spec":"TKR-SPEC","version":"v1","date":"2026-11-20","base":"https://www.takaros.com/","header_line":"TKR-SPEC: v1 | BASE: https://www.takaros.com/ | SCHEMA: <columns>","id":{"pattern":"^TKR-[0-9]+$","official_form":"takaros.com/TKR-1001","rule":"A TKR number is only genuine if BASE + number exists. Numbers never change."},"layers":[{"name":"inventory","content":"counts per type and colour, no individual objects"},{"name":"nano","columns":["id","type","title","brand","model","designer","year_or_period","color","price_eur","country"]},{"name":"micro","columns":["id","type","title","real","brand","model","designer","year_or_period","material","quantity","hours","hp","color","trim_color","status","price_eur","estimate_eur","country","city","auction_planned_end"]},{"name":"full","content":"one object, all fields, source of facts, seller link","url":"https://www.takaros.com/kaart/{id}/json"},{"name":"status","content":"available | not_available | unknown","url":"https://www.takaros.com/kaart/status?ids={id,id}"}],"columns":{"id":"Card number, starts with TKR-. Never changes.","type":"Kind of object (fixed code).","title":"Title as the seller writes it, shortened. The full title is on the full card.","real":"1 = real full-size object, 0 = scale model or toy.","brand":"Brand or manufacturer, as the seller writes it.","model":"Model, as the seller writes it.","designer":"Designer or maker.","year_or_period":"Year, or a period such as 1980-1990.","material":"Material, as the seller states it.","quantity":"Number of pieces in this single lot or listing.","hours":"Operating hours (machinery).","hp":"Power in hp (machinery).","color":"Colour(s) as stated by the seller, comma-separated (fixed codes).","trim_color":"Trim colour, such as rims (fixed code).","status":"Sale type: for_sale, auction, after_sale (unsold at auction, still offered by the house), price_on_request or sold.","price_eur":"Asking price in euro, excluding VAT. Empty for an auction: the bid is on the seller's page.","estimate_eur":"Estimate as the seller shows it, as a range.","country":"Country where the object is (ISO 3166-1 alpha-2).","city":"City where the object is.","auction_planned_end":"Planned end of the auction (ISO 8601). An auction can extend."},"codes":{"type":["tractor","excavator","wheel_loader","forklift","chair","bar_stool","car","other"],"color":["yellow","green","red","blue","orange","white","black","grey"],"sale":["for_sale","auction","after_sale","price_on_request","sold"],"availability":["available","not_available","unknown"]},"status":{"valid_hours":6,"rule":"A report from the seller's status agent is valid for 6 hours. Without a fresh report the status becomes unknown. Silence is never \"available\".","sources":{"agent":"reported by the seller's status agent from the seller's own listing, signed","card":"only what the card states"}},"data_rules":["All facts come one to one from the seller. Takaros adds nothing.","Allowed: changing the form (a word to a code, inches to centimetres). Not allowed: adding a judgement (a condition score, authenticity, an estimate the seller did not give).","Empty field = not stated by the seller. Never guess.","The current bid of an auction is only on the seller's page."],"feed":{"location":"https://<domain>/.well-known/tkr.json","verification":{"dns_txt":"takaros-verificatie=<token>","file":"https://<domain>/.well-known/tkr-verificatie.txt","meta_tag":"<meta name=\"takaros-verificatie\" content=\"<token>\"> in the head of the home page"},"fetched":"hourly","top_level":{"spec":"TKR-SPEC","version":"v1","seller":{"name":"string"},"items":"array, max 10000"},"item_required":["id","url (on the verified domain)","title","type","availability (available | not_available)","country"],"item_optional":["description","brand","model","designer","year","period","colors","price_eur","price_eur_incl_vat","sale (for_sale | auction | after_sale | price_on_request)","auction_end","city","images","attributes"],"attribute":{"name":"as the seller writes it (required)","value":"verbatim (required)","key":"optional fixed key, e.g. engine_cc","number":"optional number","unit":"optional UN/CEFACT code, e.g. CMQ"},"rule":"Items that disappear from the file become not_available; the TKR number stays.","status_tag":{"script":"<script async src=\"https://www.takaros.com/t.js\" data-takaros=\"<domain id from the Search Console>\"></script>","what":"Reports only the address of a viewed object page; Takaros then fetches the page itself and reads schema.org Product availability, or the meta line below. No visitor data, no cookie.","meta":"<meta name=\"takaros-status\" content=\"available | not_available\">","ping":"GET https://www.takaros.com/kaart/ping?url=<page address> from the seller's own system, e.g. at the moment of sale"},"stability":"What a seller puts on their site never needs renewing: the verification token does not expire, the names takaros-verificatie and takaros-status, the script address /t.js with data-takaros and the address /.well-known/tkr.json do not change, and an older format version keeps being read at the same address."},"endpoints":{"mcp":"https://www.takaros.com/kaart/mcp","search":"https://www.takaros.com/kaart/zoek","status":"https://www.takaros.com/kaart/status","llms":"https://www.takaros.com/llms.txt","spec_page":"https://www.takaros.com/spec"},"use":"Anyone may create cards in this format. Status and confirmation of a TKR number come only from takaros.com."}