{
  "title": "YouTube Video Search - Keywords, Views & Duration",
  "type": "object",
  "schemaVersion": 1,
  "description": "Minimal input {\"queries\": [\"project management\"], \"maxResults\": 3, \"maxPagesPerSource\": 1}. $0.002 per parsed page plus $0.0008 per delivered video. Parsed empty/filtered pages are paid. No start fee; use maxTotalChargeUsd as a run option.",
  "required": [
    "queries"
  ],
  "properties": {
    "queries": {
      "title": "Queries",
      "description": "Required search phrases, e.g. [\"project management\"]. Up to 20 queries, visited in order. One maxResults cap is shared across the whole run. Use specific terms in any language. Successful parsed pages and delivered matching rows are separate paid events.",
      "type": "array",
      "items": {
        "type": "string"
      },
      "editor": "stringList",
      "prefill": [
        "project management"
      ],
      "sectionCaption": "Sources"
    },
    "maxResults": {
      "title": "Max results",
      "description": "Maximum paid rows across the ENTIRE run after filters, deduplication and exclusions. Default 20; range 1–1000. Earlier targets can fill this cap. Set maxTotalChargeUsd in the Apify run options for a dollar cap; it is not an input field.",
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "maximum": 1000,
      "prefill": 3,
      "sectionCaption": "Results and filters"
    },
    "country": {
      "title": "Country",
      "description": "YouTube search country context, e.g. \"US\" (default) or \"GB\". This is not creator nationality. Requests English interface labels; your queries may use another language. No extra fee.",
      "type": "string",
      "default": "US",
      "enum": [
        "US",
        "GB",
        "CA",
        "AU",
        "DE",
        "FR",
        "IN",
        "JP",
        "AE",
        "SG"
      ]
    },
    "titleContains": {
      "title": "Title contains",
      "description": "Optional case-insensitive OR substring filter on the video/product title, e.g. [\"wireless\", \"bluetooth\"]. Empty disables. Filters run before maxResults; inspected pages still carry page fees. No extra filter fee.",
      "type": "array",
      "default": [],
      "items": {
        "type": "string"
      },
      "editor": "stringList"
    },
    "minViews": {
      "title": "Min views",
      "description": "Minimum views, e.g. 10000. 0 disables. Missing view counts fail an active filter. Source-rounded numbers remain approximate; inspect views_approximate. Applies before maxResults. No extra filter fee.",
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "maximum": 1000000000000
    },
    "minDurationSeconds": {
      "title": "Min duration seconds",
      "description": "Minimum video duration in seconds, e.g. 60. 0 disables. Missing durations fail an active filter. No extra filter fee; matches are counted after filtering.",
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "maximum": 86400
    },
    "maxDurationSeconds": {
      "title": "Max duration seconds",
      "description": "Maximum video duration in seconds, e.g. 1200 for 20 minutes. 0 disables. Missing durations fail an active filter. Must be at least minDurationSeconds when enabled. No extra filter fee.",
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "maximum": 86400
    },
    "maxPagesPerSource": {
      "title": "Max pages per source",
      "description": "Maximum successfully parsed result pages per query/video, default 2; range 1–20. Each page has a fee even if filters leave zero rows. Bootstrap/sort requests are included in that fee. This limits search depth, not a guarantee of enough matching results.",
      "type": "integer",
      "default": 2,
      "minimum": 1,
      "maximum": 20,
      "sectionCaption": "Page budget and history"
    },
    "excludeIds": {
      "title": "Exclude ids",
      "description": "Row id values from a previous dataset, e.g. [] on the first run. Up to 5,000 IDs. Skips matching IDs even if their content changed. Excluded rows have no row fee; parsed-page fees still apply. Keep IDs in your workflow; no history is stored automatically.",
      "type": "array",
      "default": [],
      "items": {
        "type": "string"
      },
      "editor": "stringList"
    },
    "excludeContentHashes": {
      "title": "Exclude content hashes",
      "description": "Prior content_hash values, e.g. [] initially. Up to 5,000 SHA-256 values. Skips unchanged records while allowing changed prices/text/metrics through. Collection time, query, page position and images do not affect hashes. Caller-managed history; parsed-page fees apply.",
      "type": "array",
      "default": [],
      "items": {
        "type": "string"
      },
      "editor": "stringList"
    }
  }
}
