{
  "title": "Google Search - Domain Rankings & Rank Changes",
  "type": "object",
  "schemaVersion": 1,
  "description": "Minimal input: {\"queries\": [\"python documentation\"], \"maxResultsPerSource\": 3}. Cost: $0.008 per parsed page + $0.0005 per delivered result. Set maxTotalChargeUsd in Apify run options, not input. Unchanged or filtered pages are billed.",
  "properties": {
    "queries": {
      "title": "Search queries",
      "type": "array",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [
        "python documentation"
      ],
      "description": "Search keywords, for example [\"python documentation\"]. Up to 20 queries. Each query has independent page and delivered-result limits. No separate source account or API key required.",
      "sectionCaption": "Sources and limits"
    },
    "maxResultsPerSource": {
      "title": "Maximum delivered rows per source",
      "type": "integer",
      "description": "Maximum matching rows per search after filters and monitoring; for example 50. Default 50, maximum 1000. A ceiling, not a guarantee. Deduplicated across the run; Google IDs include domain, query and country; only the first visible result per domain is kept.",
      "default": 50,
      "minimum": 1,
      "maximum": 1000,
      "prefill": 3
    },
    "country": {
      "title": "Google country",
      "type": "string",
      "description": "Requested Google country: us, gb, de, fr, ca or au. English interface. Default us. Country domain and gl are sent on every page; this is not exact city/device targeting or a guarantee of identical results to your browser.",
      "default": "us",
      "enum": [
        "us",
        "gb",
        "de",
        "fr",
        "ca",
        "au"
      ]
    },
    "domains": {
      "title": "Domain filters",
      "type": "array",
      "description": "Keep these domains or their subdomains, for example [\"python.org\"]. Hostnames only, without https:// or paths. Empty means all domains. Rank is assigned before this filter. Filtered results have no row fee; parsed pages are billed.",
      "default": [],
      "editor": "stringList",
      "items": {
        "type": "string"
      }
    },
    "onlyNewOrChanged": {
      "title": "Only new or changed rows",
      "type": "boolean",
      "description": "true emits new IDs or changes in observed organic rank. First run delivers the baseline; use the same monitorKey later. Successful unchanged checks still pay page fees. Default false. Outputs previous_rank and rank_change; positive movement means improved rank. Missing domains are not reported as disappearances.",
      "default": false
    },
    "titleContains": {
      "title": "Title includes any",
      "type": "array",
      "description": "Keep titles containing any phrase, case-insensitive, for example [\"engineer\"]. For Zillow, title is building name or address. Empty disables it. Applied before row billing; parsed pages are still billed.",
      "default": [],
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "sectionCaption": "Title filters"
    },
    "titleExcludes": {
      "title": "Title excludes any",
      "type": "array",
      "description": "Drop titles containing any phrase, case-insensitive, for example [\"senior\"]. Empty disables it. Filtered rows have no row fee; parsed pages still carry their fee.",
      "default": [],
      "editor": "stringList",
      "items": {
        "type": "string"
      }
    },
    "monitorKey": {
      "title": "Monitor name",
      "type": "string",
      "description": "Persistent history name, for example \"daily-watch\". Use 1–60 letters, digits, underscores or hyphens. Use the same targets, filters and name for repeat runs. Keeps the latest 50,000 delivered IDs. Do not overlap runs sharing this name.",
      "default": "default",
      "editor": "textfield",
      "sectionCaption": "Monitoring and page limits"
    },
    "excludeIds": {
      "title": "Previously collected IDs",
      "type": "array",
      "description": "Skip exact output id values. Up to 10,000. Useful for external deduplication; excluded rows have no row fee, but parsed pages are billed.",
      "default": [],
      "editor": "stringList",
      "items": {
        "type": "string"
      }
    },
    "maxPagesPerSource": {
      "title": "Maximum pages per source",
      "type": "integer",
      "description": "Safety cap on parsed pages per search, for example 5. Default 5, maximum 20. Each parsed page costs $0.008, including filtered or unchanged checks. Both this cap and maxResultsPerSource apply.",
      "default": 5,
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "queries"
  ]
}
