App Store Search, Lookup & Reviews Scraper

{
  "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"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "App metadata, chart rankings, and customer reviews from the iOS App Store, including privacy labels, version history, and developer responses when Apple exposes them.",
  "properties": {
    "apps": {
      "description": "Dataset containing App Store apps, developer catalog entries, and chart rows.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "App and chart records",
      "type": "string"
    },
    "reviews": {
      "description": "Dataset containing App Store customer reviews and any developer responses.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Customer reviews",
      "type": "string"
    }
  },
  "title": "iOS App Store Deep Reviews & App Intelligence Output"
}

{
  "actorSpecification": 1,
  "description": "App records, chart rows, and customer reviews from the iOS App Store",
  "title": "App Store Data",
  "views": {
    "detailed": {
      "description": "Every collected app field, including privacy labels and version history",
      "display": {
        "component": "table",
        "properties": {
          "currency": {
            "format": "text",
            "label": "Currency"
          },
          "developer": {
            "format": "text",
            "label": "Developer"
          },
          "id": {
            "format": "text",
            "label": "App ID"
          },
          "minimumOs": {
            "format": "text",
            "label": "Minimum OS"
          },
          "name": {
            "format": "text",
            "label": "Name"
          },
          "price": {
            "format": "number",
            "label": "Price"
          },
          "rating": {
            "format": "number",
            "label": "Rating"
          },
          "ratingCount": {
            "format": "number",
            "label": "Rating Count"
          },
          "scrapedAt": {
            "format": "text",
            "label": "Scraped At"
          },
          "url": {
            "format": "link",
            "label": "App Store URL"
          },
          "version": {
            "format": "text",
            "label": "Version"
          }
        }
      },
      "title": "Detailed App Data",
      "transformation": {
        "fields": [
          "id",
          "bundleId",
          "name",
          "subtitle",
          "developer",
          "developerId",
          "developerUrl",
          "developerWebsite",
          "price",
          "formattedPrice",
          "currency",
          "isFree",
          "rating",
          "ratingCount",
          "currentVersionRating",
          "currentVersionRatingCount",
          "ratingHistogram",
          "description",
          "releaseNotes",
          "version",
          "releaseDate",
          "lastUpdated",
          "category",
          "genres",
          "contentRating",
          "ageRating",
          "minimumOs",
          "requirements",
          "fileSize",
          "size",
          "icon",
          "screenshots",
          "ipadScreenshots",
          "languages",
          "privacy",
          "privacyPolicyUrl",
          "supportUrl",
          "versionHistory",
          "chartPosition",
          "chartType",
          "country",
          "language",
          "url",
          "sourceUrl",
          "scrapedAt"
        ]
      }
    },
    "overview": {
      "description": "App and chart records with pricing, ratings, and storefront links",
      "display": {
        "component": "table",
        "properties": {
          "chartPosition": {
            "format": "number",
            "label": "Chart Position"
          },
          "currency": {
            "format": "text",
            "label": "Currency"
          },
          "developer": {
            "format": "text",
            "label": "Developer"
          },
          "genres": {
            "format": "text",
            "label": "Genres"
          },
          "id": {
            "format": "text",
            "label": "App ID"
          },
          "name": {
            "format": "text",
            "label": "Name"
          },
          "price": {
            "format": "number",
            "label": "Price"
          },
          "rating": {
            "format": "number",
            "label": "Rating"
          },
          "ratingCount": {
            "format": "number",
            "label": "Rating Count"
          },
          "url": {
            "format": "link",
            "label": "App Store URL"
          },
          "version": {
            "format": "text",
            "label": "Version"
          }
        }
      },
      "title": "Apps & Charts",
      "transformation": {
        "fields": [
          "id",
          "name",
          "developer",
          "price",
          "currency",
          "rating",
          "ratingCount",
          "genres",
          "version",
          "chartPosition",
          "url"
        ]
      }
    },
    "reviews": {
      "description": "Customer reviews with ratings, versions, and developer replies",
      "display": {
        "component": "table",
        "properties": {
          "appId": {
            "format": "text",
            "label": "App ID"
          },
          "author": {
            "format": "text",
            "label": "Author"
          },
          "date": {
            "format": "text",
            "label": "Date"
          },
          "developerResponse": {
            "format": "text",
            "label": "Developer Response"
          },
          "id": {
            "format": "text",
            "label": "Review ID"
          },
          "rating": {
            "format": "number",
            "label": "Rating"
          },
          "sourceUrl": {
            "format": "link",
            "label": "Source"
          },
          "title": {
            "format": "text",
            "label": "Title"
          },
          "version": {
            "format": "text",
            "label": "Version"
          }
        }
      },
      "title": "Reviews",
      "transformation": {
        "fields": [
          "id",
          "appId",
          "appName",
          "country",
          "rating",
          "title",
          "text",
          "author",
          "authorUrl",
          "date",
          "version",
          "voteCount",
          "voteSum",
          "developerResponse",
          "sourceUrl",
          "scrapedAt"
        ]
      }
    }
  }
}