---
title: "Retrieve full App Store app details"
method: GET
path: "/appstore/app"
tags: ["AppStore"]
---

# Retrieve full App Store app details

`GET /appstore/app`

## Request

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

Returns app metadata from the App Store. Provide either `id` (numeric track ID) or `app_id` (bundle ID). `id`/`app_id` can identify an iPhone, iPad, or Mac App Store listing.

## Query parameters

- `id` string
- `app_id` string
- `country` string
- `lang` string
- `ratings` boolean
- `platforms` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- AppstoreAppDetailsResponseDoc
  - `code` integer
  - `data` AppstoreApp
    - `app_id` string: Bundle ID of the app, for example `com.openai.chat`.
    - `appletv_screenshots` string[]: URLs of the app's Apple TV screenshots.
    - `content_rating` string: Age rating of the app, for example `4+`.
    - `currency` string: Currency code of `price`.
    - `current_version_reviews` integer: Number of user ratings for the current version.
    - `current_version_score` number: Average user rating of the current version.
    - `description` string: Full description of the app from its App Store page.
    - `developer` string: Name of the app's developer.
    - `developer_id` integer: App Store ID of the developer.
    - `developer_url` string: App Store page URL of the developer.
    - `developer_website` string: Website URL the developer lists for the app.
    - `free` boolean: `true` when `price` is 0.
    - `genre_ids` string[]: IDs of all genres the app is listed under.
    - `genres` string[]: Names of all genres the app is listed under.
    - `histogram` object: Number of ratings for each star value, keyed by star value. Present only when `ratings=true` was requested.
    - `icon` string: URL of the app icon.
    - `id` integer: App Store numeric track ID of the app.
    - `ipad_screenshots` string[]: URLs of the app's iPad screenshots.
    - `languages` string[]: Languages the app supports, as two-letter ISO codes.
    - `platforms` string[]: Platforms is the set of Apple platforms this app is known to run on, using Apple's own appPlatforms vocabulary: phone, pad, mac, tv, watch, vision. "mac" is always populated for free when this record IS a Mac App Store listing (a separate catalog entry from the iPhone app, see Kind on lookupItem). The rest (and a "mac" tag for Mac-Catalyst-capable iPhone apps) are only populated when AppOption.Platforms was requested, since they require an extra upstream page fetch.
    - `price` number: Price of the app in `currency`. It is 0 for free apps.
    - `primary_genre` string: Name of the app's primary genre.
    - `primary_genre_id` integer: App Store ID of the app's primary genre.
    - `ratings` integer: Total number of user ratings. Present only when `ratings=true` was requested.
    - `release_notes` string: Release notes of the current version.
    - `released` string: Date and time the app was first released, in ISO 8601.
    - `required_os_version` string: Minimum operating system version the app needs.
    - `reviews` integer: Number of user ratings the app has across all versions.
    - `score` number: Average user rating of the app across all versions.
    - `screenshots` string[]: URLs of the app's screenshots.
    - `size` string: File size of the app in bytes, given as a string.
    - `supported_devices` string[]: Device model identifiers the app supports.
    - `title` string: Name of the app.
    - `updated` string: Date and time the current version was released, in ISO 8601.
    - `url` string: App Store page URL of the app.
    - `version` string: Current version number of the app.
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `404`: App 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/028417aa35bb?raw)