Docs menu

AppStore API endpoint

App Store Editorial Category Page API

Returns the curated editorial shelves for one device category page (e.g. "Entertainment Apps for Vision"). `category_id` is a numeric, device-specific editorial page ID — not a static enum — discovered from an `appstore_editorial` response for the SAME `device`, in its "Browse by Category" shelf items' `destination_id` field. `device` enum: `iphone`, `ipad`, `mac`, `vision`, `watch`, `tv`.

GETapiKey1 credit/requestAppStoreappstore.editorialResponseDoc/appstore/editorial/category

Endpoint facts

Method: GET
API path: /appstore/editorial/category
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: AppStore
Response schema: #/definitions/appstore.editorialResponseDoc
MCP tool: appstore_editorial_category

App Store Search API Try App Store Editorial Category Page API in Playground AppStore API documentation

How this endpoint behaves

MCP tool: appstore_editorial_category

Returns the curated editorial shelves for a category-scoped App Store page, e.g. "Entertainment Apps for Vision". Category pages are reached by a numeric editorial page ID that is device-specific and not a static/ predictable enum — discover it by calling appstore_editorial for the SAME device first and reading destination_id off the "Browse by Category" shelf's items.

Query parameters:

device: required. Apple device catalog. Allowed values: iphone, ipad, mac, vision, watch, tv.
category_id: required. Numeric App Store editorial page ID, digits only (e.g. 6503709728). Not portable across devices — the same ID resolves only for the device it was discovered under and returns 404 for any other device.
country: optional. Two-letter storefront country code.
lang: optional. Result language tag.

Response shape is identical to appstore_editorial's (section is set to "category").

Example response (device=vision&category_id=6503709728):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "device": "vision",
    "section": "category",
    "title": "Entertainment Apps",
    "seo_title": "Entertainment Apps for Vision - App Store",
    "shelves": [
      {
        "id": "shelf_eds.<id>",
        "title": "The Best Entertainment Apps",
        "content_type": "largeBrick",
        "items": [
          {
            "kind": "Lockup",
            "id": 389801252,
            "title": "Amazon Prime Video",
            "subtitle": "Originals, movies, TV, sports",
            "developer_name": "AMZN Mobile LLC",
            "url": "https://apps.apple.com/us/app/amazon-prime-video/id545519333"
          }
        ]
      }
    ]
  }
}

Live monitoring

Monitored request: GET /appstore/editorial/category?category_id=6503709728&country=us&device=vision&lang=en
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.99 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /appstore/editorial/category?category_id=6503709728&country=us&device=vision&lang=en
Items in shelves: 8
Fields filled in every checked item: 2
Fields empty in some or all items: 2

Field	Filled in, of 8 checked	Values in the sample
id	7
content_type	8	“heroCarousel” and 4 other values
items	8	median 8 entries
title	6	median 27 characters

Request parameters

