API & iframe

Use our vehicle database on your own website

Add the vehicle selector and dyno screen from our home page to your site with a single line of code, or pull all the data into your own system via the API. Brand, model, generation, engine; stock and Stage power/torque, ECU and engine data.

Get a quote Live preview
  • 165+ Brands
  • 1.800+ Models
  • 3.100+ Generations
  • 14.000+ Engines

Two ways to use it

A ready-made screen or raw data — your choice

Both are fed by the same database and deliver the same data. The only difference is how you use it.

No coding needed

iframe — ready-made vehicle selector

The vehicle selector and dyno screen from our site, exactly as it is, on your site. Just paste the code we give you into your page.

  • Brand → model → generation → engine selection
  • Stage 1 / Stage 2 cards and dyno chart
  • Light/dark theme, accent colour and language (TR / EN / DE)
  • The selected vehicle is reported to your page (e.g. to fill your form)
For developers

API — raw JSON data

Pull the data from your own server and use it in your own system with your own design.

  • Simple REST endpoints, JSON responses
  • Key authentication (X-API-Key)
  • Stable field names — versioned (/v1)
  • Daily quota and usage headers

Live preview

The screen your customers will see

The selector below is the same screen that is added to your site with the iframe. Pick a vehicle and try it.

Select—

Dyno Curve

Software Level

Pick your vehicle — stage figures and the dyno curve build up here.

Software Level

In the iframe version, engine code, ECU/TCU, bore/stroke, compression, tuning method, Stage 3 and E85 values are also shown.

Data

What data do you get?

One package: every key gets all the data. No prices or order information — vehicle data only.

  • Vehicle treeCategory, brand, model, generation and engine, each with a stable ID.
  • Fuel and displacementPetrol, diesel, hybrid, electric, LPG; engine displacement (cc).
  • YearsStart and end year of the generation.
  • Stock power and torqueFactory horsepower (HP) and torque (Nm).
  • Stage 1-3 and E85Power and torque after tuning.
  • ECU and TCUEngine and transmission control unit type.
  • Engine codeManufacturer engine code.
  • Bore/stroke and compressionCylinder bore × stroke and compression ratio.
  • Tuning methodHow the software is written (e.g. OBD, bench).

Pricing

Clear pricing, no hidden fees

Both are annual subscriptions; the iframe also has a one-time setup fee. The data is the same in every plan: all vehicle data.

No coding needed

iframe

€550/ year

+ €450 one-time setup

  • Ready-made vehicle selector + dyno screen
  • Theme, accent colour and language settings
  • Personal key and allowed-website setup for your site
  • Catalogue updates included
Get a quote

For developers

API

€1,750/ year

No setup fee

  • All vehicle data, JSON, /v1 endpoints
  • Your own design, your own system
  • Daily quota and usage tracking
  • Catalogue updates included
Get a quote

Prices are in euros. For high traffic we set your quota together; if you want both iframe and API, get in touch.

How do I start?

On your site in four steps

  1. 01

    Contact us

    Tell us what you need (iframe or API) and the website address; we prepare an offer based on your expected usage.

  2. 02

    Receive your key

    We create your personal key, register your website address and set your daily quota.

  3. 03

    Add it to your site

    For the iframe, paste the code into your page; for the API, your developer connects to the endpoints.

  4. 04

    Use it

    As the catalogue is updated, new vehicles appear on your site automatically. Your quota can be raised if needed.

For developers

Technical details

A short, stable contract: key in the header, JSON responses, field names fixed per version.

<iframe id="ats-vehicle"
  src="https://www.atsmapping.com/embed?key=ats_pk_ANAHTARINIZ&lang=tr&theme=light"
  width="100%" height="760" style="border:0" loading="lazy"
  title="ATS Mapping"></iframe>

<script>
  // İsteğe bağlı: yükseklik otomatik ayarlansın + seçilen aracı alın
  window.addEventListener('message', function (e) {
    if (e.origin !== 'https://www.atsmapping.com' || !e.data || e.data.source !== 'ats-vehicle') return;
    if (e.data.type === 'resize') document.getElementById('ats-vehicle').style.height = e.data.height + 'px';
    if (e.data.type === 'select') console.log(e.data.brand, e.data.model, e.data.generation, e.data.engine);
  });
</script>

Authentication

Add the X-API-Key header to every request. The API key (ats_live_…) is secret — use it on your server only. The iframe key (ats_pk_…) works only on the websites registered for you.

Endpoints

  • GET /api/v1/meYour key, quota and usage today
  • GET /api/v1/categoriesVehicle categories
  • GET /api/v1/brands?categoryId=…Brands (by category)
  • GET /api/v1/models?brandId=…Models of a brand
  • GET /api/v1/generations?modelId=…Generations of a model
  • GET /api/v1/engines?generationId=…Engines of a generation with all data

Quota

Every key has a daily request quota. Responses include the X-Quota-Limit, X-Quota-Used and X-Quota-Remaining headers. The quota resets daily at midnight UTC.

Error codes

  • 401 API_KEY_REQUIREDNo key sent
  • 401 API_KEY_INVALIDInvalid key
  • 401 API_KEY_REVOKEDKey revoked
  • 401 API_KEY_EXPIREDKey expired
  • 403 ORIGIN_NOT_ALLOWEDiframe on a website that is not allowed
  • 400 INVALID_PARAMETERMissing or invalid parameter
  • 429 QUOTA_EXCEEDEDDaily quota used up (see retryAt)

iframe events (postMessage)

The iframe sends two messages to your page: "resize" (height — the iframe grows without a scrollbar) and "select" (the selected brand, model, generation and engine). Messages are sent only to your site's origin.

FAQ

Common questions

Are prices shown too?

No. The API and iframe provide vehicle data only; there are no prices, orders or account data.

On which websites can I use the iframe?

Your key works on the website addresses we register for you (subdomains can be included). Opened on another site, it shows a "cannot be used on this website" notice.

Can I change the look?

In the iframe you can choose a light/dark theme, an accent colour and the language (Turkish, English, German). For a fully custom design, use the API.

What happens when the daily quota runs out?

New requests are rejected for that day and the iframe shows a "daily limit reached" message. The quota resets the next day at midnight UTC; we can raise it if you need more.

Is the data up to date?

The iframe and API are fed directly by the catalogue on our site. New vehicles and corrections added to the catalogue appear on your side automatically.

Do I need technical knowledge?

Not for the iframe: just paste the code we give you into your page. Connecting your own system to the API requires a developer.

What if my key falls into the wrong hands?

Let us know; we revoke it immediately and issue a new one. Keep the API key on your server only, never in page code.

Let's get started

Add the vehicle database to your site

Tell us how you want to use it and your expected traffic; we will prepare a suitable offer and your key.

Request a quote