JustSERPDocs
Apple

Apple App Store Top Grossing

The top grossing apps of a storefront, from Apple's top-grossing feed, answered as the document: `chart_information` and `top_grossing_apps`.

GET
/v1/apple/app-store/top-grossing

The top grossing apps of a storefront, from Apple's top-grossing feed, answered as the document: chart_information and top_grossing_apps. Nothing is required. A games sub-genre (games-action) lists games whose primary genre is Games or the sub-genre.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
category?string

A genre id or name, as for the top charts.

Default"all"
store_device?string

Store.

Default"iphone"
Value in"iphone""ipad""appletv"
country?string

The storefront.

Match^[A-Za-z]{2}$
Default"us"
num?integer

Apps.

Range1 <= value <= 100
Default50

Response Body

The chart, as the document. When the feed could not be parsed, the usual envelope.

application/json
  1. response

The first keys of a document-form answer. Unlike DocumentHead there is no search_information unless the engine has one (there is none for the AI engines, Events, Events Details, Facebook, Tripadvisor Place, Trending Now and the Apple engines' places).

search_metadata*
search_parameters*

The parameters the search ran with, defaults filled in; engine is the engine's name.

search_information?
chart_information?
top_grossing_apps?array<>
Example Request
curl -X GET 'https://api.justserp.com/v1/apple/app-store/top-grossing?category=all&country=us&num=50'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {},  "chart_information": {    "title": "string",    "link": "string",    "updated_at": "string"  },  "top_grossing_apps": [    {      "position": 0,      "id": "string",      "bundle_id": "string",      "title": "string",      "description": "string",      "link": "string",      "thumbnail": "string",      "logos": [        {          "link": "string",          "width": 0,          "height": 0        }      ],      "developer": {        "name": "string",        "id": "string",        "link": "string"      },      "category": {        "id": 0,        "name": "string",        "canonical_name": "string",        "link": "string"      },      "price": {        "type": "string",        "formatted_price": "string",        "extracted_price": 0,        "currency": "string",        "currency_symbol": "string",        "is_free": true      },      "release_date": "string",      "release_date_text": "string"    }  ]}

Apple App Store Top Charts GET

The free or paid chart of a storefront, from Apple's chart feed, answered as the document with `top_charts`.

Bing Maps listing GET

One business' listing on Bing Maps (what Bing Places for Business publishes), by `place_id` (Bing's ypid, `YNB7EDF204457059FB`, with or without `ypid:`) or by a `profile_url` that carries it, in the citation shape.