ASOReport
General
Introduction Getting Started Authentication Server Status Error Handling API Errors Reference Rate Limiting Changelog FAQ
Play Store
Reference Data App Search Suggest Terms Apps List App Details Similar Apps Data Safety App Permissions App Reviews Developer Apps
App Store
Reference Data App Details App Search Apps List Developer Apps App Privacy Similar Apps App Reviews App Ratings App Version History Keyword Suggest
Other
Plans & Pricing Contact & Support Terms & Policies

Introduction

Welcome to the ASOReport API documentation. Here you'll find everything you need to get started and integrate with our API.

Getting Started

Learn how to obtain API keys, make your first request, and basic usage concepts.

Authentication

All API requests require authentication.
You can authenticate your requests in two ways:

Supported Platforms: Note:

Server Status

You can check the current status of the API server for both App Store and Play Store endpoints.

Note:

Error Handling

The API always returns a JSON response, even for errors.
If a request fails, the success field will be false and the error object provides details.

Example error response: 
{
    "success": false,
    "error": "invalid_api_key",
    "code": 1002,
    "http": 401,
    "message": "Invalid API key."
}

Tip: Use the code value for programmatic handling and troubleshooting.
Full list of errors and solutions can be found in the API Errors Reference.

API Errors Reference

This section lists all standard error codes returned by the API. Each error includes a code and a description to help you quickly identify and solve issues.

Error Code HTTP Description
missing_api_key 1001 401 API key is required but missing from the request.
invalid_api_key 1002 401 The provided API key is invalid.
paused 2001 403 The API key or subscription is paused.
canceled 2002 403 The subscription has been canceled.
expired 2003 403 The subscription has expired.
not_allowed 2004 403 You are not allowed to access this endpoint.
quota_exceeded 2005 429 You have exceeded your monthly or plan quota.
rate_limit 2006 429 Rate limit exceeded. Too many requests in a short period.
server_error 1500 500 Something went wrong on the server.
Example: 
{
    "success": false,
    "error": "quota_exceeded",
    "code": 2005,
    "http": 429,
    "message": "You have exceeded your monthly or plan quota."
}

Tip: For every failed request, check the error and code fields.
For detailed error handling, see the Error Handling section.

Rate Limiting

To ensure fair use and high performance, the API applies rate limits to all requests.
Limits are set according to your subscription plan and may be enforced per second, minute, hour, or day.

Sample Error Response: 
{
    "success": false,
    "error": "rate_limit",
    "code": 2006,
    "http": 429,
    "message": "Rate limit exceeded. Please try again later."
}
Note:

Changelog

Stay up to date with the latest changes, new features, improvements, and bug fixes in the ASOReport API.

Version 1.0.0

  • Initial public release of ASOReport API.
  • App Store and Play Store endpoints for app data, ratings, reviews, and more.
  • Rate limiting and error code standardization.
  • Improved authentication and error response consistency.
  • Documentation launched with clear endpoint usage and examples.

Frequently Asked Questions (FAQ)

Yes. All API endpoints require a valid API key for authentication, whether you are using App Store or Play Store routes.

  • Header method (recommended): Use X-Api-Key: YOUR_API_KEY in your request header.
  • URL method (browser): Include your API key in the URL path.
    Example:
    https://asoreport.com/api/YOUR_API_KEY/appstore/...
    https://asoreport.com/api/YOUR_API_KEY/play/...

Both App Store and Play Store APIs support endpoints for app details, ratings, reviews, privacy, similar apps, version history, and more.
See the sidebar navigation for the full list.

You will receive a JSON error response with success: false, an appropriate error code (e.g., 2005 for quota exceeded, 2006 for rate limiting), and a descriptive message. 
{
    "success": false,
    "error": "rate_limit",
    "code": 2006,
    "http": 429,
    "message": "Rate limit exceeded."
}

Check the API Errors Reference section for a full list of error codes, their meanings, and suggested solutions.

Yes. You can call endpoints via browser using the URL method, or from server/API clients using the header method for authentication.

Play Store Reference Data

These endpoints provide reference data for Google Play Store: supported languages, countries, collections, and categories.
Authentication required:

All endpoints accept a lang query parameter to localize the results.

GET /api/play/languages

Returns the list of supported languages in the current or specified language.
Query Params: lang (optional, default: en)
Example: 

curl -X GET "https://asoreport.com/api/play/languages?lang=fr" -H "X-Api-Key: YOUR_API_KEY"
https://asoreport.com/api/YOUR_API_KEY/play/languages?lang=fr

Sample Response: 
{
  "success": true,
  "data": {
    "AF": "Afrikaans",
    "AM": "Amharic",
    "AR": "Arabic",
    "...": "...",
    "ZH-TW": "Chinese (Traditional)",
    "ZU": "Zulu"
  }
}

GET /api/play/countries

Returns the list of supported countries in the current or specified language.
Query Params: lang (optional, default: en)
Example: 

curl -X GET "https://asoreport.com/api/play/countries?lang=fr" -H "X-Api-Key: YOUR_API_KEY"
https://asoreport.com/api/YOUR_API_KEY/play/countries?lang=fr

Sample Response: 
{
  "success": true,
  "data": {
    "AF": "Afghanistan",
    "AL": "Albania",
    "DZ": "Algeria",
    "...": "...",
    "ZM": "Zambia",
    "ZW": "Zimbabwe"
  }
}

GET /api/play/collections

Returns the list of Play Store collections (e.g., top charts) localized in the specified language.
Query Params: lang (optional, default: en)
Example: 

curl -X GET "https://asoreport.com/api/play/collections?lang=es" -H "X-Api-Key: YOUR_API_KEY"
https://asoreport.com/api/YOUR_API_KEY/play/collections?lang=es

Sample Response: 
{
  "success": true,
  "data": {
    "TOP_FREE": "Top Free",
    "TOP_PAID": "Top Paid",
    "GROSSING": "Top Grossing"
  }
}

GET /api/play/categories

Returns the list of available Play Store app categories, including games and family sub-categories, localized as needed.
Query Params: lang (optional, default: en)
Example: 

curl -X GET "https://asoreport.com/api/play/categories?lang=ar" -H "X-Api-Key: YOUR_API_KEY"
https://asoreport.com/api/YOUR_API_KEY/play/categories?lang=ar

Sample Response: 
{
  "success": true,
  "data": {
    "Art & Design": "ART_AND_DESIGN",
    "Beauty": "BEAUTY",
    "...": "...",
    "Games: Trivia": "GAME_TRIVIA",
    "Family: Ages 6-8": "FAMILY_EDUCATION"
  }
}

Suggest Terms

Get auto-complete and related search suggestions from Google Play for a given keyword.
All endpoints require authentication.

GET /api/play/suggest/{term}

Description: Suggest search terms for a given keyword.
Parameters:

  • term (required): The search keyword (e.g. facebook).
Returns: Related/suggested search terms from Google Play.

Sample Response: 
{
  "success": true,
  "data": [
    {"term": "facebook"},
    {"term": "facebook messenger"},
    {"term": "facebook lite"},
    {"term": "facebook downloader"},
    {"term": "facebook marketplace app"}
  ]
}

GET /api/play/suggest/{term}/filtered

Description: Suggest search terms for a keyword, with filters for language and country.
Parameters:

  • term (required): The search keyword.
  • lang (optional, default: en): Response language.
  • country (optional, default: US): Store country.
Returns: Localized/filtered suggested terms.

Sample Response: 
{
  "success": true,
  "data": [
    {"term": "facebook"},
    {"term": "facebook messenger"},
    ...
  ]
}

Apps List

Retrieve a list of top Google Play apps with optional filters and detail levels.
All endpoints require authentication.

GET /api/play/apps

