Actions29
- 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 an external data provider. This node is useful for scenarios where you need to retrieve structured business data such as categories, descriptions, titles, location coordinates, and other metadata about businesses. Practical applications include market research, competitive analysis, local SEO audits, or enriching CRM databases with verified business details.
Properties
| Name | Meaning |
|---|---|
| Categories | Up to 10 business categories to filter listings by. You can add multiple category strings to narrow down the search results. |
| Description | A text string (up to 200 characters) to filter listings by description content. |
| Title | A text string (up to 200 characters) to filter listings by title content. |
| Is Claimed | Boolean flag to filter listings based on whether the business is claimed or not. |
| Location Coordinate | A string specifying a geographic filter in the format latitude,longitude,radius. Latitude and longitude support up to 7 decimal places. Radius defines the search radius in meters (1 to 100000). Example: 53.476225,-2.243572,200. |
| Filters | A JSON array string defining additional filtering parameters supported by the external API. Users can refer to the official documentation for supported filters. |
| Sort | Up to three sorting rules to order the results by various fields such as title, description, category, CID, address components, total photos, rating value, and votes count. Each rule specifies the field and ascending/descending order. |
| Limit | Maximum number of results to return, between 1 and 1000. Defaults to 100. |
| Offset | Number of results to skip before starting to collect the output. Useful for pagination. Defaults to 0. |
Output
The node outputs an array of JSON objects representing business listings matching the specified criteria. Each object typically contains fields such as:
- Business title and description
- Categories assigned to the business
- Claim status
- Location details including coordinates and address components
- Ratings and reviews summary
- Photos count
- Other metadata relevant to the business listing
If binary data is returned (not indicated here), it would represent media associated with listings such as images.
Dependencies
- Requires an active API key credential for the external DataForSEO service.
- The node sends POST requests to the DataForSEO API endpoint at
https://api.dataforseo.com/v3. - Proper network connectivity and valid authentication are necessary.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication errors.
- Incorrectly formatted
location_coordinatestrings may result in request validation errors. - Exceeding the maximum limit of 1000 results or more than three sorting rules will cause the API to reject the request.
- Improper JSON formatting in the
filtersproperty can lead to parsing errors.
Error messages:
- Authentication failures: Check that the API key credential is correctly configured.
- Validation errors: Verify all input properties conform to expected formats and constraints.
- Rate limiting or quota exceeded: Ensure your API plan supports the volume of requests being made.