---
title: "Retrieve apps in one App Store collection"
method: GET
path: "/appstore/collection"
tags: ["AppStore"]
---

# Retrieve apps in one App Store collection

`GET /appstore/collection`

## Request

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

Returns app items embedded in an Apple room or EDS collection page. Discover IDs with `appstore_collections`. `platform` enum: `iphone`, `ipad`, `mac`, `vision`, `watch`, `tv`. `collection_id` must be a numeric room ID or `eds.UUID` ID returned by the discovery endpoint.

## Query parameters

- `platform` 'iphone' | 'ipad' | 'mac' | 'vision' | 'watch' | 'tv', required
- `collection_id` string, required
- `country` string
- `lang` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- AppstoreCollectionResponseDoc
  - `code` integer
  - `data` AppstoreAppStoreCollectionPage
    - `apps` AppstoreEditorialItem[]
      - `age_rating` string: Age rating shown on the item, for example `4+`.
      - `bundle_id` string: Bundle ID of the app, when the item is a single app.
      - `destination_id` string: 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.
      - `developer_name` string: Name of the developer shown on the item.
      - `icon_url` string: template URL with unresolved size tokens
      - `id` integer: App Store numeric track ID, when this item is a single app (same ID space as App.ID)
      - `kind` string: raw Apple "$kind"
      - `rating` number: Average rating shown on the item.
      - `rating_count` integer: Number of ratings shown on the item.
      - `subtitle` string: Subtitle shown on the item.
      - `title` string: Title shown on the item.
      - `url` string: the item's own apps.apple.com page, when it links to one
    - `id` string
    - `kind` string
    - `platform` string
    - `title` string
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `404`: Collection not found
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)