Description: Get a list of popular apps with basic details.
Parameters: (none)
Returns: Array of apps with basic info.

Sample Response: 
{
  "success": true,
  "data": [
    {
      "title": "ChatGPT",
      "appId": "com.openai.chatgpt",
      "url": "https://play.google.com/store/apps/details?id=com.openai.chatgpt",
      "icon": "https://play-lh.googleusercontent.com/lmG9HlI0awHie0cyBieWXeNjpyXvHPwDBb8MNOVIyp0P8VEh95AiBHtUZSDVR3HLe3A",
      "developer": "OpenAI",
      "currency": "USD",
      "price": 0,
      "free": true,
      "summary": "Introducing ChatGPT for Android: OpenAI’s latest advancements at your fingertips.",
      "scoreText": "4.8",
      "score": 4.783209
    },
    ...
  ]
}

GET /api/play/apps/filtered

Description: Get apps with filter options.
Parameters:

  • lang (optional, default: en): Language for results.
  • country (optional, default: US): Store country.
  • collection (optional, default: TOP_FREE): Collection (TOP_FREE, TOP_PAID, GROSSING, etc).
  • category (optional): App category (e.g., PRODUCTIVITY).
Returns: Array of filtered apps.

Sample Response: 
{
  "success": true,
  "data": [
    { "title": "ChatGPT", ... }
  ]
}

GET /api/play/apps/fullDetails

Description: Get a detailed list of apps with full info.
Parameters:

  • lang (optional, default: en): Language for results.
  • country (optional, default: US): Store country.
  • collection (optional, default: TOP_FREE): Collection.
  • category (optional): App category.
Returns: Array of apps with all available details.

Sample Response (truncated): 
{
  "success": true,
  "data": [
    {
      "title": "ChatGPT",
      "description": "Introducing ChatGPT for Android: OpenAI’s latest advancements at your fingertips...",
      "summary": "The official app by OpenAI",
      "installs": "500,000,000+",
      "score": 4.783209,
      "ratings": 19470041,
      "developer": "OpenAI",
      "categories": [
        {"name": "Productivity", "id": "PRODUCTIVITY"}
      ],
      "icon": "...",
      ...
    }
  ]
}

App Details

Retrieve full details for a single app using its unique Play Store ID.
All endpoints require authentication.

GET /api/play/app/details/{id}

Description: Get all available details for a single app.
Parameters:

  • id (required): The Play Store app ID (e.g. org.wikipedia).
Returns: Detailed app object.

Sample Response: 
{
  "success": true,
  "data": {
    "title": "Wikipedia",
    "description": "The best Wikipedia experience on your Mobile device. Ad-free and free of charge, forever. ...",
    "summary": "The official app for Wikipedia, the world’s largest source of information.",
    "icon": "https://play-lh.googleusercontent.com/htBUaqvBQR9UQ3b1-ouSHFhDGttQkH-eWetEErspYXVa8hOsfmOmj5ZanGg9GF7XAGc",
    "developer": "Wikimedia Foundation",
    "ratings": 695151,
    "score": 4.376131,
    "installs": "50,000,000+",
    "privacyPolicy": "http://wikimediafoundation.org/wiki/Privacy_policy",
    "categories": [
      {"name": "Books & Reference", "id": "BOOKS_AND_REFERENCE"}
    ],
    "url": "https://play.google.com/store/apps/details?id=org.wikipedia&hl=en&gl=us"
    // ... more fields ...
  }
}

GET /api/play/app/details/{id}/filtered

Description: Get localized details for a single app with filtering options.
Parameters:

  • id (required): The Play Store app ID.
  • lang (optional, default: en): Language for results.
  • country (optional, default: US): Store country.
Returns: Localized app details object.

Sample Response: 
{
  "success": true,
  "data": {
    "title": "Wikipedia",
    "description": "...",
    // ... more fields as above ...
  }
}

Similar Apps

Retrieve a list of apps similar to a specified Play Store app ID.
All endpoints require authentication.

GET /api/play/app/similar/{id}

Description: List apps similar to the specified app.
Parameters:

  • id (required): The Play Store app ID (e.g. org.wikipedia).
Returns: List of similar app objects.

Sample Response: 
{
  "success": true,
  "data": [
      {
        "title": "Wikipedia",
        "appId": "org.wikipedia",
        "url": "https://play.google.com/store/apps/details?id=org.wikipedia",
        "icon": "...",
        "developer": "Wikimedia Foundation",
        "summary": "...",
        "score": 4.376131
      },
      {
        "title": "Wikipedia Beta",
        // ...
      }
    ]
}

GET /api/play/app/similar/{id}/filtered

Description: Get similar apps, filtered and localized by language/country.
Parameters:

  • id (required): The Play Store app ID.
  • lang (optional, default: en): Language for results.
  • country (optional, default: US): Store country.
Returns: List of localized similar app objects.

Sample Response: 
{
  "success": true,
  "data": [
      {
        "title": "Wikipedia",
        "appId": "org.wikipedia",
        // ...
      },
      {
        "title": "Wikipedia Beta",
        // ...
      }
    ]
}

GET /api/play/app/similar/{id}/fullDetails

Description: Get similar apps with all available app details, filtered and localized.
Parameters:

  • id (required): The Play Store app ID.
  • lang (optional, default: en): Language for results.
  • country (optional, default: US): Store country.
Returns: List of similar app objects with full details.

Sample Response: 
{
  "success": true,
  "data": [
      {
        "title": "Wikipedia",
        "description": "The best Wikipedia experience on your Mobile device. Ad-free and free of charge, forever. ...",
        "summary": "...",
        "icon": "...",
        "developer": "Wikimedia Foundation",
        // ... more fields ...
      },
      {
        "title": "Wikipedia Beta",
        // ...
      }
    ]
}

Data Safety

Retrieve data safety and privacy practices as declared on the Play Store for a specific app.
All endpoints require authentication.

GET /api/play/app/datasafety/{id}

Description: Returns the data safety and privacy information for a given app.
Parameters:

  • id (required): The Play Store app ID (e.g. com.facebook.katana).
Returns: The data safety and privacy policy info.

Sample Response: 
{
  "success": true,
  "data": {
      "sharedData": [
        {
          "data": "Device or other IDs",
          "optional": 0,
          "purpose": "Advertising or marketing",
          "type": "Device or other IDs"
        },
        {
          "data": "Name",
          "optional": 0,
          "purpose": "Fraud prevention, security, and compliance",
          "type": "Personal info"
        }
        // ...
      ],
      "collectedData": [
        {
          "data": "Contacts",
          "optional": 1,
          "purpose": "App functionality, Analytics, Developer communications, ...",
          "type": "Contacts"
        }
        // ...
      ],
      "securityPractices": [
        {
          "practice": "Data is encrypted in transit",
          "description": "Your data is transferred over a secure connection"
        },
        {
          "practice": "You can request that data be deleted",
          "description": "The developer provides a way for you to request that your data be deleted"
        }
      ],
      "privacyPolicyUrl": "https://www.facebook.com/about/privacy/"
    }
}

GET /api/play/app/datasafety/{id}/filtered

Description: Returns data safety information localized by language.
Parameters:

  • id (required): The Play Store app ID.
  • lang (optional, default: en): Language for result localization.
Returns: The localized data safety and privacy policy info.

Sample Response: 
{
  "success": true,
  "data": {
      // ... same structure as above, localized ...
    }
}

App Permissions

Retrieve the list of Android permissions requested by an app on the Play Store.

GET /api/play/app/permissions/{id}

Description: Returns the full list of permissions for a given app.
Parameters:

  • id (required): The Play Store app ID (e.g. com.facebook.katana).
Returns: An array of permission objects with permission and type.

