DataForSEOWeb & SEO DataSEO/AEO

Business listings by category

dataforseo.x.business-data-business-listings-categories-aggregation-live

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

Price: $0.01308/callAt provider cost
Success rate: 100%Last 30 days · 27 calls
Latency p50: 1.5 sp95 2.8 s
Last verified: Jul 28, 2026Verified working

POSThttps://toolswitch.dev/v1/tools/dataforseo.x.business-data-business-listings-categories-aggregation-live?bodyType=json

Preview

Try onlineComing soonProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parameters

the POST body is a JSON array holding exactly one task object with these fields; a live route rejects extra tasks with status 40000 "You can set only one task at a time"

This tool has no parameters. See provider docs ↗

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the console.

Preview

curl -X POST 'https://toolswitch.dev/v1/tools/dataforseo.x.business-data-business-listings-categories-aggregation-live?bodyType=json' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '[{"limit":3,"title":"pizza","categories":["pizza_restaurant"],"is_claimed":true,"description":"pizza","location_coordinate":"53.476225,-2.243572,10","initial_dataset_filters":[["rating.value",">",3]]}]'

import os
import json
import requests

response = requests.request(
    "POST",
    "https://toolswitch.dev/v1/tools/dataforseo.x.business-data-business-listings-categories-aggregation-live?bodyType=json",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
    json=json.loads("[{\"limit\":3,\"title\":\"pizza\",\"categories\":[\"pizza_restaurant\"],\"is_claimed\":true,\"description\":\"pizza\",\"location_coordinate\":\"53.476225,-2.243572,10\",\"initial_dataset_filters\":[[\"rating.value\",\">\",3]]}]"),
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/dataforseo.x.business-data-business-listings-categories-aggregation-live?bodyType=json", {
  method: "POST",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
    "Content-Type": "application/json",
  },
  body: JSON.stringify(JSON.parse("[{\"limit\":3,\"title\":\"pizza\",\"categories\":[\"pizza_restaurant\"],\"is_claimed\":true,\"description\":\"pizza\",\"location_coordinate\":\"53.476225,-2.243572,10\",\"initial_dataset_filters\":[[\"rating.value\",\">\",3]]}]")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.01308/call, including the service fee.