{
  "description": "Search the iOS App Store, look up apps by ID, URL or bundle ID, collect deep customer reviews with developer replies, list a publisher's catalog, or read top charts. No Apple account, cookie, or key required.",
  "properties": {
    "appIds": {
      "description": "Apps to look up or review (mode=lookup/reviews). Accepts numeric App Store IDs, bundle IDs, app URLs, and developer URLs. Separate multiple values with commas or new lines.",
      "editor": "stringList",
      "title": "App IDs, bundle IDs, or URLs",
      "type": "array"
    },
    "chartType": {
      "default": "top-free",
      "description": "Top chart to read (mode=charts). Mac charts use the App Store Mac catalog.",
      "editor": "select",
      "enum": [
        "top-free",
        "top-paid",
        "top-grossing",
        "top-free-ipad",
        "top-paid-ipad",
        "top-free-mac"
      ],
      "enumTitles": [
        "Top free iPhone apps",
        "Top paid iPhone apps",
        "Top grossing iPhone apps",
        "Top free iPad apps",
        "Top paid iPad apps",
        "Top free Mac apps"
      ],
      "prefill": "top-free",
      "title": "Chart",
      "type": "string"
    },
    "country": {
      "default": "us",
      "description": "Two-letter App Store storefront. Changes pricing, availability, chart contents, and review language.",
      "editor": "select",
      "enum": [
        "us",
        "gb",
        "de",
        "fr",
        "jp",
        "in",
        "br",
        "ca",
        "au",
        "cn",
        "ru",
        "tr",
        "kr",
        "mx",
        "es",
        "it",
        "nl",
        "se",
        "pl",
        "sa",
        "za",
        "ae",
        "sg",
        "hk",
        "tw",
        "th",
        "id",
        "my",
        "ph",
        "vn",
        "eg",
        "ng",
        "ke",
        "il",
        "ch",
        "at",
        "be",
        "dk",
        "fi",
        "no",
        "pt",
        "ie",
        "nz",
        "ar",
        "cl",
        "co",
        "pe",
        "ua",
        "cz",
        "ro",
        "gr",
        "hu",
        "sk",
        "bg",
        "hr",
        "lt",
        "lv",
        "ee",
        "is",
        "lu",
        "mt",
        "cy"
      ],
      "enumTitles": [
        "United States",
        "United Kingdom",
        "Germany",
        "France",
        "Japan",
        "India",
        "Brazil",
        "Canada",
        "Australia",
        "China",
        "Russia",
        "Turkey",
        "South Korea",
        "Mexico",
        "Spain",
        "Italy",
        "Netherlands",
        "Sweden",
        "Poland",
        "Saudi Arabia",
        "South Africa",
        "United Arab Emirates",
        "Singapore",
        "Hong Kong",
        "Taiwan",
        "Thailand",
        "Indonesia",
        "Malaysia",
        "Philippines",
        "Vietnam",
        "Egypt",
        "Nigeria",
        "Kenya",
        "Israel",
        "Switzerland",
        "Austria",
        "Belgium",
        "Denmark",
        "Finland",
        "Norway",
        "Portugal",
        "Ireland",
        "New Zealand",
        "Argentina",
        "Chile",
        "Colombia",
        "Peru",
        "Ukraine",
        "Czechia",
        "Romania",
        "Greece",
        "Hungary",
        "Slovakia",
        "Bulgaria",
        "Croatia",
        "Lithuania",
        "Latvia",
        "Estonia",
        "Iceland",
        "Luxembourg",
        "Malta",
        "Cyprus"
      ],
      "prefill": "us",
      "sectionCaption": "Storefront",
      "title": "Storefront country",
      "type": "string"
    },
    "developerId": {
      "description": "Apple artist ID or developer page URL (mode=developer). For example 281956209 or https://apps.apple.com/us/developer/google/id281956209. Comma-separated values are accepted.",
      "editor": "textfield",
      "title": "Developer ID or URL",
      "type": "string"
    },
    "developerName": {
      "description": "Publisher name to resolve when you do not know the developer ID (mode=developer). The actor searches App Store listings and matches the publisher name.",
      "editor": "textfield",
      "title": "Developer name",
      "type": "string"
    },
    "includeDetails": {
      "default": true,
      "description": "Add App Store detail fields such as privacy labels, version history, rating histogram, support URL, and subtitle (app-producing modes). Disable it for the fastest, cheapest search runs.",
      "prefill": false,
      "sectionCaption": "Output and limits",
      "title": "Include rich app details",
      "type": "boolean"
    },
    "includeDeveloperResponses": {
      "default": true,
      "description": "Keep developer replies when Apple exposes them (mode=reviews). Replies are available only for apps where the developer actually responded.",
      "prefill": false,
      "title": "Include developer responses",
      "type": "boolean"
    },
    "language": {
      "default": "en-US",
      "description": "Language used for App Store metadata and reviews. Defaults to English (United States).",
      "editor": "select",
      "enum": [
        "en-US",
        "en-GB",
        "de-DE",
        "fr-FR",
        "es-ES",
        "it-IT",
        "ja-JP",
        "ko-KR",
        "pt-BR",
        "ru-RU",
        "zh-CN",
        "nl-NL",
        "sv-SE",
        "pl-PL",
        "tr-TR",
        "ar-SA"
      ],
      "enumTitles": [
        "English (United States)",
        "English (United Kingdom)",
        "German",
        "French",
        "Spanish",
        "Italian",
        "Japanese",
        "Korean",
        "Portuguese (Brazil)",
        "Russian",
        "Chinese (Simplified)",
        "Dutch",
        "Swedish",
        "Polish",
        "Turkish",
        "Arabic"
      ],
      "prefill": "en-US",
      "title": "Storefront language",
      "type": "string"
    },
    "maxItems": {
      "default": 100,
      "description": "Hard cap on rows pushed per run (1-5000). Applies to apps, chart rows, and reviews combined. For very large review corpora, raise this and set maxReviewsPerApp.",
      "editor": "number",
      "maximum": 5000,
      "minimum": 1,
      "prefill": 3,
      "sectionCaption": "Reviews",
      "title": "Maximum records",
      "type": "integer"
    },
    "maxReviewsPerApp": {
      "default": 200,
      "description": "Reviews to collect for each app (1-50000). The deep review route returns 20 per request; RSS enrichment is available for the first 500 reviews when version or helpful-vote data exists.",
      "editor": "number",
      "maximum": 50000,
      "minimum": 1,
      "prefill": 20,
      "title": "Maximum reviews per app",
      "type": "integer"
    },
    "mode": {
      "default": "search",
      "description": "What to collect. Search finds apps by keyword, Lookup resolves IDs/URLs, Reviews collects customer feedback, Developer lists a publisher's apps, and Charts reads a top list.",
      "editor": "select",
      "enum": [
        "search",
        "lookup",
        "reviews",
        "developer",
        "charts"
      ],
      "enumTitles": [
        "Search by keyword",
        "Look up apps by ID or URL",
        "Collect customer reviews",
        "List a developer's apps",
        "Read top charts"
      ],
      "prefill": "search",
      "sectionCaption": "What to collect",
      "title": "Mode",
      "type": "string"
    },
    "proxyConfiguration": {
      "default": {
        "useApifyProxy": false
      },
      "description": "Optional. The actor works without a proxy. Add an Apify Proxy configuration only if your own network or a future Apple rate limit needs it.",
      "editor": "proxy",
      "title": "Proxy configuration",
      "type": "object"
    },
    "reviewSort": {
      "default": "recent",
      "description": "Most recent first, or Apple's most-helpful ordering (mode=reviews).",
      "editor": "select",
      "enum": [
        "recent",
        "helpful"
      ],
      "enumTitles": [
        "Most recent",
        "Most helpful"
      ],
      "prefill": "recent",
      "title": "Review order",
      "type": "string"
    },
    "searchTerms": {
      "description": "Keywords to search for (mode=search). Each term returns up to 200 ranked apps, and results are de-duplicated across terms.",
      "editor": "stringList",
      "prefill": [
        "calculator"
      ],
      "title": "Search terms",
      "type": "array"
    },
    "startUrls": {
      "description": "Paste App Store app or developer URLs (mode=lookup/reviews). App URLs resolve to one app; developer URLs expand to that publisher's catalog.",
      "editor": "requestListSources",
      "title": "App Store URLs",
      "type": "array"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "iOS App Store Deep Reviews & App Intelligence Input",
  "type": "object"
}