{
  "openapi": "3.0.1",
  "info": {
    "title": "App Store & Google Play Scraper",
    "description": "Scrape App Store and Google Play in one run: ASO keyword research (suggestions, popularity, difficulty), keyword ranks, top charts up to 200, app details and developer portfolios. Ratings, installs, prices, IAPs, developer contacts.",
    "version": "0.0",
    "x-build-id": "gHPPlkhehrHhS5ZYe"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/d_nepoch~app-store-google-play-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-d_nepoch-app-store-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/d_nepoch~app-store-google-play-scraper/runs": {
      "post": {
        "operationId": "runs-sync-d_nepoch-app-store-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/d_nepoch~app-store-google-play-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-d_nepoch-app-store-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 keywords",
            "type": "array",
            "description": "Keywords to search in the stores, e.g. 'meditation' or 'budget planner'. Each result gets its rank, so you can track ASO keyword positions over time.",
            "items": {
              "type": "string"
            }
          },
          "charts": {
            "title": "Top charts",
            "type": "array",
            "description": "Top charts to scrape, up to 200 apps each with rank. The App Store web charts have top free and top paid only.",
            "items": {
              "type": "string",
              "enum": [
                "top-free",
                "top-paid",
                "top-grossing"
              ],
              "enumTitles": [
                "Top free",
                "Top paid",
                "Top grossing (Google Play only)"
              ]
            }
          },
          "chartCategories": {
            "title": "Chart categories",
            "type": "array",
            "description": "Categories for the charts. Use one name for both stores: ALL, GAMES, BOOKS, BUSINESS, DEVELOPER_TOOLS, EDUCATION, ENTERTAINMENT, FINANCE, FOOD_AND_DRINK, GRAPHICS_AND_DESIGN, HEALTH_AND_FITNESS, LIFESTYLE, MEDICAL, MUSIC, NAVIGATION, NEWS, PHOTO_AND_VIDEO, PRODUCTIVITY, SHOPPING, SOCIAL, SPORTS, TRAVEL, UTILITIES, WEATHER. Store-specific codes also work: an App Store genre ID (e.g. 7012 for puzzle games) or a Google Play category (e.g. GAME_PUZZLE). Default: ALL.",
            "items": {
              "type": "string"
            }
          },
          "appStoreApps": {
            "title": "App Store apps",
            "type": "array",
            "description": "Specific App Store apps: numeric IDs (324684580) or apps.apple.com URLs. Returns full details incl. ratings histogram, in-app purchases, privacy labels and similar apps.",
            "items": {
              "type": "string"
            }
          },
          "googlePlayApps": {
            "title": "Google Play apps",
            "type": "array",
            "description": "Specific Google Play apps: package names (com.spotify.music) or play.google.com URLs. Returns full details incl. exact installs, ratings histogram, developer email and data safety.",
            "items": {
              "type": "string"
            }
          },
          "developers": {
            "title": "Developers",
            "type": "array",
            "description": "All apps of a developer. App Store: developer URL (apps.apple.com/us/developer/name/id123) or 'apple:123'. Google Play: developer URL or the exact developer name, e.g. 'Spotify AB'.",
            "items": {
              "type": "string"
            }
          },
          "keywordSeeds": {
            "title": "Keyword research: seed keywords",
            "type": "array",
            "description": "ASO keyword research. For each seed (e.g. 'meditation', 'budget planner') we collect the keywords the store itself suggests in its search box, then score each one: popularity (how few letters users type before the store suggests it), difficulty (strength of the top 10 apps and how many have the keyword in their title), the top 5 apps and the ranks of your tracked apps. One dataset row per keyword, charged as a 'keyword' result.",
            "items": {
              "type": "string"
            }
          },
          "keywordExpansion": {
            "title": "Find more keywords",
            "enum": [
              "alphabet",
              "none"
            ],
            "type": "string",
            "description": "'Seed + a…z' also asks the store for 'seed a', 'seed b' … 'seed z', which finds many more long-tail keywords (up to ~260 on the App Store, ~130 on Google Play per seed).",
            "default": "alphabet"
          },
          "maxKeywords": {
            "title": "Max keywords per seed",
            "minimum": 1,
            "maximum": 300,
            "type": "integer",
            "description": "How many keywords to keep for each seed, store and country (the seed itself comes first, then suggestions in store order).",
            "default": 50
          },
          "keywordPopularity": {
            "title": "Popularity score",
            "type": "boolean",
            "description": "Score 1–100: how early the store suggests the keyword while typing it. Keywords suggested after 1–2 letters are searched a lot. Adds a few quick requests per keyword.",
            "default": true
          },
          "keywordMetrics": {
            "title": "Difficulty and top apps",
            "type": "boolean",
            "description": "Search each keyword in the store and add difficulty (0–100), title matches, average rating and ratings/installs of the top apps, the top 5 apps and the ranks of your tracked apps.",
            "default": true
          },
          "trackApps": {
            "title": "Your apps to track in keyword results",
            "type": "array",
            "description": "Optional: your App Store IDs/URLs and Google Play package names/URLs. Each keyword row then shows where these apps rank for that keyword (null = not in the results checked; App Store checks up to 'Max results' apps, Google Play about 30).",
            "items": {
              "type": "string"
            }
          },
          "stores": {
            "title": "Stores",
            "type": "array",
            "description": "Stores used for search keywords and charts. Default: both.",
            "items": {
              "type": "string",
              "enum": [
                "appstore",
                "googleplay"
              ],
              "enumTitles": [
                "Apple App Store",
                "Google Play"
              ]
            },
            "default": [
              "appstore",
              "googleplay"
            ]
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Two-letter country codes (us, gb, de, jp...). Every job runs once per country. Default: us.",
            "default": [
              "us"
            ],
            "items": {
              "type": "string"
            }
          },
          "language": {
            "title": "Language (Google Play)",
            "type": "string",
            "description": "Language of Google Play texts, e.g. en, de, es, pt-BR. App Store texts come in the country's default language.",
            "default": "en"
          },
          "maxResults": {
            "title": "Max results per search, chart or developer",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "How many apps to take from each search term, chart and developer (per store and country). Charts go up to 200; Google Play web search returns about 30 apps per keyword.",
            "default": 50
          },
          "fullDetails": {
            "title": "Full details for search and chart results",
            "type": "boolean",
            "description": "Also open each app's page to add ratings histogram, review count, exact installs, developer email, privacy labels and similar apps. Slower; the price per app stays the same. Apps listed by ID always get full details.",
            "default": false
          },
          "appleDevice": {
            "title": "App Store charts device",
            "enum": [
              "iphone",
              "ipad"
            ],
            "type": "string",
            "description": "Which App Store charts to read.",
            "default": "iphone"
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify datacenter proxy works for both stores; change only if you see blocks.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}