DataForSEO icon

DataForSEO

DataForSEO

Business Data → Get Business Listings Categories Aggregation

AI-generated

Summary

Retrieve aggregated data about groups of related business categories, including the count of entities in each category, optionally filtered and limited by various parameters.

Inputs

  • Categories — Up to 10 category strings to filter the aggregation by specific business categories.
  • Description — A string filter for the business description, up to 200 characters.
  • Title — A string filter for the business title, up to 200 characters.
  • Is Claimed — Filter listings by claimed status: Yes, No, or not specified.
  • Location Coordinate — Filter listings by geographic location using latitude, longitude, and radius (in meters), e.g., '53.476225,-2.243572,200'.
  • Internal Dataset Filters — Additional JSON array of filtering parameters for internal dataset filtering per DataForSEO documentation.
  • Internal List Limit — Limit on internal list size integer value.
  • Limit — Maximum number of aggregated result groups to return, up to 1000.
  • Offset — Number of records to skip before starting to collect the result set.

Output shape

a JSON object containing aggregated business categories data with counts for each category

The API response includes aggregated data representing groups of business categories matching the specified filters. Pagination can be controlled using Limit and Offset parameters. Some filters and category inputs are optional. Filtering parameters must be JSON-parsable when specified as strings.

Links

Discussion