Hakuhistoria
Tägit
Luo omia tägejä autojen ryhmittelyyn — kiinnostavuustason, myynnin vaiheen, maan tai minkä tahansa haluamasi kriteerin mukaan. Tägit liitetään hakutuloksiin Chrome-laajennuksessa.
Yleistä
Abco AutoTax™ API on REST-pohjainen JSON-rajapinta, joka palauttaa suomalaisen autoveron (rekisteröintivero) arvion mille tahansa ajoneuvolle. Kaikki pyynnöt autentikoidaan API-avaimella.
Base URL:
https://abco.ai/token_api.php
Autentikaatio
Lisää API-avain jokaiseen pyyntöön HTTP-otsikkona tai JSON-kenttänä:
X-Api-Key: YOUR_API_KEY
Content-Type: application/json
Hakuhistoria
POST /token_api.php?action=tagged_searches
Palauttaa käyttäjän analyysit tägeineen. Suodatettavissa tägin mukaan.
| Kenttä | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| api_key | string | Kyllä | API-avain |
| tag_id | integer | Ei | Suodata tägin mukaan |
| limit | integer | Ei | Max tuloksia (oletus 50, max 200) |
Ajoneuvon data-schema
Jokainen analyysi palauttaa kattavan ajoneuvoprofiilin. Alla on kaikki tuetut kentät — osa on aina saatavilla, osa vaatii rikastetun datan (huoltohistoria, varustelistat jne.).
🚗 Perustiedot
{
"make": "Mercedes-Benz", // Merkki
"model": "C 220 d", // Malli
"variant": "AMG Line", // Variantti / trim
"year": 2021, // Vuosimalli
"first_reg_date": "2021-03-15", // Ensimmäinen rekisteröintipäivä
"mileage_km": 45000, // Kilometrit
"fuel_type": "diesel", // Polttoaine
"gearbox": "automatic", // Vaihteisto
"drive": "RWD", // Vetotapa
"doors": 4, // Ovien lukumäärä
"body_type": "sedan", // Korimalli
"color": "Obsidianblack", // Väri
"seats": 5, // Istuinpaikat
"power_kw": 143, // Teho kilowateissa
"power_hp": 194, // Teho hevosvoimeissa
"engine_cc": 1950, // Moottorin tilavuus (cc)
"co2_gkm": 131, // CO₂-päästöt (g/km)
"euro_class": "Euro 6d" // Päästöluokka
}
💶 Hinta ja veroarvio
{
"listing_price_eur": 28900, // Ilmoitettu hinta
"assessed_value_eur": 24100, // Verotusarvo (Abco-laskenta)
"tax_percentage": 9.7, // Autoveroprosentti (%)
"tax_amount_eur": 2338, // Arvioitu autovero (€)
"confidence": 0.91, // Varmuus 0–1
"tax_basis": "db_match", // Peruste: db_match / ai_estimate
"db_decision_id": "VER-2024-...", // Veropäätösviite (jos löytyi)
"notes": "..." // Huomiot arviosta
}
🔧 Varusteet
{
"equipment": [
"Panoraamakatto",
"Nahkaverhoilu",
"Adaptiivinen vakionopeussäädin",
"Pysäköintikamera 360°",
"Langaton lataus",
"Head-up display",
"Burmester-äänentoisto",
"Ambient-valaistus",
"Kuumennettavat etuistuimet"
// ... kaikki ilmoituksesta poimitut varusteet
],
"packages": [
"AMG-ulkonäkö paketti",
"Premium-paketti"
]
}
📋 Huoltohistoria (rikastettu)
{
"service_history": {
"available": true,
"verified": true, // Merkillä tarkistettu
"records": [
{
"date": "2023-06-12",
"mileage_km": 32000,
"type": "full", // full / oil / inspection
"workshop": "MB Helsinki",
"items": ["Öljynvaihto","Jarrulevyt","Renkaat"]
}
],
"last_service_km": 32000,
"next_service_km": 50000
}
}
🚨 Vauriohistoria (rikastettu)
{
"damage_history": {
"available": true,
"clean": false, // true = ei merkintöjä
"incidents": [
{
"date": "2022-09-03",
"type": "rear_collision", // front / rear / side / hail / flood
"severity": "minor", // minor / moderate / major / total_loss
"repaired": true,
"repair_cost_eur": 1850,
"source": "Carfax"
}
]
}
}
🏠 Omistushistoria (rikastettu)
{
"ownership": {
"owners_count": 2,
"last_owner_type": "private", // private / company / dealer
"country_history": ["DE"], // Maat (ISO 3166-1 alpha-2)
"import_country": "DE"
}
}
🏪 Myyjän tiedot
{
"seller": {
"name": "Autohaus München GmbH",
"type": "dealer", // dealer / private
"country": "DE",
"city": "München",
"platform": "mobile.de",
"listing_url": "https://www.mobile.de/...",
"listing_id": "348291847"
}
}
🏷️ Tägit
{
"tags": [
{ "id": 12, "name": "Kiinnostava", "color": "#10b981" },
{ "id": 7, "name": "Saksa", "color": "#f59e0b" }
]
}
🕐 Metatiedot
{
"search_id": 94821,
"created_at": "2025-06-04T14:22:11Z",
"source": "extension", // extension / api / dashboard
"api_version": "1.0"
}
Tägit API
Listaa tägit
POST ?action=list_tags
// Vastaus
{
"ok": true,
"tags": [
{ "id": 1, "name": "Kiinnostava", "color": "#10b981", "created_at": "..." }
]
}
Luo tägi
POST ?action=create_tag
// Pyyntö
{ "api_key": "...", "name": "Kiinnostava", "color": "#10b981" }
// Vastaus
{ "ok": true, "tag": { "id": 1, "name": "Kiinnostava", "color": "#10b981" } }
Lisää tägi hakuun
POST ?action=tag_search
{ "api_key": "...", "search_id": 94821, "tag_id": 1 }
Poista tägi hausta
POST ?action=untag_search
{ "api_key": "...", "search_id": 94821, "tag_id": 1 }
Virhekoodit
| HTTP-koodi | error | Merkitys |
|---|---|---|
| 400 | Bad Request | Puuttuva tai virheellinen parametri |
| 401 | Unauthorized | Virheellinen tai puuttuva API-avain |
| 402 | Payment Required | Kuukausiraja täyttynyt |
| 409 | Conflict | Tägi tai tili on jo olemassa |
| 429 | Too Many Requests | Pyyntörajoitus ylitetty |
| 500 | Server Error | Palvelinvirhe — tiimimme on ilmoitettu |
Esimerkkipyyntö (cURL)
curl -X POST https://abco.ai/token_api.php \
-H "Content-Type: application/json" \
-d '{
"action": "tagged_searches",
"api_key": "YOUR_API_KEY",
"limit": 20
}'
// Esimerkkivastaus
{
"ok": true,
"searches": [
{
"id": 94821,
"created_at": "2025-06-04T14:22:11Z",
"source": "extension",
"vehicle": {
"make": "Mercedes-Benz",
"model": "C 220 d",
"year": 2021
},
"tax_eur": 2338,
"tags": [
{ "id": 1, "name": "Kiinnostava", "color": "#10b981" }
]
}
]
}
Hinnoittelu & rajoitukset
| Taso | Hinta | Hakuja/kk | Tägit | Webhook |
|---|---|---|---|---|
| Trial | Ilmainen | 200 | ✓ | — |
| Standard | 29 €/kk | Rajaton | ✓ | — |
| API | 49 €/kk | Rajaton | ✓ | ✓ Tulossa |
API-lisenssin voi tilata ottamalla yhteyttä: sales@abco.ai
Tilin tiedot
Tilaus
Ladataan...
API-avain
Käytä API-avainta hakuhistorian hakemiseen ja tägien hallintaan ohjelmallisesti.
—
Pidä avain salassa. Jos avain vaarantuu, ota yhteyttä support@abco.ai.
Tietosuoja & tili