README

PHP wrapper for auto-api.com — unified access to car listings from encar, mobile.de, autoscout24, che168 and other marketplaces.

Covers 8 sources across Korea, Europe, China and UAE. Fetch offers, filter by brand/year/price, track listing changes over time. Requires PHP 8.1+ and Guzzle.

Installation

composer require autoapi/client

Usage

use AutoApi\Client;

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

Get filters

$filters = $client->getFilters('encar');

Search offers

$offers = $client->getOffers('mobilede', [
    'page' => 1,
    'brand' => 'BMW',
    'year_from' => 2020,
]);

// Pagination
$page = $offers['meta']['page'];
$nextPage = $offers['meta']['next_page'];

Get single offer

$offer = $client->getOffer('encar', '40427050');

Track changes

$changeId = $client->getChangeId('encar', '2025-01-15');
$changes = $client->getChanges('encar', $changeId);

// Next batch
$nextChangeId = $changes['meta']['next_change_id'];
$moreChanges = $client->getChanges('encar', $nextChangeId);

Get offer by URL

$info = $client->getOfferByUrl('https://encar.com/dc/dc_cardetailview.do?carid=40427050');

Error handling

use AutoApi\Exception\AuthException;
use AutoApi\Exception\ApiException;

try {
    $offers = $client->getOffers('encar', ['page' => 1]);
} catch (AuthException $e) {
    // 401/403 — invalid API key
} catch (ApiException $e) {
    echo $e->getStatusCode();
    echo $e->getMessage();
}

Supported sources

Other languages

Documentation

auto-api.com