autoapicom-client-python

Python client for the auto-api.com car listings API.

Gives you access to 8 automotive marketplaces through a single interface — encar (Korea), mobile.de and autoscout24 (Europe), che168/dongchedi/guazi (China), dubicars/dubizzle (UAE). Search offers, pull listing details, track changes. Built on requests.

Installation

pip install autoapicom-client

Usage

from auto_api import Client

client = Client('your-api-key', 'https://api1.auto-api.com')

Get filters

filters = client.get_filters('encar')

Search offers

offers = client.get_offers('mobilede', page=1, brand='BMW', year_from=2020)

# Pagination
print(offers['meta']['page'])
print(offers['meta']['next_page'])

Get single offer

offer = client.get_offer('encar', '40427050')

Track changes

change_id = client.get_change_id('encar', '2025-01-15')
changes = client.get_changes('encar', change_id)

# Next batch
next_batch = client.get_changes('encar', changes['meta']['next_change_id'])

Get offer by URL

info = client.get_offer_by_url('https://encar.com/dc/dc_cardetailview.do?carid=40427050')

Error handling

from auto_api import Client, AuthError, ApiError

try:
    offers = client.get_offers('encar', page=1)
except AuthError as e:
    # 401/403 — invalid API key
    print(e.status_code, e.message)
except ApiError as e:
    print(e.status_code, e.message)

Supported sources

Other languages

Documentation

auto-api.com