Parameter	Type	Required	Description	Example
device	string	Yes	Apple device catalog Allowed values: iphone, ipad, mac, vision, watch, tv.	iphone
category_id	string	Yes	Numeric App Store editorial page ID, discovered from appstore_editorial (same device)	6503709728
country	string	No	Two-letter storefront country code	us
lang	string	No	Result language tag	en-us
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/appstore/editorial/category?device=iphone&category_id=6503709728&country=us&lang=en" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "device": "vision",
    "section": "category",
    "title": "Entertainment Apps",
    "seo_title": "Entertainment Apps for Vision - App Store",
    "shelves": [
      {
        "id": "shelf_eds.<id>",
        "title": "The Best Entertainment Apps",
        "content_type": "largeBrick",
        "items": [
          {
            "kind": "Lockup",
            "id": 389801252,
            "title": "Amazon Prime Video",
            "subtitle": "Originals, movies, TV, sports",
            "developer_name": "AMZN Mobile LLC",
            "url": "https://apps.apple.com/us/app/amazon-prime-video/id545519333"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/appstore.editorialResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	appstore.EditorialPage	No
data.device	string	No		Apple device catalog of the page: `iphone`, `ipad`, `mac`, `vision`, `watch` or `tv`.
data.page_id	string	No		Apple's ID for the editorial page.
data.section	string	No		main \| arcade \| category
data.seo_title	string	No		Page title used for search results and browser tabs.
data.shelves	array	No		Content shelves on the page, in display order.
data.shelves[].content_type	string	No		Layout style Apple uses to show the shelf, for example `smallLockup`.
data.shelves[].id	string	No		Apple's ID for the shelf.
data.shelves[].items	array	No		Items shown in the shelf.
data.shelves[].items[].age_rating	string	No		Age rating shown on the item, for example `4+`.
data.shelves[].items[].bundle_id	string	No		Bundle ID of the app, when the item is a single app.
data.shelves[].items[].destination_id	string	No		DestinationID is the item's clickAction.destination.id. For a "Browse by Category" shelf item this is the target category's editorial page ID — pass it as EditorialCategoryOption.CategoryID for the SAME device. Live-verified this is NOT unique to category links, though: a regular single-app item (e.g. Lockup) carries its own ID here too (a self-referential page link, duplicating ID/AdamID) — so callers looking for a category ID should scope to the shelf titled "Browse by Category" rather than taking the first non-empty DestinationID from any shelf.
data.shelves[].items[].developer_name	string	No		Name of the developer shown on the item.
data.shelves[].items[].icon_url	string	No		template URL with unresolved size tokens
data.shelves[].items[].id	integer	No		App Store numeric track ID, when this item is a single app (same ID space as App.ID)
data.shelves[].items[].kind	string	No		raw Apple "$kind"
data.shelves[].items[].rating	number	No		Average rating shown on the item.
data.shelves[].items[].rating_count	integer	No		Number of ratings shown on the item.
data.shelves[].items[].subtitle	string	No		Subtitle shown on the item.
data.shelves[].items[].title	string	No		Title shown on the item.
data.shelves[].items[].url	string	No		the item's own apps.apple.com page, when it links to one
data.shelves[].title	string	No		absent for hero/quick-links shelves
data.title	string	No		Title of the editorial page.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Missing or invalid parameters	#/definitions/app.Response
404	Category page not found	#/definitions/app.Response
429	Rate limit exceeded	#/definitions/app.Response
500	Internal server error	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/appstore/editorial/category?device=iphone&category_id=6503709728&country=us&lang=en" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing MCP server Acceptable use

More AppStore endpoint docs App Store Search API App Store App Details API documentation App Store Chart Categories API documentation App Store Collection Apps API documentation App Store Collections API documentation App Store Developer Apps API documentation Apple App Store Editorial Pages API documentation

Open in Playground Back to group

Docs menu

AppStore API endpoint

App Store Editorial Category Page API

GETapiKey1 credit/requestAppStoreappstore.editorialResponseDoc/appstore/editorial/category

Endpoint facts

Method: GET
API path: /appstore/editorial/category
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: AppStore
Response schema: #/definitions/appstore.editorialResponseDoc
MCP tool: appstore_editorial_category

App Store Search API Try App Store Editorial Category Page API in Playground AppStore API documentation

How this endpoint behaves

MCP tool: appstore_editorial_category

Query parameters:

device: required. Apple device catalog. Allowed values: iphone, ipad, mac, vision, watch, tv.
category_id: required. Numeric App Store editorial page ID, digits only (e.g. 6503709728). Not portable across devices — the same ID resolves only for the device it was discovered under and returns 404 for any other device.
country: optional. Two-letter storefront country code.
lang: optional. Result language tag.

Response shape is identical to appstore_editorial's (section is set to "category").

Example response (device=vision&category_id=6503709728):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "device": "vision",
    "section": "category",
    "title": "Entertainment Apps",
    "seo_title": "Entertainment Apps for Vision - App Store",
    "shelves": [
      {
        "id": "shelf_eds.<id>",
        "title": "The Best Entertainment Apps",
        "content_type": "largeBrick",
        "items": [
          {
            "kind": "Lockup",
            "id": 389801252,
            "title": "Amazon Prime Video",
            "subtitle": "Originals, movies, TV, sports",
            "developer_name": "AMZN Mobile LLC",
            "url": "https://apps.apple.com/us/app/amazon-prime-video/id545519333"
          }
        ]
      }
    ]
  }
}

Live monitoring

Monitored request: GET /appstore/editorial/category?category_id=6503709728&country=us&device=vision&lang=en
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.99 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /appstore/editorial/category?category_id=6503709728&country=us&device=vision&lang=en
Items in shelves: 8
Fields filled in every checked item: 2
Fields empty in some or all items: 2

Field	Filled in, of 8 checked	Values in the sample
id	7
content_type	8	“heroCarousel” and 4 other values
items	8	median 8 entries
title	6	median 27 characters

Request parameters

Parameter	Type	Required	Description	Example
device	string	Yes	Apple device catalog Allowed values: iphone, ipad, mac, vision, watch, tv.	iphone
category_id	string	Yes	Numeric App Store editorial page ID, discovered from appstore_editorial (same device)	6503709728
country	string	No	Two-letter storefront country code	us
lang	string	No	Result language tag	en-us
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/appstore/editorial/category?device=iphone&category_id=6503709728&country=us&lang=en" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "device": "vision",
    "section": "category",
    "title": "Entertainment Apps",
    "seo_title": "Entertainment Apps for Vision - App Store",
    "shelves": [
      {
        "id": "shelf_eds.<id>",
        "title": "The Best Entertainment Apps",
        "content_type": "largeBrick",
        "items": [
          {
            "kind": "Lockup",
            "id": 389801252,
            "title": "Amazon Prime Video",
            "subtitle": "Originals, movies, TV, sports",
            "developer_name": "AMZN Mobile LLC",
            "url": "https://apps.apple.com/us/app/amazon-prime-video/id545519333"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/appstore.editorialResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	appstore.EditorialPage	No
data.device	string	No		Apple device catalog of the page: `iphone`, `ipad`, `mac`, `vision`, `watch` or `tv`.
data.page_id	string	No		Apple's ID for the editorial page.
data.section	string	No		main \| arcade \| category
data.seo_title	string	No		Page title used for search results and browser tabs.
data.shelves	array	No		Content shelves on the page, in display order.
data.shelves[].content_type	string	No		Layout style Apple uses to show the shelf, for example `smallLockup`.
data.shelves[].id	string	No		Apple's ID for the shelf.
data.shelves[].items	array	No		Items shown in the shelf.
data.shelves[].items[].age_rating	string	No		Age rating shown on the item, for example `4+`.
data.shelves[].items[].bundle_id	string	No		Bundle ID of the app, when the item is a single app.
data.shelves[].items[].destination_id	string	No		DestinationID is the item's clickAction.destination.id. For a "Browse by Category" shelf item this is the target category's editorial page ID — pass it as EditorialCategoryOption.CategoryID for the SAME device. Live-verified this is NOT unique to category links, though: a regular single-app item (e.g. Lockup) carries its own ID here too (a self-referential page link, duplicating ID/AdamID) — so callers looking for a category ID should scope to the shelf titled "Browse by Category" rather than taking the first non-empty DestinationID from any shelf.
data.shelves[].items[].developer_name	string	No		Name of the developer shown on the item.
data.shelves[].items[].icon_url	string	No		template URL with unresolved size tokens
data.shelves[].items[].id	integer	No		App Store numeric track ID, when this item is a single app (same ID space as App.ID)
data.shelves[].items[].kind	string	No		raw Apple "$kind"
data.shelves[].items[].rating	number	No		Average rating shown on the item.
data.shelves[].items[].rating_count	integer	No		Number of ratings shown on the item.
data.shelves[].items[].subtitle	string	No		Subtitle shown on the item.
data.shelves[].items[].title	string	No		Title shown on the item.
data.shelves[].items[].url	string	No		the item's own apps.apple.com page, when it links to one
data.shelves[].title	string	No		absent for hero/quick-links shelves
data.title	string	No		Title of the editorial page.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Missing or invalid parameters	#/definitions/app.Response
404	Category page not found	#/definitions/app.Response
429	Rate limit exceeded	#/definitions/app.Response
500	Internal server error	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/appstore/editorial/category?device=iphone&category_id=6503709728&country=us&lang=en" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing MCP server Acceptable use

Open in Playground Back to group

App Store Editorial Category Page API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

App Store Editorial Category Page API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related