List of Categories for Business Listings API
This endpoint will provide you with the list of top categories by business count.
You can also download the CSV
file by this link.
This endpoint will provide you with the list of top categories by business count.
You can also download the CSV
file by this link.
Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access
<?php // You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip require('RestClient.php'); $api_url = 'https://api.dataforseo.com/'; // Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access $client = new RestClient($api_url, null, 'login', 'password'); try { // using this method you can get a list of categories // GET /v3/business_data/business_listings/categories $result = $client->get('/v3/business_data/business_listings/categories'); print_r($result); // do something with result } catch (RestClientException $e) { echo "n"; print "HTTP code: {$e->getHttpCode()}n"; print "Error code: {$e->getCode()}n"; print "Message: {$e->getMessage()}n"; print $e->getTraceAsString(); echo "n"; } $client = null; ?>
The above command returns JSON structured like this:
{ "version": "0.1.20221214", "status_code": 20000, "status_message": "Ok.", "time": "0.7569 sec.", "cost": 0, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "05040822-1535-0548-0000-7430dba04753", "status_code": 20000, "status_message": "Ok.", "time": "0.6762 sec.", "cost": 0, "result_count": 5156, "path": [ "v3", "business_data", "business_listings", "categories" ], "data": { "api": "business_data", "function": "categories" }, "result": [ { "category_name": "bus_stop", "business_count": 2080681 }, { "category_name": "corporate_office", "business_count": 1846431 }, { "category_name": "restaurant", "business_count": 1543669 }, { "category_name": "clothing_store", "business_count": 1261299 }, { "category_name": "doctor", "business_count": 994504 } ] } ] }
By calling this API you will receive the list of categories supported by DataForSEO Business Listings API.
As a response of the API server, you will receive JSON-encoded data containing a tasks
array with the information about available categories.
Field name | Type | Description |
---|---|---|
version |
string | the current version of the API |
status_code |
integer | general status code you can find the full list of the response codes here |
status_message |
string | general informational message you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | total tasks cost, USD |
tasks_count |
integer | the number of tasks in the tasks array |
tasks_error |
integer | the number of tasks in the tasks array returned with an error |
tasks |
array | array of tasks |
id |
string | task identifier unique task identifier in our system in the UUID format |
status_code |
integer | status code of the task generated by DataForSEO; can be within the following range: 10000-60000 you can find the full list of response codes here |
status_message |
string | informational message of the task you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | cost of the task, USD |
result_count |
integer | number of elements in the result array |
path |
array | URL path |
data |
object | contains the parameters passed in the URL of the GET request |
result |
array | array of results |
category_name |
string | full name of the category |
business_count |
integer | number of businesses in the category |