# Business listing counts by related category

Business Listings Categories Aggregation endpoint provides results containing information about groups of related categories along with the number of entities in each category.

|  |  |
| --- | --- |
| Tool id | `dataforseo.x-business-data-business-listings-categories-aggregation-live` |
| Platform | [Web extraction](https://www.orcarouter.ai/tools/web-extraction.md) |
| Capability | [Other tools](https://www.orcarouter.ai/tools/web-extraction/other.md) |
| Price | $0.014388 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | no |
| Data class | unclassified |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `categories` | array | no | \<em>business categories\</em>\<br>optional field\<br>the categories you specify are used to search for business listings;\<br>if you don't use this field, we will return business listings found in the specified location;\<br>you can specify \<strong>up to 10 categories\</strong> |
| `description` | string | no | \<em>description of the element in SERP\</em>\<br>optional field\<br>the description of the business entity for which the results are collected;\<br>can contain up to 200 characters |
| `initial_dataset_filters` | array | no | \<em>array of results filtering parameters\</em>\<br>optional field\<br>\<strong>you can add several filters at once (8 filters maximum)\</strong>\<br>you should set a logical operator \<code>and\</code>, \<code>or\</code> between the conditions\<br>the following operators are supported:\<br>\<code>regex\</code>, |
| `internal_list_limit` | integer | no | \<em>maximum number of elements within internal arrays\</em>\<br>optional field\<br>you can use this field to limit the number of elements within the aggregated categories\<br>default value: \<code>10\</code> |
| `is_claimed` | boolean | no | \<em>indicates whether the business is verified by its owner on Google Maps\</em>\<br>optional field |
| `limit` | integer | no | \<em>the maximum number of returned businesses\</em>\<br>optional field\<br>default value: \<code>100\</code>\<br>maximum value: \<code>1000\</code> |
| `location_coordinate` | string | no | \<em>GPS coordinates of a location\</em>\<br>optional field\<br>\<code>location_coordinate\</code> parameter should be specified in the \<em>"latitude,longitude,radius"\</em> format\<br>the maximum number of decimal digits for \<em>"latitude"\</em> and \<em>"longitude"\</em>: 7\<br>the minimum value for \<em>"radi |
| `offset` | integer | no | \<em>the maximum number of returned businesses\</em>\<br>optional field |
| `tag` | string | no | \<em>user-defined task identifier\</em>\<br>optional field\<br>\<em>the character limit is 255\</em>\<br>you can use this parameter to identify the task and match it with the result\<br>you will find the specified \<code>tag\</code> value in the \<code>data\</code> object of the response |
| `title` | string | no | \<em>title of the element in SERP\</em>\<br>optional field\<br>the name of the business entity for which the results are collected;\<br>can contain up to 200 characters |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/dataforseo.x-business-data-business-listings-categories-aggregation-live/run \
  -H "Authorization: Bearer $ORCAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'
```

```python
import os, requests

resp = requests.post(
    "https://api.orcarouter.ai/v1/tools/dataforseo.x-business-data-business-listings-categories-aggregation-live/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [Is a domain disposable or free webmail](https://www.orcarouter.ai/tools/web-extraction/other/web-domain-disposable.md) | — | $0.001 per call | OK |
| [Keyword popularity by age and gender, DataForSEO Trends](https://www.orcarouter.ai/tools/web-extraction/other/x-keywords-data-dataforseo-trends-demography-live.md) | — | $0.00264 per call | OK |
| [Keyword popularity by subregion, DataForSEO Trends](https://www.orcarouter.ai/tools/web-extraction/other/x-keywords-data-dataforseo-trends-subregion-interests-live.md) | — | $0.00264 per call | OK |
| [Map a website](https://www.orcarouter.ai/tools/web-extraction/other/web-map.md) | — | $0.0055 per call | OK |
| [Scrape a web page](https://www.orcarouter.ai/tools/web-extraction/other/web-scrape.md) | — | $0.0055 per call | OK |
| [Keyword popularity merged across trend sources](https://www.orcarouter.ai/tools/web-extraction/other/x-keywords-data-dataforseo-trends-merged-data-live.md) | — | $0.0066 per call | OK |
| [Research the web](https://www.orcarouter.ai/tools/web-extraction/other/web-research.md) | — | $0.0066 per call | OK |
| [Technologies a website uses, by domain](https://www.orcarouter.ai/tools/web-extraction/other/x-domain-analytics-technologies-domain-technologies-live.md) | — | $0.0132 per call | OK |
| [Clickstream search volume for up to 1000 keywords](https://www.orcarouter.ai/tools/web-extraction/other/x-keywords-data-clickstream-data-bulk-search-volume-live.md) | — | $0.013596 per call | OK |
| [Search Google Maps businesses by category and location](https://www.orcarouter.ai/tools/web-extraction/other/x-business-data-business-listings-search-live.md) | — | $0.014388 per call | OK |

Showing the first 10 of 26.

## FAQ

### How much does Business listing counts by related category cost?

Business listing counts by related category costs $0.014388 per call: 1,000 calls cost $14.388.

### What does a $10 budget buy with Business listing counts by related category?

About 695 calls at $0.014388 per call.

### What inputs does Business listing counts by related category need?

It has no required inputs.

### How do I call Business listing counts by related category?

Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.

---

Markdown version of https://www.orcarouter.ai/tools/web-extraction/other/x-business-data-business-listings-categories-aggregation-live