SerpApi Official icon

SerpApi Official

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

Actions72

Overview

This node enables users to perform live searches on the Google Play Games Store using SerpApi's official API. It is designed to fetch detailed search results about games available on Google Play, including various categories, device-specific listings, and top charts.

Common scenarios where this node is beneficial include:

  • Market research for mobile game developers or marketers wanting to analyze competitors or trending games.
  • App discovery automation workflows that gather game data based on specific queries or categories.
  • Integration into dashboards or reports that track game popularity or availability by country or language.

For example, a user can search for "puzzle" games in the US store, filter by device type (phone or tablet), and retrieve the top free games chart in English.

Properties

Name Meaning
Search Query (q) The search term or query string to look for in the Google Play Games Store.
Additional Fields A collection of optional parameters to refine the search:
- Country (gl) The country code to use for the search (e.g., "us" for United States). Affects localized search results.
- Language (hl) The language code for the search results (e.g., "en" for English).
- Games Category The category of games to filter by, such as Action, Adventure, Arcade, Board, Card, Casino, Casual, Educational, Music, Puzzle, Racing, Role Playing, Simulation, Sports, Strategy, Trivia, or Word games.
- Device The device type to sort results for, options include Chromebook, Phone, Tablet, TV, Watch, or Windows.
- Next Page Token Token used to retrieve the next page of results. Should not be combined with section page token, see more token, or chart parameters.
- Section Page Token Safer pagination token for individual sections. Should not be combined with next page token, see more token, or chart parameters.
- Chart Parameter to show top charts like "topselling_free". Different charts require different values. Should not be combined with pagination tokens.
- See More Token Pagination token found in next page results. Should not be combined with next page token, section page token, or chart parameters.
- Disable Caching (no_cache) Boolean flag to force fetching fresh results instead of cached ones. Cached results expire after 1 hour. Cannot be used together with async parameter.
- Async (async) Boolean flag to perform the search asynchronously. If true, results must be retrieved later via a separate API. Cannot be used with no_cache parameter. Not recommended for 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 Defines the output format: "json" for structured JSON (default) or "html" for raw HTML response.
- JSON Restrictor Allows restricting the 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 search results from the Google Play Games Store according to the specified query and parameters. The structure typically includes:

  • Game listings matching the search criteria.
  • Metadata about the search such as pagination tokens.
  • Charts or category-specific results if requested.

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

No binary data output is indicated for this node.

Dependencies

  • Requires an active SerpApi account with a valid API key credential configured in n8n.
  • Internet access to call SerpApi endpoints.
  • No other external dependencies are required.

Troubleshooting

  • Empty or incomplete results: Ensure the search query (q) is correctly specified and that pagination tokens are used properly without mixing incompatible parameters (e.g., do not combine next_page_token with section_page_token).
  • API authentication errors: Verify that the API key credential is correctly set up and has sufficient quota.
  • Conflicting parameters: Parameters like no_cache and async cannot be used together; similarly, pagination tokens and chart parameters should not be mixed.
  • Unexpected output format: Check the output property to ensure it matches the desired format ("json" or "html").
  • Rate limits or quota exceeded: Monitor your SerpApi usage to avoid hitting limits.

Links and References

Discussion