Parts data you can query, not scrape

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 key
Anonymous
200 req/day per IP
Free API key
1,000 req/day
Commercial
Higher limits on request

Quick start

Any 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}
}

Authentication

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

Endpoints

EndpointReturns
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/statsCoverage statistics for the whole database.
GET /api/key/statusReturns your current daily quota and consumption. Does not count against the quota.

Response fields

FieldMeaning
codeYour part code / ERP number. Also the product page path: /part/{code}/
brandVehicle manufacturer the part is catalogued under.
modelModel and engine / drivetrain descriptor from the source catalogue.
oemOEM number in original formatting, hyphens preserved.
oem_cleanSpace-separated normalised cross-reference set (all known interchangeable numbers).
coreCore size as width x height x thickness in mm. Empty when the source catalogue does not state one — we do not guess.
confidenceInternal confidence score, 0–100, aggregated from source agreement and dimension plausibility.
slugStable record identifier.
categoryNormalised category, e.g. Radiator, Condenser, Thermostat.
keywordsAdditional searchable keywords, when present.

Attribution

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.

What is not allowed

Quotas and fair use

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.

Embed on your site

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.

Request a key

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.

Applications are reviewed once a day. No credit card, no sales call.