Sample Response: 
{
  "success": true,
  "data": [
    {"permission":"retrieve running apps","type":"Device & app history"},
    {"permission":"find accounts on the device","type":"Identity"},
    {"permission":"add or remove accounts","type":"Identity"},
    // ...
    {"permission":"read Google service configuration","type":"Other"}
  ]
}

GET /api/play/app/permissions/{id}/filtered

Description: Returns localized or simplified permissions.
Parameters:

  • id (required): The Play Store app ID.
  • lang (optional, default: en): Language for result localization.
  • country (optional, default: US): Country code.
  • short (optional, default: false): If true, returns only permission categories (array of strings).
Returns: A filtered or localized list of permissions.

Sample Response (short=false or omitted): 
{
  "success": true,
  "data": [
    {"permission":"retrieve running apps","type":"Device & app history"},
    // ...
  ]
}
Sample Response (short=true): 
{
  "success": true,
  "data": [
    "الجهاز وسجلّ التطبيقات",
    "الهوية",
    "تقويم Google",
    "جهات الاتصال",
    "الموقع",
    "الهاتف",
    // ...
  ]
}

App Reviews

Retrieve recent user reviews and ratings for an app from Google Play.

GET /api/play/app/reviews/{id}

Description: Returns the latest user reviews for a given app.
Parameters:

  • id (required): The Play Store app ID (e.g. com.facebook.katana).
Returns: An array of review objects.

Sample Response: 
{
  "success": true,
  "data": [
    {
      "id": "116640e1-6a73-4a29-a981-b42bf457c59e",
      "userName": "MI MI CHIT",
      "userImage": "https://play-lh.googleusercontent.com/a/...",
      "date": "2025-06-21T20:48:40.888Z",
      "score": 5,
      "scoreText": "5",
      "url": "https://play.google.com/store/apps/details?id=com.facebook.katana&reviewId=116640e1-6a73-4a29-a981-b42bf457c59e",
      "title": null,
      "text": "Facebook app it's so good an really nice app!",
      "replyDate": null,
      "replyText": null,
      "version": "518.0.0.63.86",
      "thumbsUp": 0,
      "criterias": []
    },
    ...
  ]
}

GET /api/play/app/reviews/{id}/filtered

Description: Returns reviews with filtering, localization, and sorting.
Parameters:

  • id (required): The Play Store app ID.
  • lang (optional, default: en): Language for the reviews.
  • country (optional, default: US): Country code.
  • sort (optional, default: NEWEST): Sort order. Allowed values: NEWEST, RATING, HELPFULNESS.
Returns: An array of filtered review objects.

Sample Response: 
{
  "success": true,
  "data": [
    {
      "id": "4e42bc5d-dbbb-44ac-80df-04fbd08be817",
      "userName": "MidnightStar Sparks",
      "userImage": "https://play-lh.googleusercontent.com/a-/ALV-...",
      "date": "2025-06-10T19:49:28.150Z",
      "score": 1,
      "scoreText": "1",
      "url": "https://play.google.com/store/apps/details?id=com.facebook.katana&reviewId=4e42bc5d-dbbb-44ac-80df-04fbd08be817",
      "title": null,
      "text": "This app used to be great, but now it's just become more and more unstable...",
      "replyDate": null,
      "replyText": null,
      "version": "515.1.0.62.90",
      "thumbsUp": 43615,
      "criterias": [
        {"criteria": "vaf_never_display_ads_experience", "rating": null},
        {"criteria": "vaf_never_display_ease_of_use", "rating": null}
      ]
    },
    ...
  ]
}

Developer Apps

Fetch the list of apps published by a specific developer on Google Play.

GET /api/play/developer/{devId}/apps

Description: Returns a list of apps from the specified developer.
Parameters:

  • devId (required): Developer name or ID (URL-encoded, e.g. Wikimedia%20Foundation).
Returns: Object with developer ID and an array of apps.

Sample Response: 
{
  "success": true,
  "data": {
    "devId": "Wikimedia Foundation",
    "apps": [
      {
        "title": "Wikipedia",
        "appId": "org.wikipedia",
        "url": "https://play.google.com/store/apps/details?id=org.wikipedia",
        "icon": "https://play-lh.googleusercontent.com/...",
        "developer": "Wikimedia Foundation",
        "currency": "USD",
        "price": 0,
        "free": true,
        "summary": "The best Wikipedia experience on your Mobile device. Ad-free and free of charge, forever. With the official Wikipedia app, you can search and explore 40+ million articles in 300+ languages, no matter where you are...",
        "scoreText": "4.4",
        "score": 4.376131
      },
      ...
    ]
  }
}

GET /api/play/developer/{devId}/apps/filtered

Description: Returns developer's apps with localization and full details.
Parameters:

  • devId (required): Developer name or ID (URL-encoded).
  • lang (optional, default: en): Language for app details.
  • country (optional, default: US): Country code.
Returns: Object with developer ID and a fully detailed array of apps.

Sample Response: 
{
  "success": true,
  "data": {
    "devId": "Wikimedia Foundation",
    "apps": [
      {
        "title": "Википедия",
        "description": "Официальное приложение «Википедия» под Android. ...",
        "summary": "Официальное приложение «Википедия» под Android.",
        "installs": "50 000 000+",
        "score": 4.376131,
        "ratings": 695151,
        "reviews": 15717,
        "priceText": "Free",
        "developer": "Wikimedia Foundation",
        "icon": "https://play-lh.googleusercontent.com/...",
        "screenshots": [
          "https://play-lh.googleusercontent.com/VSi0l72VLPJO4FHQyo1-pRHmI6tllwzGqOTJc2EwaKcXRvgk_1ZjhPF0xJd8th4_OA",
          ...
        ],
        "video": "https://www.youtube.com/embed/6UkFHYqVsbc?ps=play&vq=large&rel=0&autohide=1&showinfo=0",
        "appId": "org.wikipedia",
        "url": "https://play.google.com/store/apps/details?id=org.wikipedia&hl=ru&gl=US"
      },
      ...
    ]
  }
}

App Store Reference Data

These endpoints provide reference data for Apple App Store: supported languages, countries, collections, and categories.
Authentication required:

All endpoints accept a lang query parameter to localize the results.

GET /api/appstore/languages

Returns the list of supported languages in the current or specified language.
Query Params: lang (optional, default: en)
Example: 

curl -X GET "https://asoreport.com/api/appstore/languages?lang=fr" -H "X-Api-Key: YOUR_API_KEY"
https://asoreport.com/api/YOUR_API_KEY/appstore/languages?lang=fr

Sample Response: 
{
  "success": true,
  "data": {
    "AF": "Afrikaans",
    "AM": "Amharic",
    "AR": "Arabic",
    "...": "...",
    "FR": "French"
  }
}

GET /api/appstore/countries

Returns the list of supported countries in the current or specified language.
Query Params: lang (optional, default: en)
Example: 

curl -X GET "https://asoreport.com/api/appstore/countries?lang=fr" -H "X-Api-Key: YOUR_API_KEY"
https://asoreport.com/api/YOUR_API_KEY/appstore/countries?lang=fr

Sample Response: 
{
  "success": true,
  "data": {
    "AF": "Afghanistan",
    "AL": "Albania",
    "DZ": "Algeria",
    "...": "...",
    "ZW": "Zimbabwe"
  }
}

GET /api/appstore/collections

Returns the list of App Store collections (e.g., top charts) localized in the specified language.
Query Params: lang (optional, default: en)
Example: 

curl -X GET "https://asoreport.com/api/appstore/collections?lang=es" -H "X-Api-Key: YOUR_API_KEY"
https://asoreport.com/api/YOUR_API_KEY/appstore/collections?lang=es

