Actions28
- Backlink Actions
- SERP Actions
- Business Data Actions
- On Page Actions
- Keywords Data Actions
- Labs Actions
Overview
The "Get Business Listings" operation of the Business Data resource fetches detailed business listing information from a data provider. This node is useful for scenarios where you need to retrieve structured data about businesses, such as their categories, descriptions, locations, and ratings. It can be applied in market research, competitive analysis, local SEO audits, or building business directories.
For example, you could use this node to:
- Retrieve a list of businesses within specific categories near a geographic location.
- Filter businesses by claimed status or other custom filters.
- Sort results by rating, number of photos, or address details.
- Limit the number of returned listings for pagination or batch processing.
Properties
| Name | Meaning |
|---|---|
| Categories | Up to 10 business categories to filter listings by. You add one or more category strings. |
| Description | Text filter for the business description (up to 200 characters). |
| Title | Text filter for the business title/name (up to 200 characters). |
| Is Claimed | Boolean flag to filter businesses that are claimed or unclaimed. |
| Location Coordinate | Geographic filter specified as latitude,longitude,radius (e.g., 53.476225,-2.243572,200). Latitude and longitude support up to 7 decimal places. Radius is in meters, min 1 max 100000. |
| Filters | JSON string representing an array of additional filtering parameters. Supported filters are documented externally here. |
| Sort | Up to three sorting rules to order the results. Options include sorting by title, description, category, CID, address, city, ZIP, region, phone, domain, total photos, rating value, and rating votes, each ascending or descending. |
| Limit (up to 1000) | Maximum number of business listings to return. Default is 100. |
| Offset | Number of records to skip before starting to collect the result set (useful for pagination). Default is 0. |
Output
The output is a JSON array where each element represents a business listing with various fields such as:
- Business title/name
- Description
- Category/categories
- Claimed status
- Location details (address, city, region, ZIP code, coordinates)
- Contact information (phone, domain)
- Ratings (value and vote count)
- Total number of photos associated with the listing
- Other metadata depending on the API response
This structured data allows downstream nodes or workflows to process, analyze, or display business information effectively.
The node does not output binary data.
Dependencies
- Requires an active API key credential for the DataForSEO service configured in n8n.
- The node sends POST requests to the DataForSEO API endpoint at
https://api.dataforseo.com/v3. - Proper network connectivity to the external API is necessary.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication errors.
- Incorrectly formatted
location_coordinateparameter may lead to request failures. - Exceeding the maximum limit of 1000 results or providing invalid sorting options can cause errors.
- Improper JSON format in the
filtersproperty may result in parsing errors.
Error messages:
- Authentication errors typically indicate problems with the API key setup.
- Validation errors often mention which parameter is invalid or out of range.
- Network timeouts or connection errors suggest connectivity issues.
Resolutions:
- Verify API credentials and permissions.
- Ensure all input parameters follow the specified formats and constraints.
- Use the official DataForSEO documentation to confirm supported filters and sorting options.
- Check network access and firewall settings if connectivity issues persist.