README

PHP client for fetching Marktplaats listings programmatically. Returns strongly typed immutable DTOs for search and listing detail pages.

Installation

composer require nieknijland/marktplaats-php

Quick Start

use NiekNijland\Marktplaats\Client;
use NiekNijland\Marktplaats\Data\SearchQuery;

$client = new Client();

$result = $client->getSearch(new SearchQuery(
    query: 'bureau',
));

foreach ($result->listings as $listing) {
    echo $listing->title . ' - ' . $listing->priceInfo?->priceCents . ' cents' . PHP_EOL;
}

// Fetch a detail page
$detail = $client->getListing($listing->vipUrl);
echo $detail->description . PHP_EOL;
echo $detail->stats?->viewCount . ' views' . PHP_EOL;

Documentation

• Usage — Search, filters, listing details, pagination, caching, custom HTTP client
• Testing — FakeClient, factories, assertions
• Caveats — Keyword-stuffed titles, lease prices

Development

composer test              # Unit tests
composer test-integration  # Integration tests (live API)
composer test-all          # Both suites
composer format            # Laravel Pint
composer analyse           # PHPStan level 8
composer codestyle         # rector + pint + analyse

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

• NiekNijland
• All Contributors

License

The MIT License (MIT). Please see License File for more information.