Sample Response: 
{
  "success": true,
  "data": {
    "TOP_MAC": "Top Mac Apps",
    "TOP_FREE_MAC": "Top Free Mac Apps",
    "TOP_GROSSING_MAC": "Top Grossing Mac Apps",
    "TOP_PAID_MAC": "Top Paid Mac Apps",
    "NEW_IOS": "New iOS Apps",
    "TOP_FREE_IOS": "Top Free iOS Apps",
    "..."
  }
}

GET /api/appstore/categories

Returns the list of available App Store app categories, including all sub-categories, localized as needed.
Query Params: lang (optional, default: en)
Example: 

curl -X GET "https://asoreport.com/api/appstore/categories?lang=ar" -H "X-Api-Key: YOUR_API_KEY"
https://asoreport.com/api/YOUR_API_KEY/appstore/categories?lang=ar

Sample Response: 
{
  "success": true,
  "data": {
    "Books": "BOOKS",
    "Business": "BUSINESS",
    "Games: Action": "GAMES_ACTION",
    "Magazines & Newspapers": "MAGAZINES_AND_NEWSPAPERS",
    "...": "..."
  }
}

App Details

Retrieve full details for a single app using its unique App Store ID.
All endpoints require authentication.

GET /api/appstore/app/details/{id}

Description: Get all available details for a single app.
Parameters:

  • id (required): The App Store app ID (e.g. 553834731).
Returns: Detailed app object.

Sample Response: 
{
  "success": true,
  "data": {
    "id": 553834731,
    "appId": "com.midasplayer.apps.candycrushsaga",
    "title": "Candy Crush Saga",
    "url": "https://apps.apple.com/us/app/candy-crush-saga/id553834731?uo=4",
    "description": "Explore a world full of delicious match-3 puzzles and endless fun! ...",
    "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/...",
    "genres": ["Games", "Entertainment", "Puzzle", "Casual"],
    "genreIds": ["6014", "6016", "7012", "7003"],
    "primaryGenre": "Games",
    "primaryGenreId": 6014,
    "contentRating": "4+",
    "languages": ["AR", "CA", "HR", ...],
    "size": "404246528",
    "requiredOsVersion": "12.0.0",
    "released": "2012-11-14T14:41:32Z",
    "updated": "2025-06-19T05:33:44Z",
    "releaseNotes": "We hope you’re having fun playing Candy Crush Saga! ...",
    "version": "1.305.1.2",
    "price": 0,
    "currency": "USD",
    "free": true,
    "developerId": 526656015,
    "developer": "King",
    "developerUrl": "https://apps.apple.com/us/developer/king/id526656015?uo=4",
    "developerWebsite": "http://candycrushsaga.com/",
    "score": 4.7077,
    "reviews": 3669105,
    "currentVersionScore": 4.7077,
    "currentVersionReviews": 3669105,
    "screenshots": [
      "https://is1-ssl.mzstatic.com/image/thumb/...",
      "... (more URLs) ..."
    ],
    "ipadScreenshots": [
      "https://is1-ssl.mzstatic.com/image/thumb/...",
      "... (more URLs) ..."
    ],
    "appletvScreenshots": [],
    "supportedDevices": [
      "iPhone5s-iPhone5s",
      "iPadAir-iPadAir",
      "... (many more) ..."
    ]
  }
}

GET /api/appstore/app/details/{id}/filtered

Description: Get localized and filtered details for a single app.
Parameters:

  • id (required): The App Store app ID (e.g. 553834731).
  • lang (optional, default: en): Language for results (e.g. ar, fr).
  • country (optional, default: US): Store country (e.g. US, SA).
  • appId (optional): The bundle/app identifier (e.g. com.midasplayer.apps.candycrushsaga).
  • ratings (optional): If set to true, includes ratings histogram.
Returns: Localized and/or filtered app object.

Example: 
curl -X GET "https://asoreport.com/api/appstore/app/details/553834731/filtered?lang=ar&country=sa&ratings=true" -H "X-Api-Key: YOUR_API_KEY"
https://asoreport.com/api/YOUR_API_KEY/appstore/app/details/553834731/filtered?lang=ar&country=sa&ratings=true
Sample Response: 
{
  "success": true,
  "data": {
    "id": 553834731,
    "appId": "com.midasplayer.apps.candycrushsaga",
    "title": "Candy Crush Saga",
    "url": "https://apps.apple.com/sa/app/candy-crush-saga/id553834731?l=ar&uo=4",
    "description": "ابدأ لعب Candy Crush Saga اليوم – لعبة ألغاز أسطورية ...",
    "icon": "https://is1-ssl.mzstatic.com/image/thumb/...",
    "genres": ["الألعاب", "ترفيه", "ألغاز", "تسالي"],
    "genreIds": ["6014", "6016", "7012", "7003"],
    "primaryGenre": "Games",
    "primaryGenreId": 6014,
    "contentRating": "٤+",
    "languages": ["AR", "CA", "HR", "..."],
    "size": "404246528",
    "requiredOsVersion": "12.0.0",
    "released": "2012-11-14T14:41:32Z",
    "updated": "2025-06-19T05:33:44Z",
    "releaseNotes": "نتمنى أن تستمتع بلعب Candy Crush Saga! ...",
    "version": "1.305.1.2",
    "price": 0,
    "currency": "SAR",
    "free": true,
    "developerId": 526656015,
    "developer": "King",
    "developerUrl": "https://apps.apple.com/sa/developer/king/id526656015?l=ar&uo=4",
    "developerWebsite": "http://candycrushsaga.com/",
    "score": 4.61509,
    "reviews": 108447,
    "currentVersionScore": 4.61509,
    "currentVersionReviews": 108447,
    "screenshots": [
      "https://is1-ssl.mzstatic.com/image/thumb/...",
      "... (more URLs) ..."
    ],
    "ipadScreenshots": [
      "https://is1-ssl.mzstatic.com/image/thumb/...",
      "... (more URLs) ..."
    ],
    "appletvScreenshots": [],
    "supportedDevices": [
      "iPhone5s-iPhone5s",
      "iPadAir-iPadAir",
      "... (many more) ..."
    ],
    "ratings": 108447,
    "histogram": {
      "1": 4855,
      "2": 2252,
      "3": 4022,
      "4": 7522,
      "5": 89796
    }
  }
}

Apps List

Retrieve a list of top App Store apps with optional filters and detail levels.
All endpoints require authentication.

GET /api/appstore/apps

Description: Get a list of popular App Store apps with basic details.
Parameters: (none)
Returns: Array of apps with basic info.

Sample Response: 
{
  "success": true,
  "data": [
    {
      "id": "6448311069",
      "appId": "com.openai.chat",
      "title": "ChatGPT",
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/b3/fd/3d/b3fd3d71-5cc3-6663-1654-63934e3bc692/AppIcon-0-0-1x_U007epad-0-0-0-1-0-85-220.png/100x100bb.png",
      "url": "https://apps.apple.com/us/app/chatgpt/id6448311069?uo=2",
      "price": 0,
      "currency": "USD",
      "free": true,
      "description": "Introducing ChatGPT for iOS: OpenAI’s latest advancements at your fingertips.",
      "developer": "OpenAI",
      "developerUrl": "https://apps.apple.com/us/developer/openai/id1684349733?uo=2",
      "developerId": "1684349733?uo=2",
      "genre": "Productivity",
      "genreId": "6007",
      "released": "2023-05-18T00:00:00-07:00"
    },
    ...
  ]
}

GET /api/appstore/apps/filtered

Description: Get filtered apps by collection, category, country, and language.
Parameters:

  • lang (optional, default: en): Language for results.
  • country (optional, default: US): Store country.
  • collection (optional, default: TOP_FREE_IOS): App Store collection (TOP_FREE_IOS, TOP_PAID_IOS, NEW_IOS, etc).
  • category (optional): App Store category (e.g., GAMES_RACING).
  • fullDetail (optional): 1 for full detail, omitted/0 for basic.
