{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Play Scraper - App Details, Developer & Similar Apps",
    "description": "One Google Play scraper for four jobs: full app details by package name or URL, every app a developer publishes, the similar apps Google Play shows next to an app, and the apps in any category. Installs, ratings, prices and developer contact, as compact JSON for AI agents.",
    "version": "1.0",
    "x-build-id": "AdbMvQcVLyUeNdlpA"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/appdata-labs~google-play-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-appdata-labs-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/appdata-labs~google-play-scraper/runs": {
      "post": {
        "operationId": "runs-sync-appdata-labs-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/appdata-labs~google-play-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-appdata-labs-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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "details",
              "developer",
              "similar",
              "category"
            ],
            "type": "string",
            "description": "What to fetch. \"details\": the full listing of each app in appUrlsOrIds. \"developer\": every app by each publisher in developers. \"similar\": the apps Google Play shows as similar to each app in appUrlsOrIds. \"category\": the apps listed on each Google Play category page in categories. This Actor does not search Google Play and does not read reviews.",
            "default": "details"
          },
          "appUrlsOrIds": {
            "title": "Apps (details and similar modes)",
            "type": "array",
            "description": "Read in details and similar modes. Each entry is a package name (com.spotify.music) or a Google Play app URL (https://play.google.com/store/apps/details?id=com.spotify.music). An entry that is neither is skipped with its reason; the run fails only when none can be read. App names are not accepted, because turning a name into an app needs Google Play search, which this Actor does not use.",
            "default": [
              "com.spotify.music",
              "com.duolingo",
              "com.netflix.mediaclient",
              "com.whatsapp",
              "com.instagram.android",
              "org.telegram.messenger",
              "com.zhiliaoapp.musically",
              "com.google.android.youtube",
              "com.microsoft.teams",
              "com.ubercab"
            ],
            "items": {
              "type": "string"
            }
          },
          "developers": {
            "title": "Developers (developer mode)",
            "type": "array",
            "description": "Read in developer mode. Each entry can be a developer name as you would type it (\"Netflix\", tried with the usual company suffixes such as \", Inc.\" and \" AB\"), the exact name Google Play prints (\"Spotify AB\"), a Google Play developer page URL (https://play.google.com/store/apps/developer?id=Spotify+AB), or any app the publisher made (com.netflix.mediaclient), which is resolved to its developer.",
            "default": [
              "com.netflix.mediaclient"
            ],
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Categories (category mode)",
            "type": "array",
            "description": "Read in category mode. Google Play category IDs (HEALTH_AND_FITNESS, FINANCE) or the names the store shows (\"Health & Fitness\"). \"TOP\" reads the overall top-apps page. An unknown category is skipped with its reason. Each page lists roughly 30 to 90 apps.",
            "default": [
              "HEALTH_AND_FITNESS"
            ],
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Two-letter country codes of the Google Play storefronts to read. Availability, prices, similar apps and category pages all differ by country, so each country is read separately.",
            "default": [
              "us"
            ],
            "items": {
              "type": "string"
            }
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Language code for the text Google Play returns (titles, summaries, descriptions), such as \"en\", \"th\" or \"pt-br\". Independent of country.",
            "default": "en"
          },
          "maxAppsPerInput": {
            "title": "Max apps per input",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "In developer, similar and category modes: how many apps to return for each developer, seed app or category, in each country. Category pages are capped at 100. Ignored in details mode, which returns one row per app.",
            "default": 50
          },
          "includeDetails": {
            "title": "Add installs, category and developer contact",
            "type": "boolean",
            "description": "Off by default. In developer and similar modes, each app also gets its install count, number of ratings and reviews, category, content rating, release and update dates, and the developer email, website and privacy policy from its listing page. Adds about 1.5 seconds per app and is charged per app enriched. Details and category rows already carry all of this, so it changes nothing there.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}