{"id":25996662,"url":"https://github.com/osoobe/dubizzle-php","last_synced_at":"2025-10-14T09:40:13.539Z","repository":{"id":57033469,"uuid":"41611636","full_name":"osoobe/dubizzle-php","owner":"osoobe","description":"Dubizzle is an online classifieds website. This project aims to become a simple and complete web scraping API for Dubizzle.","archived":false,"fork":false,"pushed_at":"2015-11-22T05:00:10.000Z","size":61,"stargazers_count":3,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-26T21:35:11.868Z","etag":null,"topics":["composer","curl-multi","curlphp","dubizzle","motor","uae"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/osoobe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-30T00:30:24.000Z","updated_at":"2017-10-17T15:39:18.000Z","dependencies_parsed_at":"2022-08-24T14:52:52.642Z","dependency_job_id":null,"html_url":"https://github.com/osoobe/dubizzle-php","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osoobe%2Fdubizzle-php","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osoobe%2Fdubizzle-php/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osoobe%2Fdubizzle-php/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osoobe%2Fdubizzle-php/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/osoobe","download_url":"https://codeload.github.com/osoobe/dubizzle-php/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242059625,"owners_count":20065362,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["composer","curl-multi","curlphp","dubizzle","motor","uae"],"created_at":"2025-03-05T16:25:33.667Z","updated_at":"2025-10-14T09:40:08.505Z","avatar_url":"https://github.com/osoobe.png","language":"PHP","readme":"## Introduction\n\n[Dubizzle](http://www.dubizzle.com/) is an online classifieds website. This project aims to\nbecome a simple and complete PHP scraping-based API for Dubizzle.\n\nThis project was enspired by python's [Dubizzle scraping API](https://github.com/Cyph0n/dubizzle/).\n\n## Notice\n\nThis 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.\n\nAnother thing to point out is that the main focus for the time being is on Dubizzle UAE and specifically Motors search within it.\n\n## Prerequisites\n\n* [php-html-parse](https://github.com/paquettg/php-html-parser)\n* [php-curl-class](https://github.com/php-curl-class/php-curl-class)\n* [HTMLPurifier](https://packagist.org/packages/ezyang/htmlpurifier)\n* PHP 5.3 or greater\n\n## Installation\n\nTo easily install Dubizzle, simply:\n\n```bash\ncomposer require osoobe/dubizzle\n```\n\nIf you don't have compose install, see [how to install and use composer](https://getcomposer.org/doc/00-intro.md)\n\n\n## Quickstart\n\n```php\n\nuse Dubizzle\\Search;\n\n$params = [\"country\"=\u003e'uae', \"city\"=\u003e\"dubai\", \"section\"=\u003e\"motor\"];\n$uea = new Search($params);\n$query = $uea-\u003esearch();\n$query-\u003efetch();\n\n$results = $query-\u003eget_results();\n\n```\n\nThe `$results` variable is a array of associated data for each result item on dubizzle:\n\n```php\n\nvar_dump($results);\n\n[\n    ['title' =\u003e '...',\n     'location' =\u003e '...',\n     'url' =\u003e '...',\n     'price' =\u003e '...',\n     'category' =\u003e '...'\n    ],\n    ['title' =\u003e '...',\n     'location' =\u003e '...',\n     'url' =\u003e '...',\n     'price' =\u003e '...',\n     'category' =\u003e '...'\n    ],\n    ...\n]\n```\n\nSee [Demo 1](http://www.osoobe.com/devlabs/php/demo/dubizzle-php/demo/demo.php) for data output.\n\n\n## Example\n\nFind 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))\n\n```php\nrequire_once \"../vendor/autoload.php\";\n\nuse Dubizzle\\Search;\n\n$params = [\n    \"keyword\"=\u003e'altima',\n    \"country\"=\u003e'uae',\n    \"city\"=\u003e'dubai',\n    \"section\"=\u003e'motors',\n    \"category\"=\u003e'cars',\n    \"make\"=\u003e'nissan',\n    \"min_year\"=\u003e2007,\n    \"num_results\"=\u003e'all'];\n\n$uae = new Search($params);\n\n$query = $uae-\u003esearch();\n$query-\u003efetch();\n$results = $query-\u003eget_results();\n\n$result_count = count($results);\n$total_price = 0;\nforeach($results as $result){\n    $total_price += $result[\"price\"];\n}\n\necho \"Num. Results:   \".$result_count;\necho \"\u003cbr/\u003e\";\necho \"\u003cbr/\u003e\";\necho \"Average price:  \".(intval($total_price / $result_count)); # Prints 39239.94\n```\n\n## Other Examples\n\nGet the list of makes from [Dubizzle] ([Live Demo](http://www.osoobe.com/devlabs/php/demo/dubizzle-php/demo/get_makes.php)):\n```php\n\nuse Dubizzle\\Category;\n\n$category = new Category();\n$makes = $category-\u003eget_makes(Category::$uae[\"categories\"][\"options\"]['cars']);\n```\n\n\nGet the list of models from [Dubizzle] ([Live Demo](http://www.osoobe.com/devlabs/php/demo/dubizzle-php/demo/get_models.php)):\n```php\n\nuse Dubizzle\\Category;\n\n$category = new Category();\n$models = $category-\u003eget_models(Category::$uae[\"makes\"][\"options\"]['audi']);\n```\n\n\n\n## Search Parameters\n\n### General\n\n* `country` - string; defaults to 'uae'\n* `keyword` - string\n* `city` - string\n* `section` - string\n* `min_price` and `max_price` - integers\n* `category` - string\n* `added_days` - choices are 0, 3, 7, 14, 30, 90, or 180\n* `num_results` - integer; 'all' fetches all results available\n* `detailed` (not implemented) - if set to `True`, fetches full listing data for each result; slower, obviously\n\n### Motors\n\n* `make` - a long list can be found in `regions.py`\n* `min_year` and `max_year` - integers\n* `min_kms` and `max_kms` - integers\n* `seller` - 'dealer' or 'owner'\n* `fuel` - 'gasoline', 'hybrid', 'diesel', or 'electric'\n* `cylinders` - 3, 4, 5, 6, 8, 10, or 12\n* `transmission` - 'automatic' or 'manual'\n\n## Listing Parameters\n\n* `url` - string, **required**\n* `country` - string; defaults to 'uae'\n\n## Issues\n\nPlease use the [Issues](https://github.com/Osoobe/dubizzle-php/issues) page for that.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosoobe%2Fdubizzle-php","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fosoobe%2Fdubizzle-php","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosoobe%2Fdubizzle-php/lists"}