AutoMarketAPI Developer Reference

Welcome to the official developer manual. AutoMarketAPI delivers standardized REST access to 1,500,000+ active verified European vehicles, technical specifications, high-definition photo galleries, and real-time market valuations across 8 countries.

Base URL: All production API requests are served over HTTPS: https://api.automarketapi.com

Authentication

Pass your secret API key via the X-API-Key request header.

Request Header:

X-API-Key: ama_live_your_32_character_token_here

Quickstart Integration Snippets

Copy-paste code examples to query live vehicle data in your application:

Python (requests) example.py

import requests

headers = {
    "X-API-Key": "YOUR_API_KEY"
}

# 1. Search Polish Otomoto inventory for BMW 3-Series under 200,000 PLN
response = requests.get(
    "https://api.automarketapi.com/v1/poland/cars",
    headers=headers,
    params={"make": "BMW", "model": "Seria 3", "max_price": 200000, "limit": 10}
)
data = response.json()
print(f"Found {data['total']} vehicles. First vehicle: {data['results'][0]['title']}")

Node.js (fetch / axios) example.js

const response = await fetch("https://api.automarketapi.com/v1/swiss/valuation?make=BMW&model=320&year=2020", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const valuation = await response.json();
console.log(`Median Price in Switzerland: ${valuation.market_median_chf} CHF`);

GET

/v1/poland/cars

Search, filter, and paginate through 250,000+ active Polish vehicles on Otomoto.pl. Includes prices in both Polish Złoty (PLN) and Euro (EUR).

Query Parameters

Parameter	Type	Description
make	string	Manufacturer (e.g. BMW, Audi, Volkswagen, Toyota)
model	string	Model name (e.g. Seria 3, Golf, A4, Yaris)
min_price	integer	Minimum price in PLN
max_price	integer	Maximum price in PLN
min_year	integer	Minimum registration year (e.g. 2019)
limit	integer	Results per page (1 to 100, default: 20)

GET

/v1/swiss/valuation

Market valuation engine for Switzerland (Autolina.ch). Calculates average market prices, median values, sample size, and suggested export/arbitrage discount thresholds.

Example Request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.automarketapi.com/v1/swiss/valuation?make=BMW&model=320&year=2020"

GET

/v1/europe/cars

Query 1,060,000+ verified vehicles across 7 European AutoScout24 countries: Germany (DE), Netherlands (NL), Spain (ES), Italy (IT), Belgium (BE), France (FR), Austria (AT).

Example Request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.automarketapi.com/v1/europe/cars?country=DE&make=Porsche&model=911&min_year=2021"

GET

/health

Live cluster heartbeat and inventory size status across all regional pipelines. No authentication required.