---
updatedAt: 2025-11-07T23:56:32.000Z
agentTools:
  projectIndex: https://developers.similarweb.com/llms.txt
---

# App Downloads - Legacy

Returns the number of times an app was downloaded from the Google Play/ Apple App store over a given time frame.

> 📘 Price
>
> **1 hit** per request or **1 credit** per result.

> 🚧 Premium Endpoint
>
> This endpoint is available to customers with access to Similarweb App Intelligence add-on in their subscription. Reach out to your Account Manager for more information.

> ❗️ Limitation
>
> As of Nov 30, 2022, new data for iOS downloads will not be available. Historical data will continue to be supported.

For iOS apps, downloads are currently only available for the USA (“country=us”).

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "app-downloads",
    "version": "4.0"
  },
  "servers": [
    {
      "url": "https://api.similarweb.com/v1/app/"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/{store}/{app_id}/engagement/downloads": {
      "get": {
        "summary": "App Downloads - Legacy",
        "description": "Returns the number of times an app was downloaded from the Google Play/ Apple App store over a given time frame.",
        "operationId": "app-downloads",
        "parameters": [
          {
            "name": "store",
            "in": "path",
            "description": "Input either \"Google\" (Android) or \"Apple\" (iOS).",
            "schema": {
              "type": "string",
              "default": "Google"
            },
            "required": true
          },
          {
            "name": "app_id",
            "in": "path",
            "description": "Enter an app ID. [How to find App IDs](https://developers.similarweb.com/docs/how-to-find-app-ids)",
            "schema": {
              "type": "string",
              "default": "com.whatsapp"
            },
            "required": true
          },
          {
            "name": "api_key",
            "in": "query",
            "description": "Your Similarweb API key.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "Add_Your_API_KEY"
            }
          },
          {
            "name": "start_date",
            "in": "query",
            "description": "Start month (format: YYYY-MM)",
            "required": true,
            "schema": {
              "type": "string",
              "default": "2023-01"
            }
          },
          {
            "name": "end_month",
            "in": "query",
            "description": "End month (format: YYYY-MM)",
            "required": true,
            "schema": {
              "type": "string",
              "default": "2023-03"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Country filter, as a 2-letter ISO country code. To see the country filters you have access to, please refer to the Check Capabilities endpoint. For iOS apps, downloads are currently only available for the USA (“country=us”).",
            "required": true,
            "schema": {
              "type": "string",
              "default": "us"
            }
          },
          {
            "name": "granularity",
            "in": "query",
            "description": "Set the granularity for the returned values. Can be 'daily', 'weekly' or 'monthly'.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "monthly"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "[optional] Format in which the reply should be returned. Possible values: 'json' (default) or 'xml'.",
            "schema": {
              "type": "string",
              "default": "json"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "VIEW EXAMPLE RESPONSE": {
                    "value": "{\n  \"meta\": {\n    \"request\": {\n      \"granularity\": \"Monthly\",\n      \"start_date\": \"2017-11\",\n      \"end_date\": \"2018-06\",\n      \"store\": \"Google\",\n      \"app_id\": \"com.whatsapp\",\n      \"category\": null,\n      \"mode\": null,\n      \"device\": null,\n      \"format\": \"json\",\n      \"country\": \"us\"\n    },\n    \"status\": \"Success\",\n    \"last_updated\": \"2019-08-31\"\n  },\n  \"downloads\": [\n    {\n      \"start_date\": \"2017-11-01\",\n      \"end_date\": \"2017-11-30\",\n      \"downloads\": 4099107.5378811476\n    },\n    {\n      \"start_date\": \"2017-12-01\",\n      \"end_date\": \"2017-12-31\",\n      \"downloads\": 4501398.74890618\n    },\n    {\n      \"start_date\": \"2018-01-01\",\n      \"end_date\": \"2018-01-31\",\n      \"downloads\": 4963045.230733452\n    },\n    {\n      \"start_date\": \"2018-02-01\",\n      \"end_date\": \"2018-02-28\",\n      \"downloads\": 4057709.763520993\n    },\n    {\n      \"start_date\": \"2018-03-01\",\n      \"end_date\": \"2018-03-31\",\n      \"downloads\": 4374300.780976184\n    },\n    {\n      \"start_date\": \"2018-04-01\",\n      \"end_date\": \"2018-04-30\",\n      \"downloads\": 4276875.675234439\n    },\n    {\n      \"start_date\": \"2018-05-01\",\n      \"end_date\": \"2018-05-31\",\n      \"downloads\": 5028653.173230392\n    },\n    {\n      \"start_date\": \"2018-06-01\",\n      \"end_date\": \"2018-06-30\",\n      \"downloads\": 3670557.3727469714\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "meta": {
                      "type": "object",
                      "properties": {
                        "request": {
                          "type": "object",
                          "properties": {
                            "granularity": {
                              "type": "string",
                              "example": "Monthly"
                            },
                            "start_date": {
                              "type": "string",
                              "example": "2017-11"
                            },
                            "end_date": {
                              "type": "string",
                              "example": "2018-06"
                            },
                            "store": {
                              "type": "string",
                              "example": "Google"
                            },
                            "app_id": {
                              "type": "string",
                              "example": "com.whatsapp"
                            },
                            "category": {},
                            "mode": {},
                            "device": {},
                            "format": {
                              "type": "string",
                              "example": "json"
                            },
                            "country": {
                              "type": "string",
                              "example": "us"
                            }
                          }
                        },
                        "status": {
                          "type": "string",
                          "example": "Success"
                        },
                        "last_updated": {
                          "type": "string",
                          "example": "2019-08-31"
                        }
                      }
                    },
                    "downloads": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "start_date": {
                            "type": "string",
                            "example": "2017-11-01"
                          },
                          "end_date": {
                            "type": "string",
                            "example": "2017-11-30"
                          },
                          "downloads": {
                            "type": "number",
                            "example": 4099107.5378811476,
                            "default": 0
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```