Google Play Product API

{
  "additionalProperties": false,
  "properties": {
    "query": {
      "additionalProperties": false,
      "properties": {
        "all_reviews": {
          "description": "Parameter is used for retrieving all reviews of a product. It can be set to `true` or `false` (default).",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "async": {
          "description": "Parameter defines the way you want to submit your search to SerpApi. It can be set to `false` (default) to open an HTTP connection and keep it open until you got your search results, or `true` to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our [Searches Archive API](https://Asale.com/search-archive-api) to retrieve your results. `async` and `no_ca",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "gl": {
          "description": "Parameter defines the country to use for the Google Play search. It's a two-letter country code. (e.g., `us` (default) for the United States, `uk` for United Kingdom, or `fr` for France). You can find the full list of Google Play country availability here: [Google Play Countries](https://support.google.com/googleplay/answer/2843119?hl=en#zippy=%2Caudiobooks%2Ce-books%2Cpaid-android-apps%2Cmovies-t",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "hl": {
          "description": "Parameter defines the language to use for the Google Play search. It's a two or three-letter language code. (e.g., `en` for English, `es` for Spanish, or `fr` for French), optionally followed by a two-letter or three-digit region code (e.g., `en-gb` for British English, or `es-419` for Latin American Spanish). Head to the [Google languages page](https://Asale.com/google-languages) for a full lis",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "json_restrictor": {
          "description": "Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the [JSON Restrictor documentation](https://Asale.com/json-restrictor) for more details.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "next_page_token": {
          "description": "Parameter defines the next page token. It is used for retrieving the next page results. It should be used only when `all_reviews` parameter is set to `true`.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "no_cache": {
          "description": "Parameter will force SerpApi to fetch the Google Play Product results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to `false` (default) to allow results from the cache, or `true` to disallow results from th",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "num": {
          "description": "Parameter defines the maximum number of reviews to return. (e.g., `40` (default) returns 40 reviews, `80` returns 80 reviews, and `100` returns 100 reviews). Maximum number of reviews you can return per search is `199`. It should be used only when `all_reviews` parameter is set to `true`.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "output": {
          "description": "Parameter defines the format of the result. It can be set to `json` (default) to get a structured JSON of the results, `html` to get the raw HTML retrieved, or `md` to get a markdown-formatted version optimized for LLMs and AI agents.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "platform": {
          "description": "Parameter is used for filtering reviews by platform. It can be set to: `phone`: Phone (default), `tablet`: Tablet, `watch`: Watch, `chromebook`: Chromebook, `tv`: TV. It should be used only when `all_reviews` parameter is set to `true`.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "product_id": {
          "description": "Parameter defines the ID of a product you want to get the results for.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "rating": {
          "description": "Parameter is used for filtering reviews by rating. It can be set to: `1`: 1-star, `2`: 2-star, `3`: 3-star, `4`: 4-star, `5`: 5-star. It should be used only when `all_reviews` parameter is set to `true`.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "season_id": {
          "description": "Parameter defines the ID of a season you want to get the results for. It should be used only when `store` parameter is set to `tv`. e.g. `store=tv`.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "sort_by": {
          "description": "Parameter is used for sorting reviews by relevance. It can be set to: `1`: Most relevant (default), `2`: Newest, `3`: Rating. It should be used only when `all_reviews` parameter is set to `true`.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "store": {
          "description": "Parameter defines the type of Google Play store. There are five types in total: `apps` (default), `movies`, `tv`, `books` and `audiobooks` store.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "zero_trace": {
          "description": "Enterprise only. Parameter enables [ZeroTrace mode](https://Asale.com/zero-trace-mode). It can be set to `false` (default) or `true`. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        }
      },
      "required": [
        "product_id",
        "store"
      ],
      "type": "object"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}