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. [Utility & Helpers](/categories/utility)
4. /
5. osoobe/dubizzle

ActiveLibrary[Utility & Helpers](/categories/utility)

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

Dubizzle for PHP

v1.2.2(10y ago)3553MITPHPPHP >=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 2d 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 57% 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

3885d 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

[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751291.4k43](/packages/civicrm-civicrm-core)[jason-munro/cypht

Lightweight Open Source webmail written in PHP and JavaScript

1.6k157.9k](/packages/jason-munro-cypht)[oat-sa/tao-core

TAO core extension

66143.7k124](/packages/oat-sa-tao-core)[verbb/formie

The most user-friendly forms plugin for Craft.

102393.6k70](/packages/verbb-formie)[getdkan/dkan

DKAN Open Data Catalog

387138.7k2](/packages/getdkan-dkan)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1616.4k14](/packages/2lenet-crudit-bundle)

PHPackages © 2026

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