AppStore

Retrieve App Store collection rankings

Returns ranked App Store apps from an iTunes RSS collection, optionally expanded to full lookup details. collection enum: topfreeapplications, toppaidapplications, topgrossingapplications, topfreeipadapplications, toppaidipadapplications, topgrossingipadapplications, topmacapps, topfreemacapps, topgrossingmacapps, toppaidmacapps, newapplications, newfreeapplications, newpaidapplications. Of the Mac collections, only topfreemacapps currently returns ranked apps — topmacapps, topgrossingmacapps, and toppaidmacapps are accepted but Apple's feed for them is currently empty. There is no separate Games collection — combine any collection with category=6014 (or a Games subgenre ID, e.g. 7012 for Puzzle) to get its Games-only equivalent, e.g. Top Free Games. See the endpoint markdown for the full category ID table.

get/appstore/list

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/appstore/list
  • Auth: API key in header x-api-key

Query parameters

collectionstring

Chart collection slug, see description for the full enum

categoryinteger

Numeric App Store category ID, see description for the full enum; e.g. 6014 = Games, 7012 = Games/Puzzle

countrystring

Two-letter storefront country code

langstring

Result language tag

numinteger

Number of apps to return

full_detailboolean

Expand each app via lookup API

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.