GET
List tracked apps

Authorizations

Origin
string
header
required

Same-origin CSRF check. The Origin header must match the request host; enforced for every mutating verb (POST, PUT, PATCH, DELETE).

Query Parameters

limit
integer

Page size (1–500). Supplying this parameter opts into the paginated envelope response; values outside the range return 400.

Required range: 1 <= x <= 500
offset
integer
default:0

Row offset into the name-ordered fleet. Only meaningful together with limit. An offset past the end returns an empty page, not an error.

Required range: x >= 0
meta
enum<string>

With meta=grid (and limit), the envelope gains a meta object carrying the per-app side-band maps the apps grid renders — profile badges, user verdicts, pending-change breakdown, and device links — scoped to the returned page.

Available options:
grid
view
enum<string>

Returns the grouped privacy view used by dashboards.

Available options:
grouped
devices
string

Restricts every list form — the bare array, the paginated envelope, and view=grouped — to apps on the given devices: a comma-separated list of device IDs, optionally including unattached for apps linked to no device, or all. In the envelope, total counts the restricted set and pages are drawn from it, so offset paging stays consistent. Opt-in: omitting it always returns the whole library. IDs that don't match a device are ignored; if nothing matches, the whole library is returned. See Devices.

Response

Bare array of apps (no limit), or a pagination envelope (with limit).

id
integer<int64>
required

Apple track ID extracted from /id<digits>/ in the App Store URL.

Example:

324684580

name
string
required
Example:

"Spotify - Music and Podcasts"

url
string<uri>
required
Example:

"https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580"

changeCount
integer
required

Unacknowledged change events. Drives the bell badge.

Example:

2

bundleId
string | null
Example:

"com.spotify.client"

developer
string | null
Example:

"Spotify Ltd."

privacyPolicyUrl
string<uri> | null
firstSeen
integer<int64>

Unix timestamp (ms) of first scrape.