DataForSEO Business Data APIInstall

Summary

Returns aggregated counts and data for business categories matching specified criteria, not individual listings.

Inputs

• Categories — A list of business category names (up to 10) to filter the aggregation.
• Description — A text description to include in the search query (up to 200 symbols).
• Title — A business title to include in the search query (up to 200 symbols).
• Is Claimed — Filter results to only claimed ('Yes') or unclaimed ('No') businesses.
• Location Coordinate — Latitude, longitude, and search radius in 'lat,lon,radius' format.
• Initial Dataset Filters — JSON string of advanced filters (e.g., location, rating) to apply to the dataset.
• Internal List Limit — Maximum number of elements to return within nested arrays (default 10).
• Limit — Maximum number of top-level results to return (up to 1000, recommended 100).
• Offset — Number of results to skip for pagination (default 0).

Output shape

A list of items, each containing aggregated category data (counts, entities, etc.).

Returns the raw API response structure, which includes task status, items with aggregation data, and metadata. Supports pagination via offset/limit.

Examples

Example 1: Get category aggregation for 'Coffee' in London

Categories: Coffee; Location Coordinate: 51.5074,-0.1278,50000; Limit: 50

Example 2: Filter unclaimed restaurants by rating using dataset filters

Categories: Restaurant; Initial Dataset Filters: '[{"rating":[{"from":4,"to":5}]}]'; Limit: 100

Links

• n8n community nodes installation guide