INTEGRATION GUIDE

Check vehicles from your server.

Authentication

Create an account and copy your password from My Account. Use Authorization: Bearer TU_CLAVE or the header X-API-Key. Don't put keys in URLs, public HTML, or browser JavaScript.

curl "https://TU_DOMINIO/api/search.php?brand=Abarth&model=124&y1=2018&y2=2018&limit=10" \
  -H "Authorization: Bearer TU_CLAVE"

Filters and pagination

Parameter	Use
brand / brand_id	Exact brand or identifier.
model / model_id	Part of the name or identifier.
cc, kw, cv	Exact numerical values.
y1, y2	Overlap with the interval of years. For a specific year, use both with the same value.
limit	Between 1 and 100; default 50.
offset	From 0. Use next_offset while has_more is true.

{
  "results": [
    {"id": 1, "brand": "Abarth", "model": "124 Spider",
     "cc": 1368, "kw": 125, "cv": 170, "engine_code": "552 53 268",
     "year_start": 2018, "year_end": 2019, "fuel": null, "body": null}
  ],
  "count": 1, "limit": 10, "offset": 0,
  "has_more": false, "next_offset": null, "tokens_remaining": 99
}

Illustrative example of format. The specific results depend on the catalog.

Updated catalogue filters

generation, fuel, technology, engine: Exact text values.

fuel=Diésel&technology=TDI&engine=BKD

Balance and limits

Each 200 response consumes a database query, even if there are no matches. Errors do not consume balance. The limit per minute is shared between the keys of the same user and is checked over the last 60 seconds.

The current monthly database queries are spent first and then the additional purchased ones. The recharges are kept when renewing the month. Free plans renew upon use or via cron; Payment plans are only replenished after a verified payment. If the period expires, your monthly balance is no longer available.

HTTP	Meaning
400	Invalid filters or year range.
401	API key missing.
402	No database queries available.
403	Inactive key or subscription without access.
429	Limit per minute; Retry-After: 60.
500 / 503	Service or connection error.

Data Scope

A null trailing year indicates that the trailing year is not known, and is treated as an open range when filtering. It does not prove that the model is still being manufactured. Inverted ranges are excluded pending review. Fuel, body and other fields may not be reported. These data do not guarantee the compatibility of a spare part: this relationship must be provided and validated by the store.