PHPackages                             nieknijland/autoscout24-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. nieknijland/autoscout24-php

ActiveLibrary

nieknijland/autoscout24-php
===========================

PHP client for AutoScout24.nl — wraps internal Next.js data endpoints into a typed API

v0.2.0(1mo ago)01↑2900%MITHTMLPHP ^8.4CI passing

Since Mar 28Pushed 1mo agoCompare

[ Source](https://github.com/NiekNijland/autoscout24-php)[ Packagist](https://packagist.org/packages/nieknijland/autoscout24-php)[ Docs](https://github.com/nieknijland/autoscout24)[ GitHub Sponsors](https://github.com/NiekNijland)[ RSS](/packages/nieknijland-autoscout24-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (7)Versions (5)Used By (0)

AutoScout24 PHP
===============

[](#autoscout24-php)

[![Latest Version on Packagist](https://camo.githubusercontent.com/f3144285b28173b4f4fa94d96463f7dfbcff8388c561d0bc9a864fe706b828ef/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e69656b6e696a6c616e642f6175746f73636f757432342e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nieknijland/autoscout24)[![Tests](https://camo.githubusercontent.com/f70ca3bbf1f1d39cd5c76c0c9f24f2700ae67a4485a979c32a828ce6b0c00937/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6e69656b6e696a6c616e642f6175746f73636f757432342f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/nieknijland/autoscout24/actions/workflows/run-tests.yml)[![Total Downloads](https://camo.githubusercontent.com/46728deca8a451b7b1d769a20795be28cd905d0cea36b11f3aec8d64edc2c3e5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e69656b6e696a6c616e642f6175746f73636f757432342e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nieknijland/autoscout24)

A PHP client for AutoScout24.nl that wraps internal Next.js data endpoints into a typed API. Supports searching for cars and motorcycles, fetching listing details, and retrieving filter taxonomy data (brands, models, body types, fuel types, etc.).

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require nieknijland/autoscout24-php
```

Usage
-----

[](#usage)

### Search for cars

[](#search-for-cars)

```
use NiekNijland\AutoScout24\AutoScout24;
use NiekNijland\AutoScout24\Data\CarSearchCriteria;
use NiekNijland\AutoScout24\Data\Filters\SharedSearchFilters;
use NiekNijland\AutoScout24\Data\SortOrder;

$client = new AutoScout24();

// Basic search with defaults
$result = $client->search(new CarSearchCriteria());

foreach ($result->listings as $listing) {
    echo "{$listing->vehicle->make} {$listing->vehicle->model} - {$listing->price->priceFormatted}\n";
}

// Search with filters
$result = $client->search(CarSearchCriteria::fromFilters(
    shared: new SharedSearchFilters(
        priceFrom: 5000,
        priceTo: 20000,
        sortOrder: SortOrder::PriceAscending,
    ),
));
```

### Search for motorcycles

[](#search-for-motorcycles)

```
use NiekNijland\AutoScout24\Data\MotorcycleSearchCriteria;

$result = $client->search(new MotorcycleSearchCriteria());
```

### Auto-paginate through all results

[](#auto-paginate-through-all-results)

```
// Lazily iterate through all pages
foreach ($client->searchAll(new CarSearchCriteria(), delayMs: 200) as $listing) {
    echo "{$listing->vehicle->make} {$listing->vehicle->model}\n";
}
```

### Get listing details

[](#get-listing-details)

```
$detail = $client->getDetailBySlug('volkswagen-polo-tsi-abc123');
echo $detail->vehicle->make;          // "Volkswagen"
echo $detail->prices->public->price;  // "€ 15.990"
echo $detail->descriptionText();      // Plain text (HTML stripped)
```

### Brands and filter options

[](#brands-and-filter-options)

```
use NiekNijland\AutoScout24\Data\VehicleType;

$brands = $client->getBrands(VehicleType::Car);
$models = $client->getModels(VehicleType::Car, $brands[0]);
$bodyTypes = $client->getFilterOptions(VehicleType::Car, 'bodyType');
```

### Caching

[](#caching)

Pass a PSR-16 cache to avoid refetching the build ID on every request:

```
$client = new AutoScout24(
    cache: $yourPsr16Cache,
    cacheTtl: 3600,
);
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [NiekNijland](https://github.com/NiekNijland)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance90

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 84.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

47d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4d9cb12c53e7e4ec9fdc27f74e8bbd725c61a8280780cffe7136c74f1df7570e?d=identicon)[NiekNijland](/maintainers/NiekNijland)

---

Top Contributors

[![NiekNijland](https://avatars.githubusercontent.com/u/43474728?v=4)](https://github.com/NiekNijland "NiekNijland (11 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")

---

Tags

api clientscraperautoscout24carsmotorcycles

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nieknijland-autoscout24-php/health.svg)

```
[![Health](https://phpackages.com/badges/nieknijland-autoscout24-php/health.svg)](https://phpackages.com/packages/nieknijland-autoscout24-php)
```

###  Alternatives

[crowdin/crowdin-api-client

PHP client library for Crowdin API v2

611.5M5](/packages/crowdin-crowdin-api-client)[nelexa/google-play-scraper

Scrapes app data from Google Play store.

88487.4k](/packages/nelexa-google-play-scraper)[sunchayn/nimbus

A Laravel package providing an in-browser API client with automatic schema generation, live validation, and built-in authentication with a touch of Laravel-tailored magic for effortless API testing.

29428.0k](/packages/sunchayn-nimbus)[crwlr/crawler

Web crawling and scraping library.

37214.8k2](/packages/crwlr-crawler)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)