Returns: Array of filtered apps.

Sample Response: 
{
  "success": true,
  "data": [
    {
      "id": "6747334476",
      "appId": "ai.free.ailogomaker",
      "title": "AI Logo Maker- Image Generator",
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/8b/bd/0c/8bbd0cf3-c683-d8cd-a243-1fe42ce0a221/AppIcon-0-0-1x_U007epad-0-11-0-85-220.png/100x100bb.png",
      "url": "https://apps.apple.com/gb/app/ai-logo-maker-image-generator/id6747334476?uo=2",
      "price": 0,
      "currency": "GBP",
      "free": true,
      "developer": "正东 程",
      "developerUrl": "https://apps.apple.com/gb/developer/%E6%AD%A3%E4%B8%9C-%E7%A8%8B/id1820199267?uo=2",
      "developerId": "1820199267?uo=2",
      "genre": "Graphics & Design",
      "genreId": "6027",
      "released": "2025-06-27T00:00:00-07:00"
    },
    ...
  ]
}

Developer Apps

Retrieve a list of all apps published by a specific App Store developer.
All endpoints require authentication.

GET /api/appstore/developer/{devId}/apps

Description: Get all apps published by a developer (basic info).
Parameters:

  • devId (required): The App Store developer ID (e.g. 284882218 for Meta).
Returns: Array of apps with basic info.

Example: 
curl -X GET "https://asoreport.com/api/appstore/developer/284882218/apps" -H "X-Api-Key: YOUR_API_KEY"
https://asoreport.com/api/YOUR_API_KEY/appstore/developer/284882218/apps
Sample Response: 
{
  "success": true,
  "data": [
    {
      "id": 284882215,
      "appId": "com.facebook.Facebook",
      "title": "Facebook",
      "url": "https://apps.apple.com/us/app/facebook/id284882215?uo=4",
      "description": "Where real people propel your curiosity. Whether you’re thrifting gear, showing reels to that group who gets it, or sharing laughs over fun images reimagined by AI, Facebook helps you make things happen like no other social network.\n\nExplore and expand your interests: \n* Ask Meta AI to search topics that matter to you, and get instant results more interactive than just text\n* Shop Marketplace for deals and hidden gems to nurture your hobbies\n* Personalize your Feed to see more of what you like, less of what you don’t\n* Dive into reels for how-to’s or quick entertainment\n\nConnect with people and communities:\n* Join groups to learn tips from real people who’ve been there, done that\n* Turn on sharing to Instagram to save time\n* Privately message relatable posts that only your BFF will get or that reels trend everyone’s talking about\n\nShare your world:\n* Use generative AI to delight friends with custom images, or just get help writing posts\n* Customize your profile to choose how you show up and who sees your posts\n* Effortlessly create reels from trending templates, or showcase your creativity with a full suite of editing tools\n* Capture moments on the fly with stories\n\nSome features may not be available in your country or region. \n\nTerms & Policies: https://www.facebook.com/policies_center\nPrivacy Policy: https://www.facebook.com/privacy\n\nLearn how we're working to help keep our communities safe across Meta technologies at the Meta Safety Center: https://about.meta.com/actions/safety",
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/fc/9e/40/fc9e40a0-70af-a1e1-f767-29ff62872628/Icon-Production-0-0-1x_U007epad-0-1-0-85-220.png/512x512bb.jpg",
      "genres": ["Social Networking"],
      "genreIds": ["6005"],
      "primaryGenre": "Social Networking",
      "primaryGenreId": 6005,
      "contentRating": "12+",
      "languages": ["AR", "HR", "CS", "DA", "NL", "EN", "FI", "FR", "DE", "EL", "HE", "HI", "HU", "ID", "IT", "JA", "KO", "MS", "NB", "PL", "PT", "RO", "RU", "ZH", "SK", "ES", "SV", "TH", "ZH", "TR", "UK", "VI"],
      "size": "373402624",
      "requiredOsVersion": "15.1",
      "released": "2019-02-05T08:00:00Z",
      "updated": "2025-06-26T00:19:57Z",
      "releaseNotes": "Our teams have solved many crashes, fixed issues you’ve reported and made the app faster.",
      "version": "519.1",
      "price": 0,
      "currency": "USD",
      "free": true,
      "developerId": 284882218,
      "developer": "Meta Platforms, Inc.",
      "developerUrl": "https://apps.apple.com/us/developer/meta-platforms-inc/id284882218?uo=4",
      "developerWebsite": "http://www.facebook.com/mobile",
      "score": 4.48606,
      "reviews": 20784158,
      "currentVersionScore": 4.48606,
      "currentVersionReviews": 20784158,
      "screenshots": [
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/89/2a/99/892a99f1-75bc-b5bc-be4e-176edee5a813/f254967c-6ef9-4cc6-b4bf-e89cf016337c_1-iOS-5.5-Home.png/392x696bb.png",
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/a3/70/90/a370903f-adf9-bd78-8f19-4530b593370a/c795c58d-ec37-463c-9ab9-ba0b8bc00ddd_2-iOS-5.5-Reels.png/392x696bb.png"
      ],
      "ipadScreenshots": [
        "https://is1-ssl.mzstatic.com/image/thumb/Purple127/v4/9d/7a/ad/9d7aad83-e0a0-5649-840e-3ec7d86bb30a/mzl.upuopfix.png/480x360bb.png"
      ],
      "appletvScreenshots": [
        // ...
      ],
      "supportedDevices": [
        "iPhone5s-iPhone5s",
        "iPadAir-iPadAir",
        // ...
      ]
    }
    // ... more apps
  ]
}

GET /api/appstore/developer/{devId}/apps/filtered

Description: Get all developer apps with localization (language & country).
Parameters:

  • devId (required): The App Store developer ID.
  • lang (optional, default: en): Language for results (e.g. vi).
  • country (optional, default: US): Store country (e.g. VI).
Returns: Array of localized developer apps.

Example: 
curl -X GET "https://asoreport.com/api/appstore/developer/284882218/apps/filtered?lang=vi&country=vi" -H "X-Api-Key: YOUR_API_KEY"
https://asoreport.com/api/YOUR_API_KEY/appstore/developer/284882218/apps/filtered?lang=vi&country=vi
Sample Response: 
{
  "success": true,
  "data": [
    {
      "id": 284882215,
      "appId": "com.facebook.Facebook",
      "title": "Facebook",
      "url": "https://apps.apple.com/us/app/facebook/id284882215?l=vi&uo=4",
      "description": "Nơi người thật thổi bùng sự hiếu kỳ trong bạn. ...",
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/fc/9e/40/fc9e40a0-70af-a1e1-f767-29ff62872628/Icon-Production-0-0-1x_U007epad-0-1-0-85-220.png/512x512bb.jpg",
      "genres": ["Mạng Xã Hội"],
      "genreIds": ["6005"],
      "primaryGenre": "Social Networking",
      "primaryGenreId": 6005,
      "contentRating": "12+",
      "languages": ["AR", "HR", "CS", "DA", "NL", "EN", "FI", "FR", "DE", "EL", "HE", "HI", "HU", "ID", "IT", "JA", "KO", "MS", "NB", "PL", "PT", "RO", "RU", "ZH", "SK", "ES", "SV", "TH", "ZH", "TR", "UK", "VI"],
      "size": "373402624",
      "requiredOsVersion": "15.1",
      "released": "2019-02-05T08:00:00Z",
      "updated": "2025-06-26T00:19:57Z",
      "releaseNotes": "Các đội ngũ của chúng tôi đã giải quyết nhiều sự cố, khắc phục những vấn đề mà bạn báo cáo và giúp ứng dụng chạy nhanh hơn.",
      "version": "519.1",
      "price": 0,
      "currency": "USD",
      "free": true,
      "developerId": 284882218,
      "developer": "Meta Platforms, Inc.",
      "developerUrl": "https://apps.apple.com/us/developer/meta-platforms-inc/id284882218?l=vi&uo=4",
      "developerWebsite": "http://www.facebook.com/mobile",
      "score": 4.48606,
      "reviews": 20784158,
      "currentVersionScore": 4.48606,
      "currentVersionReviews": 20784158,
      "screenshots": [],
      "ipadScreenshots": [
        "https://is1-ssl.mzstatic.com/image/thumb/Purple127/v4/9d/7a/ad/9d7aad83-e0a0-5649-840e-3ec7d86bb30a/mzl.upuopfix.png/480x360bb.png"
      ],
      "appletvScreenshots": [],
      "supportedDevices": [
        "iPhone5s-iPhone5s",
        "iPadAir-iPadAir",
        // ...
      ]
    }
    // ... more apps
  ]
}

