{
  "title": "Google Autocomplete - Keyword Suggestions & Seed Expansion",
  "schemaVersion": 1,
  "type": "object",
  "additionalProperties": false,
  "description": "Minimal input: {\"queries\": [\"keyword research\"], \"maxSuggestionsPerSeed\": 3}. Each parsed source response costs $0.002 plus $0.0001 per delivered row. Empty/unchanged successful checks are billed. maxTotalChargeUsd belongs in Apify run options.",
  "required": [
    "queries"
  ],
  "properties": {
    "queries": {
      "title": "Seed queries",
      "type": "array",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [
        "keyword research"
      ],
      "minItems": 1,
      "maxItems": 20,
      "sectionCaption": "Sources and result limits",
      "description": "Seed queries, for example [\"keyword research\",\"coffee grinder\"]. Up to 20. Each parsed query costs $0.002 plus $0.0001 per delivered unique suggestion. Suggestions do not include search volume or CPC."
    },
    "maxSuggestionsPerSeed": {
      "title": "Maximum suggestions per original seed",
      "type": "integer",
      "description": "Total output ceiling per original seed across all its expanded queries combined. For example, 2 seeds with 50 each means at most 100 rows total ($0.01 in row fees), plus successful query-check fees. Applied after filters, exclusions and monitoring. Each delivered row costs $0.0001; source checks are separate. Fewer rows may exist. Duplicate results across sources are delivered only once.",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    },
    "country": {
      "title": "Country hint",
      "type": "string",
      "description": "Lowercase two-letter country hint, for example \"us\", \"gb\" or \"de\". Default us. This is sent to Google; it does not prove the geographic origin of the suggestions. No extra locale fee.",
      "default": "us",
      "pattern": "^[a-z]{2}$",
      "sectionCaption": "Locale and expansion",
      "editor": "textfield"
    },
    "language": {
      "title": "Language hint",
      "type": "string",
      "description": "Language code, for example \"en\", \"de\", \"ar\" or \"zh-CN\". Default en. Suggestions may be multilingual. The output records this requested hint, not a detected language. No extra locale fee.",
      "default": "en",
      "editor": "textfield"
    },
    "expandAlphabet": {
      "title": "Expand seeds with a-z",
      "type": "boolean",
      "description": "false (DEFAULT) = one query per seed. true = seed plus seed a through seed z, up to 27 parsed queries per seed at $0.002 each, plus $0.0001 per delivered suggestion. Result and maxRequests limits can stop expansion early. Not recursive.",
      "default": false
    },
    "textContains": {
      "title": "Text includes any phrase",
      "type": "array",
      "description": "Keep results containing any phrase, case-insensitive; for example [\"office\"] or [\"free\"]. Checks suggestion text. Empty [] accepts all. Applied before row charging; successful source checks still cost money.",
      "default": [],
      "sectionCaption": "Result filters",
      "editor": "stringList",
      "items": {
        "type": "string"
      }
    },
    "textExcludes": {
      "title": "Text excludes any phrase",
      "type": "array",
      "description": "Drop results containing any phrase, for example [\"download\"] or [\"bedroom\"]. Empty [] disables the filter. Filtered rows are not charged; successful source checks remain billable.",
      "default": [],
      "editor": "stringList",
      "items": {
        "type": "string"
      }
    },
    "onlyNew": {
      "title": "Only new results",
      "type": "boolean",
      "description": "false by default. true saves delivered IDs under monitorKey; later runs skip them. The first run returns the baseline. Successful checks still cost $0.002 each even with no new rows. Use an Apify schedule for recurring checks; this flag creates no schedule.",
      "default": false,
      "sectionCaption": "Monitoring and safety"
    },
    "monitorKey": {
      "title": "Monitor name",
      "type": "string",
      "description": "Name such as \"daily-research\"; default \"default\". Reuse it for repeat runs. Targets, date window, locale and filters automatically form a separate baseline when changed. Keeps the latest 50,000 IDs per scope. Do not overlap runs with the same name and scope.",
      "default": "default",
      "pattern": "^[A-Za-z0-9_-]{1,60}$",
      "editor": "textfield"
    },
    "excludeIds": {
      "title": "Previously collected IDs",
      "type": "array",
      "description": "Optional output id values, for example [\"previous-output-id\"]. Up to 10,000. Empty [] excludes nothing. Useful for caller-managed deduplication. Excluded rows are not charged; parsed source checks are.",
      "default": [],
      "maxItems": 10000,
      "editor": "stringList",
      "items": {
        "type": "string"
      }
    },
    "maxRequests": {
      "title": "Maximum HTTP requests",
      "type": "integer",
      "description": "Hard run-wide source request cap, for example 100; range 1–200. This is not a dollar limit. Set maxTotalChargeUsd as an Apify run option for a monetary cap.",
      "default": 100,
      "minimum": 1,
      "maximum": 200
    }
  }
}
