Google Autocomplete Keyword Suggestions

Get bounded keyword suggestions from Google's public Autocomplete endpoint for a small set of search prefixes. Optional recursive expansion (depth 1-3) and alphabet append build a bounded keyword tree with query provenance. This Actor does not estimate search volume, keyword difficulty, rankings, or traffic. It is not affiliated with Google.

Quick start

{
  "keywords": ["running shoes"],
  "country": "US",
  "language": "en",
  "appendAlphabet": false,
  "maxDepth": 0,
  "maxQueries": 20,
  "maxResults": 80
}

keywords accepts 1–12 prefixes. maxDepth is limited to 0–3, maxQueries to 1–60 public requests, and maxResults to 1–300 unique Dataset rows. appendAlphabet=true (or legacy expandLetters=true) adds bounded a–z prefixes. Recursive child queries inherit the same locale and are capped by maxQueries; every row records query, depth, parentKeyword, and position. Google may throttle or reject public requests; an empty or failed request is reported in OUTPUT and does not produce a paid result row.

Output

Each Dataset row contains suggestion, query, sourcePrefix, position, depth, parentKeyword, country, language, searchVolume: null (this public source does not provide search-volume measurements), and retrievedAt. The Actor does not emit a query-URL field. The OUTPUT record is an object containing requested/accepted/invalid/duplicate keyword counts, query/result budgets, processed/failed tasks, delivered/billed counts, billing failures, charge-limit state and warnings.

Pricing and billing

The official Apify monetization event is suggestion-result at $0.0004 per successfully delivered row. The Actor pushes a row first and calls the SDK charge event only for that row; a failed upstream request, duplicate suggestion, failed Dataset write, or zero-result request is not charged. There is no automatic Dataset-event charge configured in addition to this event. A charge receipt other than one result stops further paid delivery and is recorded in OUTPUT.

Current public build: 0.8.1 is the production latest build after this documentation refresh. The preceding bounded Owner verification delivered and charged 10 rows with no billing failures; this confirms the current build contract, not external customer revenue. Use this Actor for repeatable keyword expansion, not for search volume or ranking estimates.