App Privacy

Retrieve detailed App Store privacy practices for a specific app, including all declared data collection and usage practices shown on the App Store.
All endpoints require authentication.

GET /api/appstore/app/privacy/{id}

Description: Get all privacy details for a single App Store app.
Parameters:

  • id (required): The App Store app ID (e.g. 284882215 for Facebook).
Returns: Privacy details object for the app.

Example: 
curl -X GET "https://asoreport.com/api/appstore/app/privacy/284882215" -H "X-Api-Key: YOUR_API_KEY"
https://asoreport.com/api/YOUR_API_KEY/appstore/app/privacy/284882215
Sample Response: 
{
  "success": true,
  "data": {
    "results": {
      "managePrivacyChoicesUrl": null,
      "privacyTypes": [
        {
          "privacyType": "Data Used to Track You",
          "identifier": "DATA_USED_TO_TRACK_YOU",
          "description": "The following data may be used to track you across apps and websites owned by other companies:",
          "dataCategories": [
            {
              "dataCategory": "Contact Info",
              "identifier": "CONTACT_INFO",
              "dataTypes": [
                "Physical Address",
                "Email Address",
                "Name",
                "Phone Number"
              ]
            },
            {
              "dataCategory": "Identifiers",
              "identifier": "IDENTIFIERS",
              "dataTypes": [
                "User ID",
                "Device ID"
              ]
            },
            {
              "dataCategory": "Other Data",
              "identifier": "OTHER",
              "dataTypes": [
                "Other Data Types"
              ]
            }
          ],
          "purposes": []
        },
        {
          "privacyType": "Data Linked to You",
          "identifier": "DATA_LINKED_TO_YOU",
          "description": "The following data, which may be collected and linked to your identity, may be used for the following purposes:",
          "dataCategories": [],
          "purposes": [
            {
              "purpose": "Third-Party Advertising",
              "identifier": "THIRD_PARTY_ADVERTISING",
              "dataCategories": [
                {
                  "dataCategory": "Purchases",
                  "identifier": "PURCHASES",
                  "dataTypes": [
                    "Purchase History"
                  ]
                },
                {
                  "dataCategory": "Financial Info",
                  "identifier": "FINANCIAL_INFO",
                  "dataTypes": [
                    "Other Financial Info"
                  ]
                },
                {
                  "dataCategory": "Location",
                  "identifier": "LOCATION",
                  "dataTypes": [
                    "Precise Location",
                    "Coarse Location"
                  ]
                },
                {
                  "dataCategory": "Contact Info",
                  "identifier": "CONTACT_INFO",
                  "dataTypes": [
                    "Physical Address",
                    "Email Address",
                    "Name",
                    "Phone Number",
                    "Other User Contact Info"
                  ]
                },
                {
                  "dataCategory": "Contacts",
                  "identifier": "CONTACTS",
                  "dataTypes": [
                    "Contacts"
                  ]
                },
                {
                  "dataCategory": "User Content",
                  "identifier": "USER_CONTENT",
                  "dataTypes": [
                    "Photos or Videos",
                    "Gameplay Content",
                    "Other User Content"
                  ]
                },
                {
                  "dataCategory": "Search History",
                  "identifier": "SEARCH_HISTORY",
                  "dataTypes": [
                    "Search History"
                  ]
                },
                {
                  "dataCategory": "Browsing History",
                  "identifier": "BROWSING_HISTORY",
                  "dataTypes": [
                    "Browsing History"
                  ]
                },
                {
                  "dataCategory": "Identifiers",
                  "identifier": "IDENTIFIERS",
                  "dataTypes": [
                    "User ID",
                    "Device ID"
                  ]
                },
                {
                  "dataCategory": "Usage Data",
                  "identifier": "USAGE_DATA",
                  "dataTypes": [
                    "Product Interaction",
                    "Advertising Data",
                    "Other Usage Data"
                  ]
                },
                {
                  "dataCategory": "Diagnostics",
                  "identifier": "DIAGNOSTICS",
                  "dataTypes": [
                    "Crash Data",
                    "Performance Data",
                    "Other Diagnostic Data"
                  ]
                },
                {
                  "dataCategory": "Other Data",
                  "identifier": "OTHER",
                  "dataTypes": [
                    "Other Data Types"
                  ]
                }
              ]
            },
            {
              "purpose": "Developer’s Advertising or Marketing",
              "identifier": "DEVELOPERS_ADVERTISING",
              "dataCategories": [
                {
                  "dataCategory": "Purchases",
                  "identifier": "PURCHASES",
                  "dataTypes": [
                    "Purchase History"
                  ]
                },
                {
                  "dataCategory": "Financial Info",
                  "identifier": "FINANCIAL_INFO",
                  "dataTypes": [
                    "Other Financial Info"
                  ]
                },
                {
                  "dataCategory": "Location",
                  "identifier": "LOCATION",
                  "dataTypes": [
                    "Precise Location",
                    "Coarse Location"
                  ]
                },
                {
                  "dataCategory": "Contact Info",
                  "identifier": "CONTACT_INFO",
                  "dataTypes": [
                    "Physical Address",
                    "Email Address",
                    "Name",
                    "Phone Number",
                    "Other User Contact Info"
                  ]
                },
                {
                  "dataCategory": "Contacts",
                  "identifier": "CONTACTS",
                  "dataTypes": [
                    "Contacts"
                  ]
                },
                {
                  "dataCategory": "User Content",
                  "identifier": "USER_CONTENT",
                  "dataTypes": [
                    "Photos or Videos",
                    "Gameplay Content",
                    "Other User Content"
                  ]
                },
                {
                  "dataCategory": "Search History",
                  "identifier": "SEARCH_HISTORY",
                  "dataTypes": [
                    "Search History"
                  ]
                },
                {
                  "dataCategory": "Browsing History",
                  "identifier": "BROWSING_HISTORY",
                  "dataTypes": [
                    "Browsing History"
                  ]
                },
                {
                  "dataCategory": "Identifiers",
                  "identifier": "IDENTIFIERS",
                  "dataTypes": [
                    "User ID",
                    "Device ID"
                  ]
                },
                {
                  "dataCategory": "Usage Data",
                  "identifier": "USAGE_DATA",
                  "dataTypes": [
                    "Product Interaction",
                    "Advertising Data",
                    "Other Usage Data"
                  ]
                },
                {
                  "dataCategory": "Diagnostics",
                  "identifier": "DIAGNOSTICS",
                  "dataTypes": [
                    "Crash Data",
                    "Performance Data",
                    "Other Diagnostic Data"
                  ]
                },
                {
                  "dataCategory": "Other Data",
                  "identifier": "OTHER",
                  "dataTypes": [
                    "Other Data Types"
                  ]
                }
              ]
            },
            // ... More purposes, fully expanded ...
          ]
        }
        // ... More privacyType blocks ...
      ],
      "privacyPolicyUrl": "http://www.facebook.com/about/privacy/"
    }
  }
}

