google-autocomplete-api

Get Google search autocomplete suggestions for a query. Apify-backed n8n community node, pay-per-result, and usable as an AI agent tool.

Package Information

Released: 4 mo ago
Downloads: 9 weekly / 280 monthly
Latest Version: 0.1.1
Author: John Cole

Documentation

n8n-nodes-google-autocomplete-api

An n8n community node that returns Google search autocomplete suggestions for a query. It is backed by the Google Autocomplete API on Apify and bills per result, so there are no subscriptions and no minimums.

Installation · Credentials · Operations · Output · Example workflows · Pricing · Resources

What it does

Give the node a partial query, and it returns one item per autocomplete suggestion with its value and rank. It also works as an AI Agent tool, so an agent can do keyword discovery on demand. This is great for keyword research and SEO.

  • Get Google autocomplete suggestions for any query
  • Localize with a country code and language code
  • Choose how much data to return per suggestion: Simplified, Raw, or Selected Fields

Installation

Follow the n8n community nodes installation guide:

  1. In n8n, open Settings > Community Nodes.
  2. Select Install.
  3. Enter n8n-nodes-google-autocomplete-api as the npm package name.
  4. Agree to the risks of using community nodes, then select Install.

After it installs, the Google Autocomplete node appears in the nodes panel.

n8n Cloud only allows verified community nodes. Until this node is verified, install it on a self-hosted n8n instance.

Credentials

You need a free Apify account and an API token.

  1. Sign in to the Apify Console.
  2. Open Settings > Integrations and copy your Personal API token.
  3. In n8n, create a new Apify API credential and paste the token.
  4. Use the credential's Test button to confirm it works.

The node also supports Apify OAuth2 if you prefer to connect that way.

Operations

Suggestion > Get returns autocomplete suggestions for a query.

Parameter Description
Search Query The partial query to get suggestions for. Required.
Country Code / Language Code Localization, for example us and en.
Output How much data to return: Simplified, Raw, or Selected Fields.

Output

Each suggestion is returned as its own n8n item. The Output parameter lets you choose how much to return:

  • Simplified (default): a compact object with value, query, and position. This mode is also used automatically when the node runs as an AI Agent tool, to keep responses small.
  • Raw: every field the API returns for each suggestion, using the original field names below.
  • Selected Fields: pick exactly which fields to include.

Fields (Raw and Selected Fields)

Field Type Description
result_type string Record type, for example suggestion
query string The query that produced this suggestion
position integer Rank of the suggestion
value string The suggested completion

Example workflows

1. Keyword expansion

  1. Read a list of seed terms.
  2. Google Autocomplete: get suggestions for each.
  3. Google Sheets: append every value to build a keyword list.

2. Discover question keywords

  1. Manual Trigger.
  2. Google Autocomplete: Search Query how to <topic>.
  3. Filter: keep suggestions that start with question words.

3. Let an AI Agent do keyword research

  1. AI Agent node.
  2. Attach Google Autocomplete as a tool.
  3. Ask "What do people search after 'best running'?" The agent calls the node (in Simplified mode) and returns suggestions.

Pricing

This node calls the Google Autocomplete API on Apify, which is billed pay-per-result, with no subscription and no minimums. Apify also includes a free monthly usage tier that covers typical volumes. See the Actor page for current rates.

Resources

License

MIT

Discussion