DataForSEO icon

DataForSEO

DataForSEO

Actions29

Overview

The node interacts with the DataForSEO API to retrieve aggregated category data for business listings. Specifically, the "Get Business Listings Categories Aggregation" operation fetches aggregated information about business listing categories based on various filters and parameters.

This node is useful when you want to analyze or summarize business listings by their categories, for example:

  • To understand the distribution of businesses across different categories in a specific location.
  • To filter business listings by certain attributes like whether they are claimed or by geographic proximity.
  • To gather insights for market research or competitive analysis by aggregating business data.

Practical examples include:

  • Aggregating restaurant categories within a 10 km radius of a city center.
  • Filtering business listings that are claimed and belong to specific categories such as "Hotels" or "Gyms".
  • Limiting results to a maximum number and paginating through them using offset.

Properties

Name Meaning
Categories You can specify up to 10 business categories to filter the aggregation. Each category is a string representing a business category name.
Description Optional text description (up to 200 characters) related to the query or aggregation request.
Title Optional title (up to 200 characters) related to the query or aggregation request.
Is Claimed Boolean flag to filter business listings by whether they are claimed or not.
Location Coordinate Geographic filter specified as latitude,longitude,radius. Latitude and longitude support up to 7 decimal places. Radius defines the search radius in meters (minimum 1, maximum 100000). Example: 53.476225,-2.243572,200
Internal Dataset Filters A JSON string representing an array of additional filtering parameters supported by the DataForSEO API. These filters allow more granular control over the dataset.
Internal List Limit Number specifying an internal limit on the list size returned by the API.
Limit Maximum number of results to return (integer between 1 and 1000).
Offset Number of results to skip before starting to collect the result set (used for pagination).

Output

The node outputs a JSON array where each item corresponds to an aggregated category result from the business listings data. The exact structure depends on the DataForSEO API response but typically includes fields such as category names, counts, and other aggregated metrics.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the DataForSEO API via an API key credential configured in n8n.
  • The node sends POST requests to the base URL https://api.dataforseo.com/v3.
  • Proper configuration of authentication credentials in n8n is necessary for successful API calls.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication errors.
    • Incorrectly formatted location_coordinate parameter may lead to validation errors; ensure it follows the latitude,longitude,radius format with valid numeric values.
    • Exceeding the maximum allowed limit (over 1000) will likely cause the API to reject the request.
    • Providing malformed JSON in Internal Dataset Filters can cause parsing errors.

  • Error messages:

    • Authentication failures: Check API key validity and credential setup.
    • Validation errors: Review input parameters for correct formats and value ranges.
    • Rate limiting or quota exceeded: May require waiting or upgrading the API plan.

Links and References

Discussion