Similar Apps

Retrieve a list of similar or related apps for a given App Store app ID.
All endpoints require authentication.

GET /api/appstore/app/similar/{id}

Description: Get a list of apps similar to a given app.
Parameters:

  • id (required): The App Store app ID (e.g. 284882215).
Returns: Array of app objects similar to the given app.

Example: 
curl -X GET "https://asoreport.com/api/appstore/app/similar/284882215" -H "X-Api-Key: YOUR_API_KEY"
https://asoreport.com/api/YOUR_API_KEY/appstore/app/similar/284882215
Sample Response: 
{
  "success": true,
  "data": {
    "results": [
      {
        "id": 6446901002,
        "appId": "com.burbn.barcelona",
        "title": "Threads",
        "url": "https://apps.apple.com/us/app/threads/id6446901002?uo=4",
        "description": "Say more with Threads — Instagram’s text-based conversation app.\n\nThreads is where communities come together to discuss everything from the topics you care about today to what’ll be trending tomorrow. Whatever it is you’re interested in, you can follow and connect directly with your favorite creators and others who love the same things — or build a loyal following of your own to share your ideas, opinions and creativity with the world!\n\nA few things you can do on Threads…\n\n■ Access your Instagram followers\nYour Instagram username and verification badge are reserved for you. Automatically follow the same accounts you follow on Instagram in a few taps, and discover new accounts too.\n\n■ Share your point of view\nSpin up a new thread to express what's on your mind. This is your space to be yourself, and you control who can reply.\n\n■ Connect with friends and your favorite creators\nJump to the replies to get in on the action and react to commentary, humor and insight from the creators you know and love. Find your community and connect with people who care about whatever it is you’re interested in.\n\n■ Control the conversation\nCustomize your settings and use controls to manage who can see your content, reply to your threads, or mention you. Accounts you’ve blocked will carry over from Instagram, and we’re enforcing the same Community Guidelines to help ensure everyone interacts safely and authentically. \n\n■ Find ideas and inspiration\nFrom TV recommendations to career advice, get answers to your questions or learn something new from crowd-sourced conversations, thought leaders and industry experts.\n\n■ Never miss a moment\nStay on top of the latest trends and live events. Whether it’s about new music, movie premieres, sports, games, TV shows, fashion, or the latest product releases, find discussions and receive notifications any time your favorite profiles start a new thread.\n\n■ Leap into the fediverse\nThreads is part of the fediverse, a global, open, social network of independent servers operated by third parties around the world. Servers share information with each other to enable people to connect and discover new things across the fediverse.\n\n\nMeta Terms: https://www.facebook.com/terms.php\nMeta Privacy Policy: https://privacycenter.instagram.com/policy\nThreads Supplemental Privacy Policy: https://help.instagram.com/515230437301944\nThreads Supplemental Terms: https://help.instagram.com/769983657850450\nInstagram Community Guidelines: https://help.instagram.com/477434105621119\nConsumer Health Privacy Policy: https://privacycenter.instagram.com/policies/health\n\nLearn how we're working to help keep our communities safe across Meta technologies at the Meta Safety Center: https://about.meta.com/actions/safety",
        "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/12/a2/d1/12a2d1df-9510-0088-8df7-92be70bab216/Prod-0-0-1x_U007emarketing-0-8-0-85-220.png/512x512bb.jpg",
        "genres": ["Social Networking", "Entertainment"],
        "genreIds": ["6005", "6016"],
        "primaryGenre": "Social Networking",
        "primaryGenreId": 6005,
        "contentRating": "12+",
        "languages": ["HR","CS","DA","NL","EN","FI","FR","DE","EL","HI","HU","ID","IT","JA","KO","MS","NB","PL","PT","RO","RU","ZH","SK","ES","SV","TL","TH","ZH","TR","UK","VI"],
        "size": "109784064",
        "requiredOsVersion": "15.1",
        "released": "2023-07-05T07:00:00Z",
        "updated": "2025-06-23T15:34:48Z",
        "releaseNotes": "We’re working fast to regularly update our app. To experience the newest features and improvements, download the latest version of the app.",
        "version": "386.0",
        "price": 0,
        "currency": "USD",
        "free": true,
        "developerId": 389801255,
        "developer": "Instagram, Inc.",
        "developerUrl": "https://apps.apple.com/us/developer/instagram-inc/id389801255?uo=4",
        "score": 4.61013,
        "reviews": 1203669,
        "currentVersionScore": 4.61013,
        "currentVersionReviews": 1203669,
        "screenshots": [],
        "ipadScreenshots": [],
        "appletvScreenshots": [],
        "supportedDevices": [
          "iPhone5s-iPhone5s","iPadAir-iPadAir", /* ...snip... */ "iPadAir13M3Cellular"
        ]
      },
      {
        "id": 310633997,
        "appId": "net.whatsapp.WhatsApp",
        "title": "WhatsApp Messenger",
        "url": "https://apps.apple.com/us/app/whatsapp-messenger/id310633997?uo=4",
        "description": "WhatsApp from Meta is a free messaging and calling app used by over 2 billion people across 180+ countries. It's super simple, reliable and private, making it perfect for staying in touch with your friends and family worldwide. WhatsApp works across mobile, tablet, and desktop even on slow connections, with no subscription fees*.\n\nPrivate messaging and calls across the world\n\nYour privacy is our priority. With end-to-end encryption, you can be sure that your personal messages and calls stay between you and who you send them to. And no one, not even WhatsApp, can read or listen to them.\n\nSimple and secure connections, right away\n\nAll you need is your phone number - no usernames or logins needed. Easily view your contacts on WhatsApp and start messaging. And what's more, you can easily  link your other devices, including iPads, for seamless connectivity.\n\nHigh quality voice and video calls\n\nEnjoy free, secure video and voice calls with up to 32 people for free. Your calls work across devices, even on slower connections, using your phone or tablet’s Internet service.\n\nGroup chats to keep you in contact\n\nStay close to friends and family through end-to-end encrypted group chats and calls. Share messages, photos, videos and documents across mobile, tablet, and desktop. You can also use call links and screen-sharing to make group calls and collaboration easy.\n\nStay connected in real time\n\nYou can share your location with those in your individual or group chats while using WhatsApp on your mobile phone. Or record a voice message for those moments when just text isn't good enough.\n\nShare daily moments through Status\n\nShare your everyday life with those who matter. With Status you can share text, photos, video, and GIF updates that disappear after 24 hours. You're always in control of who sees your status. Just choose who you want to share it with - all your contacts or selected ones. And bring your everyday to life.\n\n*Data charges may apply. Contact your provider for details.\n\n\n---------------------------------------------------------------------------\n\nIf you have any feedback or questions, please go to WhatsApp > Settings > Help > Contact Us\n\nTerms of Service: https://www.whatsapp.com/legal/terms-of-service \n\nLearn more about messaging privately: https://www.whatsapp.com/privacy \n\nLearn more about WhatsApp safety: https://www.whatsapp.com/security",
        "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/00/74/dd/0074dd5e-fa11-87f2-5f1f-196db0a596c5/AppIcon-0-0-1x_U007epad-0-0-0-1-0-0-0-85-220.png/512x512bb.jpg",
        "genres": ["Social Networking", "Utilities"],
        "genreIds": ["6005", "6002"],
        "primaryGenre": "Social Networking",
        "primaryGenreId": 6005,
        "contentRating": "12+",
        "languages": ["AR", "BN", "CA", "HR", "CS", "DA", "NL", "EN", "FI", "FR", "DE", "EL", "GU", "HE", "HI", "HU", "ID", "GA", "IT", "JA", "KO", "MS", "MR", "NB", "FA", "PL", "PT", "RO", "RU", "ZH", "SK", "ES", "SV", "TH", "ZH", "TR", "UK", "UR", "VI"],
        "size": "262845440",
        "requiredOsVersion": "15.1",
        "released": "2009-05-04T02:43:49Z",
        "updated": "2025-06-26T16:23:18Z",
        "releaseNotes": "• You can now create animated stickers from your videos. Open a chat > Tap the ‘sticker’ icon in the composer > choose the ‘sticker’ tab’ > select ‘Create’ and choose a video to get started.\n• Updated voice messages so you can record by simply tapping the ‘microphone’ icon in chats.\n\n\nThese features will roll out over the coming weeks. Thanks for using WhatsApp!",
        "version": "25.18.86",
        "price": 0,
        "currency": "USD",
        "free": true,
        "developerId": 310634000,
        "developer": "WhatsApp Inc.",
        "developerUrl": "https://apps.apple.com/us/developer/whatsapp-inc/id310634000?uo=4",
        "developerWebsite": "http://www.whatsapp.com/",
        "score": 4.69112,
        "reviews": 15950458,
        "currentVersionScore": 4.69112,
        "currentVersionReviews": 15950458,
        "screenshots": [
          "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/2e/ac/31/2eac3171-9a0b-cd63-2378-74c024f8a9e7/1f8cb34e-74b3-422f-a601-e5f35e7665f7_1.png/392x696bb.png",
          // ... More screenshots ...
        ],
        "ipadScreenshots": [],
        "appletvScreenshots": [],
        "supportedDevices": [
          "MacDesktop-MacDesktop","iPhone5s-iPhone5s", /* ...snip... */ "iPadAir13M3Cellular"
        ]
      }
      // ... More similar apps ...
    ]
  }
}

