SerpApi Official icon

SerpApi Official

Get live Google Search data and more from SerpApi's official node

Actions72

Overview

This node enables users to retrieve Google Maps reviews data via SerpApi's official API integration. It is designed to fetch live review information for places listed on Google Maps, which can be useful for businesses monitoring their online reputation, market researchers analyzing customer feedback, or developers building applications that aggregate location-based reviews.

Typical use cases include:

  • Extracting recent and relevant customer reviews for a specific place.
  • Sorting reviews by relevance, date, or rating.
  • Filtering reviews by topics or language.
  • Paginating through large sets of reviews using tokens.

For example, a business owner could automate the collection of new reviews about their store to analyze customer sentiment over time.

Properties

Name Meaning
Data ID (data_id) The Google Maps data ID used to identify the place. Either this or Place ID must be provided.
Place ID (place_id) The unique Google Maps reference ID for a place. Either this or Data ID must be provided.
Additional Fields A collection of optional parameters to refine the search:
- Language (hl) Language code to localize the reviews (e.g., "en" for English, "fr" for French). Many language options are available.
- Sort By (sort_by) How to sort the reviews: Most Relevant, Newest, Highest Rating, or Lowest Rating.
- Topic ID (topic_id) Filter reviews by a specific topic ID found in the structured JSON response.
- Number of Results (num) Maximum number of reviews to return (1 to 20). Cannot be used on the initial page without next_page_token or topic_id.
- Next Page Token (next_page_token) Token to retrieve the next page of results for pagination.
- Disable Caching (no_cache) Boolean flag to force fetching fresh results instead of cached ones. Cached results expire after 1 hour. Cannot be used with async.
- Async (async) Boolean flag to perform the search asynchronously. If true, results must be retrieved later via Search Archive API. Cannot be used with no_cache or on accounts with Ludicrous Speed enabled.
- ZeroTrace Mode (zero_trace) Enterprise-only boolean flag to disable storing search parameters and metadata on SerpApi servers for privacy.
- Output (output) Format of the output: "json" (default) for structured JSON or "html" for raw HTML.
- JSON Restrictor (json_restrictor) Restricts fields returned in the JSON response, e.g., limiting to certain properties of the first few organic results.

Output

The node outputs a JSON object containing the Google Maps reviews data as returned by SerpApi. This includes detailed information about each review such as author name, rating, text, date, and possibly topic categorizations if used.

If the output format is set to "html", the raw HTML content of the search result page is returned instead.

No binary data output is involved in this operation.

Dependencies

  • Requires an active SerpApi account with a valid API key credential configured in n8n.
  • Internet access to call SerpApi endpoints.
  • Proper configuration of the API key credential in n8n's credentials manager.

Troubleshooting

  • Missing Data ID or Place ID: The node requires either data_id or place_id to be set. Omitting both will cause errors or empty responses.
  • Invalid API Key or Quota Exceeded: Errors related to authentication or quota limits may occur if the API key is invalid or usage limits are reached.
  • Pagination Issues: Using num parameter on the initial request without next_page_token or topic_id is not allowed and may cause errors.
  • Conflicting Parameters: Setting both no_cache and async to true simultaneously is disallowed and will cause errors.
  • Language Codes: Providing unsupported or incorrect language codes may result in default language responses or errors.
  • Enterprise Features: Enabling zero_trace mode requires enterprise-level access; otherwise, it may be ignored or cause permission errors.

To resolve common errors:

  • Ensure required IDs are provided.
  • Verify API key validity and usage limits.
  • Follow parameter usage rules especially around pagination and caching.
  • Consult SerpApi documentation for error codes and meanings.

Links and References

Discussion