{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Play Scraper - Apps, Charts, Developers & Data Safety",
    "description": "Scrape Google Play apps by keyword, top chart, developer, similar apps or app ID: installs, ratings, price, developer email and website, version, release notes, data safety, permissions. Rank tracking and monitor mode. $0.27 per 1,000 apps, no start fee.",
    "version": "0.1",
    "x-build-id": "0rEveo84y0Mt9gQL6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~google-play-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-google-play-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/topapi~google-play-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-google-play-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/topapi~google-play-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-google-play-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Keywords to search on Google Play, as you would type them in the store (e.g. habit tracker, vpn, photo editor). Google Play answers one page of 20-30 apps per keyword; turn on 'Add search suggestions' or use several related keywords for wider coverage.",
            "items": {
              "type": "string"
            }
          },
          "appIds": {
            "title": "App IDs or URLs",
            "type": "array",
            "description": "Package names (com.whatsapp) or Google Play app links (https://play.google.com/store/apps/details?id=com.whatsapp). Each one returns one full app row.",
            "items": {
              "type": "string"
            }
          },
          "developerIds": {
            "title": "Developers",
            "type": "array",
            "description": "A developer name exactly as Google Play shows it (Spotify AB), a numeric developer ID (5700313618786177705) or a developer page link. Returns every app the developer lists, up to 'Max results per source'.",
            "items": {
              "type": "string"
            }
          },
          "similarToAppIds": {
            "title": "Similar apps to",
            "type": "array",
            "description": "Package names or app links. For each one, returns the apps Google Play lists under 'Similar apps' (about 50 per app).",
            "items": {
              "type": "string"
            }
          },
          "charts": {
            "title": "Top charts",
            "type": "array",
            "description": "Google Play top charts to read, ranked as the store ranks them (up to 200 per chart). Combined with every category in 'Chart categories'.",
            "items": {
              "type": "string",
              "enum": [
                "top-free",
                "top-paid",
                "top-grossing",
                "top-new-free",
                "trending"
              ],
              "enumTitles": [
                "Top free",
                "Top paid",
                "Top grossing",
                "Top new free",
                "Trending (movers & shakers)"
              ]
            }
          },
          "chartCategories": {
            "title": "Chart categories",
            "type": "array",
            "description": "Categories for the top charts. APPLICATION = all apps, GAME = all games. Only used when 'Top charts' is filled.",
            "items": {
              "type": "string",
              "enum": [
                "APPLICATION",
                "GAME",
                "FAMILY",
                "ANDROID_WEAR",
                "ART_AND_DESIGN",
                "AUTO_AND_VEHICLES",
                "BEAUTY",
                "BOOKS_AND_REFERENCE",
                "BUSINESS",
                "COMICS",
                "COMMUNICATION",
                "DATING",
                "EDUCATION",
                "ENTERTAINMENT",
                "EVENTS",
                "FINANCE",
                "FOOD_AND_DRINK",
                "HEALTH_AND_FITNESS",
                "HOUSE_AND_HOME",
                "LIBRARIES_AND_DEMO",
                "LIFESTYLE",
                "MAPS_AND_NAVIGATION",
                "MEDICAL",
                "MUSIC_AND_AUDIO",
                "NEWS_AND_MAGAZINES",
                "PARENTING",
                "PERSONALIZATION",
                "PHOTOGRAPHY",
                "PRODUCTIVITY",
                "SHOPPING",
                "SOCIAL",
                "SPORTS",
                "TOOLS",
                "TRAVEL_AND_LOCAL",
                "VIDEO_PLAYERS",
                "WATCH_FACE",
                "WEATHER",
                "GAME_ACTION",
                "GAME_ADVENTURE",
                "GAME_ARCADE",
                "GAME_BOARD",
                "GAME_CARD",
                "GAME_CASINO",
                "GAME_CASUAL",
                "GAME_EDUCATIONAL",
                "GAME_MUSIC",
                "GAME_PUZZLE",
                "GAME_RACING",
                "GAME_ROLE_PLAYING",
                "GAME_SIMULATION",
                "GAME_SPORTS",
                "GAME_STRATEGY",
                "GAME_TRIVIA",
                "GAME_WORD"
              ],
              "enumTitles": [
                "All apps",
                "All games",
                "Family",
                "Wear OS",
                "Art & design",
                "Auto & vehicles",
                "Beauty",
                "Books & reference",
                "Business",
                "Comics",
                "Communication",
                "Dating",
                "Education",
                "Entertainment",
                "Events",
                "Finance",
                "Food & drink",
                "Health & fitness",
                "House & home",
                "Libraries & demo",
                "Lifestyle",
                "Maps & navigation",
                "Medical",
                "Music & audio",
                "News & magazines",
                "Parenting",
                "Personalization",
                "Photography",
                "Productivity",
                "Shopping",
                "Social",
                "Sports",
                "Tools",
                "Travel & local",
                "Video players & editors",
                "Watch faces",
                "Weather",
                "Games: Action",
                "Games: Adventure",
                "Games: Arcade",
                "Games: Board",
                "Games: Card",
                "Games: Casino",
                "Games: Casual",
                "Games: Educational",
                "Games: Music",
                "Games: Puzzle",
                "Games: Racing",
                "Games: Role playing",
                "Games: Simulation",
                "Games: Sports",
                "Games: Strategy",
                "Games: Trivia",
                "Games: Word"
              ]
            },
            "default": [
              "APPLICATION"
            ]
          },
          "startUrls": {
            "title": "Google Play URLs",
            "type": "array",
            "description": "Any Google Play app link, search link (?q=...&c=apps, &price=1 free / 2 paid), developer link (/store/apps/developer?id= or /store/apps/dev?id=) or cluster link (/store/apps/collection/cluster?gsr=...). An hl / gl parameter on a link overrides Language / Country for that link.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Two-letter country code of the Play Store to read (us, gb, de, in, br, jp...). It changes prices and currency, availability, charts and search results.",
            "default": "us"
          },
          "countries": {
            "title": "Several countries",
            "type": "array",
            "description": "Optional. Run every search, chart, developer and app above against each of these countries (e.g. us, gb, de). Overrides Country. Rows carry their country.",
            "items": {
              "type": "string"
            }
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Language code for store texts: en, de, es, pt-BR, zh-TW, ja... Titles, descriptions, genres and release notes come back in this language where the developer translated them.",
            "default": "en"
          },
          "maxResults": {
            "title": "Max results per source",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Apps read from each search term, chart, developer or similar-apps seed (in store order, before filters). Search serves up to about 30, charts up to 200, similar apps about 50. App IDs always return one row each.",
            "default": 50
          },
          "maxItems": {
            "title": "Max rows in total",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap on app rows for the whole run, across every source and country. The run stops cleanly when it is reached.",
            "default": 1000
          },
          "fullDetail": {
            "title": "Full app details",
            "type": "boolean",
            "description": "On: every app from a search, chart, developer or similar list comes back with the full record (installs and exact install count, rating count + histogram, description, developer email/website/address, version, updated date, content rating, screenshots...). Off: only the fields the list card carries. Same price either way.",
            "default": true
          },
          "includeDataSafety": {
            "title": "Data safety (paid add-on)",
            "type": "boolean",
            "description": "Adds the app's full Data safety section: every data type shared and collected, whether it is optional, why, and the security practices. Charged per app that publishes one. The short Data safety summary is always included for free.",
            "default": false
          },
          "includePermissions": {
            "title": "Permissions (paid add-on)",
            "type": "boolean",
            "description": "Adds every Android permission the app declares, with its group (Location, Camera, Other...). Charged per app that declares at least one.",
            "default": false
          },
          "includeSimilarApps": {
            "title": "Similar app IDs on each row",
            "type": "boolean",
            "description": "Adds the 6 'Similar apps' Google Play shows on each app's page as similarApps (package names). Free.",
            "default": false
          },
          "includeScreenshots": {
            "title": "Screenshots and video",
            "type": "boolean",
            "description": "Keep screenshot URLs, the promo video and the header image. Turn off for slimmer rows.",
            "default": true
          },
          "includeDeveloperContact": {
            "title": "Developer contact",
            "type": "boolean",
            "description": "Keep the developer's email, website, address and phone (as Google Play publishes them under App support). Turn off to leave them out.",
            "default": true
          },
          "includeDescriptionHTML": {
            "title": "Description HTML",
            "type": "boolean",
            "description": "Keep descriptionHTML and recentChangesHTML next to the plain-text versions.",
            "default": true
          },
          "expandSearchSuggestions": {
            "title": "Add search suggestions",
            "type": "boolean",
            "description": "Also search Google Play's own autocomplete suggestions for each search term (e.g. 'habit' -> 'habit tracker', 'habit tracking apps'), to reach more apps than one results page holds.",
            "default": false
          },
          "maxSuggestionsPerTerm": {
            "title": "Suggestions per search term",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many autocomplete suggestions to add per search term when 'Add search suggestions' is on (Google offers up to 5).",
            "default": 5
          },
          "price": {
            "title": "Price",
            "enum": [
              "all",
              "free",
              "paid"
            ],
            "type": "string",
            "description": "Free or paid apps only. Search asks Google Play for that price directly; for every other source the filter runs before charging, so skipped apps are free.",
            "default": "all"
          },
          "minRating": {
            "title": "Minimum rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Skip apps rated below this (0-5). Unrated apps are skipped when this is set."
          },
          "minRatingsCount": {
            "title": "Minimum number of ratings",
            "minimum": 0,
            "type": "integer",
            "description": "Skip apps with fewer ratings."
          },
          "minInstalls": {
            "title": "Minimum installs",
            "minimum": 0,
            "type": "integer",
            "description": "Skip apps with fewer installs (Google's exact install count, e.g. 100000)."
          },
          "maxInstalls": {
            "title": "Maximum installs",
            "minimum": 0,
            "type": "integer",
            "description": "Skip apps with more installs, e.g. 100000 to find small developers."
          },
          "updatedAfter": {
            "title": "Updated on or after",
            "type": "string",
            "description": "Only apps updated on or after this date (YYYY-MM-DD, or a relative value like '30 days')."
          },
          "releasedAfter": {
            "title": "Released on or after",
            "type": "string",
            "description": "Only apps first released on or after this date (YYYY-MM-DD, or '90 days')."
          },
          "withEmailOnly": {
            "title": "Only apps with a developer email",
            "type": "boolean",
            "description": "Skip apps whose developer publishes no email.",
            "default": false
          },
          "withWebsiteOnly": {
            "title": "Only apps with a developer website",
            "type": "boolean",
            "description": "Skip apps whose developer publishes no website.",
            "default": false
          },
          "deduplicateApps": {
            "title": "One row per app",
            "type": "boolean",
            "description": "An app found by several searches, developers or seeds in the same country is returned (and charged) once. Chart rows are kept per chart, so an app in two charts keeps both ranks.",
            "default": true
          },
          "trackRankChanges": {
            "title": "Track chart rank changes",
            "type": "boolean",
            "description": "Compare each chart with the last time your account read it and add previousRank, rankChange (positive = moved up), newInChart and previousChartedAt.",
            "default": true
          },
          "monitorMode": {
            "title": "Monitor mode: only new apps",
            "type": "boolean",
            "description": "Return only apps this monitor has not returned before (per country and language). Schedule the same input daily to get just the new apps; the first run returns everything.",
            "default": false
          },
          "monitorIncludeUpdated": {
            "title": "Monitor: also apps that were updated",
            "type": "boolean",
            "description": "With monitor mode, also return apps already seen whose 'updated' date changed since the last run.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor store name",
            "type": "string",
            "description": "Named key-value store that keeps monitor state and chart ranks between runs. Use a different name per schedule to keep them apart.",
            "default": "google-play-scraper-state"
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Requests to Google Play in flight at once. Each request carries up to 20 apps.",
            "default": 5
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. By default the actor connects directly and moves to Apify datacenter, then residential proxies only if Google Play pushes back. Set a proxy here to use yours from the first request.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}