App Reviews

Fetch reviews for an App Store app by app ID. Supports filtering and sorting.
All endpoints require authentication.

GET /api/appstore/app/reviews/{id}

Description: Get recent reviews for an app.
Parameters:

  • id (required): App Store app ID (e.g. 284882215).
Returns: An array of recent review objects.

Sample Minimal Response: 
{
  "success": true,
  "data": {
    "results": [
      {
        "id": "12819915973",
        "userName": "Jyddhiojvxdsvbuijbb",
        "score": 3,
        "title": "Hacked",
        "text": "I’ve been hacked through this pathetic site!!!",
        "updated": "2025-06-26T08:43:26-07:00"
      },
      {
        "id": "12819912095",
        "userName": "Victoredcade",
        "score": 1,
        "title": "Si pudiera le doy 0 estrellas",
        "text": "Trabajo con marketplace ...",
        "updated": "2025-06-26T08:42:17-07:00"
      }
      // ...more reviews...
    ]
  }
}

GET /api/appstore/app/reviews/{id}/filtered

Description: Get filtered reviews for an app.
Parameters:

  • id (required): App Store app ID (e.g. 284882215).
  • country (optional, default: US): Store country (e.g. IT).
  • sort (optional, default: RECENT): RECENT or HELPFUL.
  • appId (optional): Bundle/app identifier (e.g. com.facebook.Facebook).
Returns: An array of filtered review objects.

Sample Minimal Response: 
{
  "success": true,
  "data": {
    "results": [
      {
        "id": "3534413367",
        "userName": "Pietrogia99",
        "score": 5,
        "title": "Problemi con Facebook",
        "text": "BuonaSera, in pratica ieri ho creato un nuovo profilo Facebook ...",
        "updated": "2018-12-15T10:25:57-07:00"
      },
      {
        "id": "6588401115",
        "userName": "Immobile96",
        "score": 1,
        "title": "Peggior app di sempre",
        "text": "È quasi scandaloso che un app del genere venga approvata sull’App Store...",
        "updated": "2020-10-29T18:42:13-07:00"
      }
      // ...more reviews...
    ]
  }
}
Note:
  • Each review includes id, userName, score (1-5), title, text, and updated date.
  • Pagination and country-specific reviews are supported via query parameters.

App Ratings

Fetch ratings and ratings histogram for an App Store app by app ID.
All endpoints require authentication.

GET /api/appstore/app/ratings/{id}

Description: Get global ratings summary for an app.
Parameters:

  • id (required): App Store app ID (e.g. 284882215).
Returns: Total ratings and ratings histogram.

Sample Minimal Response: 
{
  "success": true,
  "data": {
    "results": {
      "ratings": 20784158,
      "histogram": {
        "1": 1631843,
        "2": 316109,
        "3": 752643,
        "4": 1700734,
        "5": 16382829
      }
    }
  }
}

GET /api/appstore/app/ratings/{id}/filtered

Description: Get country-specific ratings summary for an app.
Parameters:

  • id (required): App Store app ID (e.g. 284882215).
  • country (optional, default: US): Store country (e.g. FR).
  • appId (optional): Bundle/app identifier (e.g. com.facebook.Facebook).
Returns: Country-specific total ratings and ratings histogram.

Sample Minimal Response: 
{
  "success": true,
  "data": {
    "results": {
      "ratings": 1806330,
      "histogram": {
        "1": 148637,
        "2": 35007,
        "3": 97777,
        "4": 233083,
        "5": 1291826
      }
    }
  }
}
Note:
  • The histogram is a breakdown of rating counts by score (1–5 stars).
  • Use country param to fetch ratings for a specific region.

App Version History

Retrieve the full version changelog (release notes) for an App Store app by app ID.
All endpoints require authentication.

GET /api/appstore/app/version/{id}

Description: Get the complete version/release history (with release notes) for an app.
Parameters:

  • id (required): App Store app ID (e.g. 284882215).
Returns: List of all available versions, each with versionDisplay, releaseNotes, releaseDate.

Sample Minimal Response: 
{
  "success": true,
  "data": {
    "results": [
      {
        "versionDisplay": "519.1",
        "releaseNotes": "Our teams have solved many crashes, fixed issues you’ve reported and made the app faster.",
        "releaseDate": "2025-06-26"
      },
      {
        "versionDisplay": "519.0.0",
        "releaseNotes": "Our teams have solved many crashes, fixed issues you’ve reported and made the app faster.",
        "releaseDate": "2025-06-24"
      }
      // ...more versions
    ]
  }
}

Keyword Suggest

Get suggested App Store search terms for a given keyword.
All endpoints require authentication.

GET /api/appstore/keyword/suggest/{term}

Description: Get search suggestions for a given keyword term.
Parameters:

  • term (required): The search keyword to suggest related terms for (e.g. track).
Returns: List of suggested search terms related to the input keyword.

Sample Minimal Response: 
{
  "success": true,
  "data": {
    "results": [
      { "term": "track appstore apps, apptrack" },
      { "term": "track-tally" },
      { "term": "trackman golf" },
      { "term": "health monitor- ai & track bp" },
      { "term": "tracki" },
      { "term": "tracker detect" },
      { "term": "track package" },
      { "term": "track my run" },
      { "term": "track" },
      { "term": "intake - alcohol tracker" }
    ]
  }
}

Plans & Pricing

View the available subscription plans and pricing details for ASOReport API access.

Contact & Support

Need help, found a bug, or want to suggest a new feature?
Our support team is here to assist you with any questions regarding API usage, authentication, rate limits, or technical issues.

Tip: For the fastest response, include your API key (never share it publicly), request URL, and any error message you received.

Terms & Policies

By using the ASOReport API, you agree to our terms and policies. Please read these documents carefully to understand your rights, responsibilities, and how your data is handled.

Note: Violation of our terms or acceptable use policy may result in API access suspension or termination.
⬆️