A JSON API over 31,488 catalogued cooling-system parts from 289 brands — OEM cross-reference, fitment, and the part dimensions most catalogues leave out.
Quick startRequest a free keyAny request works without a key, up to the anonymous daily limit. Add your key as an X-API-Key header to lift it.
# anonymous curl "https://api.ikosdb.com/api/search?q=16400-0H120" # with a key curl -H "X-API-Key: ikos_yourkey" \ "https://api.ikosdb.com/api/search?q=toyota+avensis"
{ "query": "16400-0H120", "total_matched": 2, "total_display": 2, "groups": [{ "category": "Radiator", "products": [{ "code": "116464", "brand": "TOYOTA", "model": "Avensis 2.0 24 AT/1A2", "oem": "164000H120", "oem_clean": "164000H120 164000H121", "core": "378x625x26", "confidence": 92, "category": "Radiator" }] }], "quota": {"mode": "anon", "limit": 200, "used": 1, "remaining": 199} }
Send the key in either of these two ways. Both are accepted; the header is preferred.
# header (preferred) X-API-Key: ikos_yourkey # query parameter ?q=16400-0H120&key=ikos_yourkey
| Endpoint | Returns |
|---|---|
| GET /api/search?q= | Search by OEM number, brand, model, part code or category. Curly: matching ignores spaces, hyphens and dots, so 164000H120 and 16400-0H120 are the same query. |
| GET /api/vin?vin= | Decode a 17-character VIN and return the parts that fit the decoded vehicle. |
| GET /api/stats | Coverage statistics for the whole database. |
| GET /api/key/status | Returns your current daily quota and consumption. Does not count against the quota. |
| Field | Meaning |
|---|---|
| code | Your part code / ERP number. Also the product page path: /part/{code}/ |
| brand | Vehicle manufacturer the part is catalogued under. |
| model | Model and engine / drivetrain descriptor from the source catalogue. |
| oem | OEM number in original formatting, hyphens preserved. |
| oem_clean | Space-separated normalised cross-reference set (all known interchangeable numbers). |
| core | Core size as width x height x thickness in mm. Empty when the source catalogue does not state one — we do not guess. |
| confidence | Internal confidence score, 0–100, aggregated from source agreement and dimension plausibility. |
| slug | Stable record identifier. |
| category | Normalised category, e.g. Radiator, Condenser, Thermostat. |
| keywords | Additional searchable keywords, when present. |
Free and standard keys must credit the source with a visible link on any page, app or export that displays the data. Put it in the footer or beside the result table:
<a href="https://ikosdb.com/" rel="dofollow">Parts data by IKOS</a>
Keys are issued after we check the link exists. Without it the data has no reason to be free.
Anonymous traffic is capped per IP per day so the database cannot be walked. A key raises the cap and gives you per-key analytics from /api/key/status. Quotas reset at 00:00 UTC.
No key, no backend, no script to maintain. Drop one <iframe> on a page and your visitors get a working OEM lookup — with IKOS attribution and results linking to the part pages. Free, no signup.
Copy this. Width is responsive; 560px fits the search box plus six results.
<iframe src="https://ikosdb.com/embed?theme=light" width="100%" height="560"
style="border:0;max-width:760px" title="IKOS OEM lookup"></iframe>
Optional parameters: theme=dark, brand=TOYOTA, q=16400-0H120 to pre-fill. Quotas apply per visitor IP. A logo-free white-label version carrying your own contact details is available on request — use the form below.
Free keys are issued for sites and tools that add something on top of the data. Tell us where it will appear — we look at the page before approving.