autoapicom-client 1.0.0

auto-api.com client — search car listings across encar, mobile.de, autoscout24, che168 and more

auto-api-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 auto-api-client

Usage

from auto_api import Client

client = Client('your-api-key')

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

Source	Platform	Region
encar	encar.com	South Korea
mobilede	mobile.de	Germany
autoscout24	autoscout24.com	Europe
che168	che168.com	China
dongchedi	dongchedi.com	China
guazi	guazi.com	China
dubicars	dubicars.com	UAE
dubizzle	dubizzle.com	UAE

Other languages

Language	Package
PHP	auto-api/client
TypeScript	@auto-api/client
Go	auto-api-go
C#	AutoApi.Client
Java	auto-api-client
Ruby	auto-api-client
Rust	auto-api-client

Documentation

auto-api.com