{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Play Apps - Search, Ratings & Installs",
    "description": "Search Google Play apps by keywords or Android package IDs across country storefronts. One row per app: title, developer, rating, install label, upfront price, currency and URL. ID lookups add versions and updates. Filter free or paid apps, ratings and developers; skip saved IDs or hashes.",
    "version": "1.3",
    "x-build-id": "9nBD25KOaizADAILn"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/kestrel~google-play-app-discovery/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-kestrel-google-play-app-discovery",
        "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/kestrel~google-play-app-discovery/runs": {
      "post": {
        "operationId": "runs-sync-kestrel-google-play-app-discovery",
        "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/kestrel~google-play-app-discovery/run-sync": {
      "post": {
        "operationId": "run-sync-kestrel-google-play-app-discovery",
        "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": {
          "queries": {
            "title": "Queries",
            "type": "array",
            "description": "Keyword searches, e.g. [\"python\"] for Indeed or [\"budget planner\"] for Google Play. Up to 20; any language. Indeed requires locations; Google Play accepts queries, appIds or both. Each query/location/country (Indeed) or query/country (Play) is one paid source check. First public results response only; no pagination.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Country storefront/search editions, e.g. [\"US\"] (default), [\"GB\"] or [\"DE\", \"JP\"]. Not developer nationality or an IP-geolocation guarantee. Indeed supports US, GB, CA only. Google Play supports US, GB, CA, AU, DE, FR, JP, IN, AE, SG, BR, ES, IT. Each country multiplies source checks. Prices retain local currencies.",
            "items": {
              "type": "string"
            },
            "default": [
              "US"
            ]
          },
          "language": {
            "title": "Language",
            "enum": [
              "en",
              "de",
              "fr",
              "es",
              "pt",
              "ja",
              "ar",
              "zh",
              "ko",
              "it",
              "hi"
            ],
            "type": "string",
            "description": "Google Play listing language, e.g. \"en\" (default), \"de\" or \"ja\". Independent of storefront country; no automatic translation. Supported: en, de, fr, es, pt, ja, ar, zh, ko, it, hi. Dataset IDs include app, country and language. No extra language fee.",
            "default": "en"
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum paid rows across the ENTIRE run after filters, exclusions and deduplication; default 20, range 1–1000. Earlier targets can fill it. Set maxTotalChargeUsd in Apify run options for a dollar cap, not inside input JSON. A result cap does not expand source coverage.",
            "default": 20
          },
          "appIds": {
            "title": "App ids",
            "type": "array",
            "description": "Android package IDs, e.g. [\"com.spotify.music\", \"com.whatsapp\"]. Up to 100; no URLs or Apple IDs. Provide appIds, queries or both. IDs run before queries within each country and add version, update date and rating count when exposed. Each ID/country is a paid check plus one row fee if delivered.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "searchLimit": {
            "title": "Search limit",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Maximum Google Play search cards considered per query/country, default 30, range 1–100. The source often exposes only 30; increasing this does not add pages. Before filters, unlike global maxResults. Does not affect app ID lookups. One check fee plus delivered-app fees.",
            "default": 30
          },
          "minRating": {
            "title": "Min rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Minimum Google Play rating from 0 to 5, e.g. 4.0; 0 disables. Missing ratings fail a positive threshold. Country-specific public ratings can change. Applied before maxResults; no extra filter fee, valid checks remain paid.",
            "default": 0
          },
          "priceType": {
            "title": "Price type",
            "enum": [
              "all",
              "free",
              "paid"
            ],
            "type": "string",
            "description": "Google Play \"all\" (default), \"free\" for upfront price 0, or \"paid\" for positive upfront price in local currency. Unknown prices fail an active filter. This does not classify subscriptions or in-app purchases. Filters before maxResults; valid checks remain paid.",
            "default": "all"
          },
          "developerContains": {
            "title": "Developer contains",
            "type": "array",
            "description": "Optional Google Play developer-name OR phrases, e.g. [\"Google\"]. [] disables. Filters returned apps before maxResults; no complete developer-catalogue lookup. No extra filter fee; valid source checks remain paid.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "textContains": {
            "title": "Text contains",
            "type": "array",
            "description": "Optional case-insensitive OR phrases, e.g. [\"python\", \"developer\"]. Matches title, caption/snippet/description, author, company or developer fields when present. [] disables. Filters before maxResults. Skipped rows have no row fee; valid source checks are paid.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "maxSources": {
            "title": "Max sources",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Maximum attempted source targets across the run; default 20, range 1–100. One post/video URL, Indeed query/location/country, or Play query-or-ID/country counts as one. Failed targets count toward this limit but have no event fee. Valid filtered sources are paid; retries add no source fee.",
            "default": 20
          },
          "excludeIds": {
            "title": "Exclude ids",
            "type": "array",
            "description": "Prior dataset id values, e.g. [] on a first run; up to 5,000. Skips identities even when changed. For Google Play use the full app:country:language id. Excluded rows are free but valid checks are paid. Keep history in your workflow; no automatic persistence.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "excludeContentHashes": {
            "title": "Exclude content hashes",
            "type": "array",
            "description": "Prior content_hash values, e.g. [] initially; up to 5,000 SHA-256 hashes. Skips unchanged observations while allowing updates. Do not also exclude IDs when changes matter. Time, search position, image URLs and relative-date labels do not affect hashes. Valid source checks remain paid; no stored history.",
            "items": {
              "type": "string"
            },
            "default": []
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}