AppStore Scraper

Scrape AppStore app listing details like descriptions, reviews, and more by providing the app store App ID

Authentication

ApiStacks uses API keys to authenticate requests. You can view and manage your API keys in the Dashboard.

Your API keys carry many privileges. To keep them from being abused, please do not share the keys on client-side code or Github etc. Keep them very secure.

All requests made to the API must contain the parameter api_key in each of your requests. API requests without authentication will fail.

All API requests must also be made over secure HTTPS. Requests made over plain HTTP may fail.

Endpoint

GET /appstore

Parameters

api_key (required)

In your Request URL, provide the API Key found within your Dashboard

appid (required)

Enter the numeric App ID without any spaces. e.g 544007664

country (required)

Enter the app store country code (2 letters) to perform the lookup. Will default to the US

Premium Parameters

These parameters require a paid subscription to modify

response_type (optional)

Set to “JSON”, “XML”, or “YAML” depending what type of response you want from the API.

Want to test this API and get live results?

lIVE dEMO

Sample Request

curl --request GET \
--url 'https://api.apistacks.com/v1/appstore?api_key={APIKEY}&appid={appid}' \

Sample Response

{
    "status": "ok",
    "timestamp": 1608224406130,
    "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": "Start playing Candy Crush Saga today – a legendary puzzle game loved by millions of players around the world.\n\nWith over a trillion levels played, this sweet match 3 puzzle game is one of the most popular mobile games of all time!\n\nSwitch and match Candies in this tasty puzzle adventure to progress to the next level for that sweet winning feeling! Solve puzzles with quick thinking and smart moves, and be rewarded with delicious rainbow-colored cascades and tasty candy combos!\n\nPlan your moves by matching 3 or more candies in a row, using boosters wisely in order to overcome those extra sticky puzzles! Blast the chocolate and collect sweet candy across thousands of levels, guaranteed to have you craving more!\n\nCandy Crush Saga features:\n\nTHE GAME THAT KEEPS YOU CRAVING MORE\nThousands of the best levels and puzzles in the Candy Kingdom and with more added every 2 weeks your sugar fix is never far away! \n\nMANY WAYS TO WIN REWARDS\nCheck back daily and spin the Daily Booster Wheel to receive free tasty rewards, and take part in time limited challenges to earn boosters to help you level up! \n\n VARIETY OF SUGAR-COATED CHALLENGES\nSweet ways to play: Game modes including Target Score, Clear the Jelly, Collect the Ingredients and Order Mode\n\nPLAY ALONE OR WITH FRIENDS\nGet to the top of the leaderboard events and compare scores with friends and competitors!\n\nLevels range from easy to hard for all adults to enjoy – accessible on-the-go, offline and online.\nIt's easy to sync the game between devices and unlock full game features when connected to the Internet or Wifi.\nFollow us to get news and updates; facebook.com/CandyCrushSaga, Twitter @CandyCrushSaga, Youtube https://www.youtube.com/user/CandyCrushOfficial\nVisit https://community.king.com/en/candy-crush-saga to access the Community and competitions!\nCandy Crush Saga is completely free to play but some optional in-game items will require payment.\nYou can turn off the payment feature by disabling in-app purchases in your device’s settings.\nBy downloading this game you are agreeing to our terms of service; http://about.king.com/consumer-terms/terms\n\nDo not sell my data: King shares your personal information with advertising partners to personalize ads. Learn more at https://king.com/privacyPolicy.  If you wish to exercise your Do Not Sell My Data rights, you can do so by contacting us via the in game help centre or by going to https://soporto.king.com/\n\nHave fun playing Candy Crush Saga the sweetest match 3 puzzle game around! \nIf you enjoy playing Candy Crush Saga, you may also enjoy its sister puzzle games; Candy Crush Soda Saga, Candy Crush Jelly Saga and Candy Crush Friends Saga!",
        "icon": "https://is5-ssl.mzstatic.com/image/thumb/Purple122/v4/95/23/6a/95236a27-d9b7-1dbd-f379-5eaede4b0c97/source/512x512bb.jpg",
        "genres": [
            "Games",
            "Entertainment",
            "Puzzle",
            "Casual"
        ],
        "genreIds": [
            "6014",
            "6016",
            "7012",
            "7003"
        ],
        "primaryGenre": "Games",
        "primaryGenreId": 6014,
        "contentRating": "4+",
        "languages": [
            "AR",
            "CA",
            "HR",
            "CS",
            "DA",
            "NL",
            "EN",
            "FI",
            "FR"
        ],
        "size": "367181824",
        "requiredOsVersion": "9",
        "released": "2012-11-14T14:41:32Z",
        "updated": "2022-04-19T12:11:33Z",
        "releaseNotes": "We hope you’re having fun playing Candy Crush Saga! We update the game every week so don't forget to download the latest version to get all the sweet new features and levels!\n\nNew to the game? Don’t be shy, join the fun!",
        "version": "1.225.0.1",
        "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.70971,
        "reviews": 2420435,
        "currentVersionScore": 4.70971,
        "currentVersionReviews": 2420435,
        "screenshots": [
            "https://is3-ssl.mzstatic.com/image/thumb/PurpleSource125/v4/c2/cb/00/c2cb009a-f99c-cf25-39f9-1c56031a8bd5/ce552d6d-7f70-47c8-9329-0aad6ccef2e6_90519_ccs_candy-characters-screenshot-resize_iPhone6_sta_1242x2208_en.jpg/392x696bb.jpg",
            "https://is4-ssl.mzstatic.com/image/thumb/Purple115/v4/34/db/5f/34db5f52-a4e3-af86-918d-739cc7d14bef/tns.puwwkesm.jpg/392x696bb.jpg",
            "https://is5-ssl.mzstatic.com/image/thumb/Purple125/v4/95/f9/1e/95f91ea5-93af-dc4f-256d-1872351c2a75/tns.cvxvvnmd.jpg/392x696bb.jpg",
            "https://is2-ssl.mzstatic.com/image/thumb/Purple125/v4/09/0f/67/090f6718-a88f-1b3c-4fb5-e4910ca8d6d9/tns.ngmpvjir.jpg/392x696bb.jpg",
            "https://is4-ssl.mzstatic.com/image/thumb/Purple115/v4/12/1c/7a/121c7a15-9a06-4149-0237-f65dd2af1cea/tns.jtafjlou.jpg/392x696bb.jpg",
            "https://is1-ssl.mzstatic.com/image/thumb/Purple115/v4/ef/76/75/ef767549-f7ce-86b9-4dae-55ac7d544694/6bc1cda6-a3ad-46de-b49a-2b55421b4858_16057_ccs_gameplay_screenshot_iOS6_1242x2208_en.jpg/392x696bb.jpg"
        ],
        "ipadScreenshots": [
            "https://is2-ssl.mzstatic.com/image/thumb/PurpleSource115/v4/66/95/6c/66956c41-08cc-9caa-9d4c-62b8ab4fd35d/a8494d55-18b1-4ee4-af62-5fc0654ca08f_90519_ccs_candy-characters-screenshot-resize_iPad_sta_2048x2732_en.jpg/576x768bb.jpg",
            "https://is2-ssl.mzstatic.com/image/thumb/Purple125/v4/a5/aa/c1/a5aac1f1-3144-0724-cb1d-1d20df6958c8/tns.stwmbyxx.jpg/576x768bb.jpg",
            "https://is5-ssl.mzstatic.com/image/thumb/Purple125/v4/d7/b7/ac/d7b7ac96-1498-4221-3571-0f0171696e9d/tns.smhdvwdi.jpg/576x768bb.jpg",
            "https://is4-ssl.mzstatic.com/image/thumb/Purple125/v4/24/19/96/24199656-c193-97ed-f50e-63cc8d60db88/tns.dvpmuftb.jpg/576x768bb.jpg",
            "https://is3-ssl.mzstatic.com/image/thumb/Purple125/v4/b7/63/0a/b7630a16-34c6-0e9c-6d5a-43abbb47e8f9/tns.gxodrzas.jpg/576x768bb.jpg",
            "https://is5-ssl.mzstatic.com/image/thumb/Purple125/v4/ba/ce/71/bace7122-7205-5d4d-11a5-e034a05e23d3/tns.scgsbvfv.jpg/552x414bb.jpg"
        ],
        "appletvScreenshots": [],
        "supportedDevices": [
            "iPhone6Plus-iPhone6Plus",
            "iPadAir2-iPadAir2",
            "iPadAir2Cellular-iPadAir2Cellular",
            "iPadMini3-iPadMini3",            
            "iPad834-iPad834",
            "iPad856-iPad856"
        ]
    }
}

Rate Limiting

Each subscription has its own rate limit. Your limit is based on your subscription plan (free or paid). If you exceed your limits, don’t worry. You can always upgrade or downgrade at any time.

When you reach a rate limit (both daily and monthly), the service will stop responding and return an HTTP 429 response status code. The error will contain the following JSON string body text.

{
    "status": "fail",
    "data": "",
    "reason": "Usage limit reached. Please review/upgrade your account"
}

A reminder email will be sent to you when your API usage reaches 80% and 90% so that you can take immediate actions such as upgrading your plan in order to prevent your application using the API from being interrupted.

Error Codes

ApiStacks uses standard HTTP response codes to indicate the success or failure of an API request.

If the response code is not 200 Ok, it means the operation has failed. You can check the response for a field called ‘reason‘ that briefly explains what the error may be.

Status Code	Reason
400	The request was not complete or malformed. Parameters may be missing
401	API key was not provided or was not valid
403	Usage limit was likely reached or the app was not enabled in the dashboard
404	API Endpoint does not exist
405	Method is not allowed (Only use GET)
500	An error occurred on our end