Actions28
- Backlink Actions
- SERP Actions
- Business Data Actions
- On Page Actions
- Keywords Data Actions
- Labs Actions
Overview
The node integrates with the DataForSEO API to retrieve Google reviews for a specified business location. It allows users to fetch detailed review data based on different search criteria such as keyword, CID (Customer ID), or Place ID. This node is useful for businesses and marketers who want to monitor customer feedback, analyze reputation, or gather insights from Google reviews programmatically.
Common scenarios:
- Aggregating Google reviews for competitive analysis.
- Monitoring brand reputation by collecting recent customer feedback.
- Extracting review data for sentiment analysis or reporting dashboards.
- Automating review collection for multiple locations or keywords.
Practical example:
A marketing agency wants to collect the latest 50 Google reviews sorted by highest rating for a client’s restaurant located in the United Kingdom. They configure this node to search by Place ID, specify the location as "United Kingdom," set the language to "English," and request 50 reviews sorted by highest rating.
Properties
| Name | Meaning |
|---|---|
| Search By | Method to identify the business for which to get reviews. Options: Keyword, CID, or Place ID. |
| Keyword/CID/Place ID | The actual value used to search for the business reviews. Depending on "Search By" selection, this can be a keyword string, a CID number, or a Place ID string. This field is required. |
| Task Priority | Execution priority of the task. Options: Normal Execution Priority (default) or High Execution Priority (which may incur additional charges). |
| Location | Full name of the location where the business is situated. Required to specify the geographic context for the search. Example: "United Kingdom". Supported locations are listed in the DataForSEO documentation. |
| Language | Full name of the language for the reviews to be retrieved. Example: "English". Supported languages are listed in the DataForSEO documentation. |
| Number of Reviews | Number of reviews to retrieve. Integer between 1 and 4490. Default is 10. |
| Sort | Sorting order of the reviews. Options include: Newest, Highest Rating, Lowest Rating, and Relevance (default). |
Output
The node outputs an array of JSON objects representing individual Google reviews matching the query parameters. Each object typically contains fields such as:
- Review text content
- Reviewer details (name, profile)
- Rating score
- Date/time of the review
- Possibly other metadata related to the review or reviewer
If binary data were involved (e.g., images), it would be summarized here, but this node focuses on textual review data only.
Dependencies
- Requires an active DataForSEO API account with valid API credentials (an API key or token).
- The node uses the DataForSEO v3 API endpoint at
https://api.dataforseo.com/v3. - Proper configuration of the API credential in n8n is necessary for authentication.
- Internet access to reach the external DataForSEO service.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Incorrect or unsupported location or language names may result in empty or error responses.
- Requesting more reviews than allowed (above 4490) will cause validation errors.
- Using an invalid CID or Place ID may return no results.
Error messages:
"Something went wrong": Generic catch-all error indicating failure during execution; check input parameters and API connectivity.- Credential-related errors: Ensure API keys are correctly configured and have sufficient permissions.
- Validation errors: Verify that all required fields are filled and values conform to expected formats and ranges.
Resolution tips:
- Double-check spelling and correctness of location and language names against DataForSEO documentation.
- Reduce the number of requested reviews if hitting limits.
- Confirm that the selected "Search By" method matches the format of the provided identifier.