PHPackages                             osoobe/dubizzle - 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. osoobe/dubizzle

ActiveLibrary

osoobe/dubizzle
===============

Dubizzle for PHP

v1.2.2(10y ago)3554MITPHPPHP >=5.3.0

Since Aug 30Pushed 10y ago2 watchersCompare

[ Source](https://github.com/osoobe/dubizzle-php)[ Packagist](https://packagist.org/packages/osoobe/dubizzle)[ Docs](https://github.com/Osoobe/dubizzle-php)[ RSS](/packages/osoobe-dubizzle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (3)Versions (6)Used By (0)

Introduction
------------

[](#introduction)

[Dubizzle](http://www.dubizzle.com/) is an online classifieds website. This project aims to become a simple and complete PHP scraping-based API for Dubizzle.

This project was enspired by python's [Dubizzle scraping API](https://github.com/Cyph0n/dubizzle/).

Notice
------

[](#notice)

This is still a work in progress. There is much left to do until this becomes what it should be. I will however make sure that the `master` branch functions as expected. Any help would be greatly appreciated, obviously.

Another thing to point out is that the main focus for the time being is on Dubizzle UAE and specifically Motors search within it.

Prerequisites
-------------

[](#prerequisites)

- [php-html-parse](https://github.com/paquettg/php-html-parser)
- [php-curl-class](https://github.com/php-curl-class/php-curl-class)
- [HTMLPurifier](https://packagist.org/packages/ezyang/htmlpurifier)
- PHP 5.3 or greater

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

[](#installation)

To easily install Dubizzle, simply:

```
composer require osoobe/dubizzle
```

If you don't have compose install, see [how to install and use composer](https://getcomposer.org/doc/00-intro.md)

Quickstart
----------

[](#quickstart)

```
use Dubizzle\Search;

$params = ["country"=>'uae', "city"=>"dubai", "section"=>"motor"];
$uea = new Search($params);
$query = $uea->search();
$query->fetch();

$results = $query->get_results();
```

The `$results` variable is a array of associated data for each result item on dubizzle:

```
var_dump($results);

[
    ['title' => '...',
     'location' => '...',
     'url' => '...',
     'price' => '...',
     'category' => '...'
    ],
    ['title' => '...',
     'location' => '...',
     'url' => '...',
     'price' => '...',
     'category' => '...'
    ],
    ...
]
```

See [Demo 1](http://www.osoobe.com/devlabs/php/demo/dubizzle-php/demo/demo.php) for data output.

Example
-------

[](#example)

Find average price of year 2007 and above Nissan Altimas in Dubai ([Live Demo](http://www.osoobe.com/devlabs/php/demo/dubizzle-php/demo/demo2.php))

```
require_once "../vendor/autoload.php";

use Dubizzle\Search;

$params = [
    "keyword"=>'altima',
    "country"=>'uae',
    "city"=>'dubai',
    "section"=>'motors',
    "category"=>'cars',
    "make"=>'nissan',
    "min_year"=>2007,
    "num_results"=>'all'];

$uae = new Search($params);

$query = $uae->search();
$query->fetch();
$results = $query->get_results();

$result_count = count($results);
$total_price = 0;
foreach($results as $result){
    $total_price += $result["price"];
}

echo "Num. Results:   ".$result_count;
echo "";
echo "";
echo "Average price:  ".(intval($total_price / $result_count)); # Prints 39239.94
```

Other Examples
--------------

[](#other-examples)

Get the list of makes from \[Dubizzle\] ([Live Demo](http://www.osoobe.com/devlabs/php/demo/dubizzle-php/demo/get_makes.php)):

```
use Dubizzle\Category;

$category = new Category();
$makes = $category->get_makes(Category::$uae["categories"]["options"]['cars']);
```

Get the list of models from \[Dubizzle\] ([Live Demo](http://www.osoobe.com/devlabs/php/demo/dubizzle-php/demo/get_models.php)):

```
use Dubizzle\Category;

$category = new Category();
$models = $category->get_models(Category::$uae["makes"]["options"]['audi']);
```

Search Parameters
-----------------

[](#search-parameters)

### General

[](#general)

- `country` - string; defaults to 'uae'
- `keyword` - string
- `city` - string
- `section` - string
- `min_price` and `max_price` - integers
- `category` - string
- `added_days` - choices are 0, 3, 7, 14, 30, 90, or 180
- `num_results` - integer; 'all' fetches all results available
- `detailed` (not implemented) - if set to `True`, fetches full listing data for each result; slower, obviously

### Motors

[](#motors)

- `make` - a long list can be found in `regions.py`
- `min_year` and `max_year` - integers
- `min_kms` and `max_kms` - integers
- `seller` - 'dealer' or 'owner'
- `fuel` - 'gasoline', 'hybrid', 'diesel', or 'electric'
- `cylinders` - 3, 4, 5, 6, 8, 10, or 12
- `transmission` - 'automatic' or 'manual'

Listing Parameters
------------------

[](#listing-parameters)

- `url` - string, **required**
- `country` - string; defaults to 'uae'

Issues
------

[](#issues)

Please use the [Issues](https://github.com/Osoobe/dubizzle-php/issues) page for that.

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~19 days

Total

5

Last Release

3838d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1830494?v=4)[Oshane Bailey](/maintainers/b4oshany)[@b4oshany](https://github.com/b4oshany)

---

Top Contributors

[![b4oshany](https://avatars.githubusercontent.com/u/1830494?v=4)](https://github.com/b4oshany "b4oshany (24 commits)")

---

Tags

composercurl-multicurlphpdubizzlemotoruaephpdubizzlescreen scraper

### Embed Badge

![Health badge](/badges/osoobe-dubizzle/health.svg)

```
[![Health](https://phpackages.com/badges/osoobe-dubizzle/health.svg)](https://phpackages.com/packages/osoobe-dubizzle)
```

###  Alternatives

[jason-munro/cypht

Lightweight Open Source webmail written in PHP and JavaScript

1.5k146.0k](/packages/jason-munro-cypht)[mahocommerce/maho

Free and open source ecommerce platform, created in 2024 on the M1 platform, PHP 8.3+

1322.1k12](/packages/mahocommerce-maho)[saleh7/proxmox-ve_php_api

ProxmoxVE PHP API

11718.7k](/packages/saleh7-proxmox-ve-php-api)[quantum/framework

The Quantum PHP Framework

402.8k1](/packages/quantum-framework)[manamine/php-eos-rpc-sdk

PHP SDK for the EOS RPC API

187.5k](/packages/manamine-php-eos-rpc-sdk)

PHPackages © 2026

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