Scraper · App stores
app_store.app
One app's page on Apple's App Store for a country: developer, category, rating, price, description, version and images.
- Id
app_store.app- Version
- 1
- Billed per
- request — 1 unit for a charged run
- Runs
- within one request
Start it with POST /v1/scrapers/app_store.app/runs. How runs work is in Running a scraper; what a run costs is in Usage and units.
Inputs
The fields of input. A field that is not listed here is refused.
| Field | Type | Description |
|---|---|---|
app_id | string | Apple's numeric app id, e.g. 310633997 (the digits after "id" in the app's address).Limit: matches ^(id)?[0-9]{1,20}$. |
url | string | The app's address, e.g. https://apps.apple.com/us/app/whatsapp-messenger/id310633997.Limit: at most 2048 characters. |
country | string | The storefront, as a two-letter country code (default us). Price, rating and availability are per storefront. With url, the address's own storefront is used and country may only repeat it.Limit: matches ^[A-Za-z]{2}$. |
- Give exactly one of
app_idandurl. Both, or neither, is refused withinvalid_input.
Record fields
Every record of a run has these fields. A value that is not known is null — never an empty string and never 0.
| Field | Type | Notes |
|---|---|---|
app_id | string | Apple's numeric app id: the digits after "id" in the app's address. |
bundle_id | string or null | The app's bundle identifier, e.g. net.whatsapp.WhatsApp. |
url | string | Always present. |
title | string | Always present. |
subtitle | string or null | null when not known. |
description | string or null | null when not known. |
developer | object | |
name (in developer) | string or null | null when not known. |
id (in developer) | string or null | Apple's numeric developer id. |
url (in developer) | string or null | The developer's page on the App Store. |
website (in developer) | string or null | The website the developer published on the listing (a business contact, as published). |
support_url (in developer) | string or null | The support address the developer published on the listing. |
category | string or null | The schema.org application category the page declares, e.g. GameApplication. |
genres | array of string | The App Store genres the page declares, as shown for the storefront. |
rating | number or null | Average rating, 0 to 5, in this storefront. |
rating_count | integer or null | Number of ratings in this storefront. |
price | object or null | null when not known. |
amount (in price) | number | The amount as the store states it; 0 for a free app. |
currency (in price) | string or null | The currency code the store gives with the amount (it follows the country asked for). |
free | boolean or null | null when not known. |
in_app_purchases | boolean or null | null when not known. |
content_rating | string or null | Apple's age rating, e.g. "9+". |
version | string or null | null when not known. |
updated_at | string (date-time) or null | When the current version was released. |
whats_new | string or null | null when not known. |
icon | string or null | null when not known. |
screenshots | array of string | The iPhone screenshots (another device's when the app has none for iPhone). |
privacy_policy_url | string or null | null when not known. |
requirements | string or null | The operating system requirement as stated. |
devices | array of string | The devices the page says the app is available on. |
country | string | The storefront, as a two-letter country code. |
language | string or null | The language the page was served in. |
fetched_at | string (date-time) | Always present. |
Example request
curl -X POST "https://api.enrichednow.com/v1/scrapers/app_store.app/runs?wait=60" \
-H "Authorization: Bearer $ENRICHEDNOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"app_id":"310633997","country":"us"}}'The body on its own:
{
"input": {
"app_id": "310633997",
"country": "us"
}
}Example response
The run, once it has ended. A run that has not ended within wait comes back with 202 and the status queued or running.
{
"id": "run_6cce2b12aaf37a10b5e1b885",
"scraper_id": "app_store.app",
"scraper_version": 1,
"status": "ok",
"reason": null,
"input": {
"app_id": "310633997",
"country": "us"
},
"record_count": 1,
"units": 1,
"diagnostics": {
"requests": 1,
"bytes": 232779,
"wall_ms": 565,
"facts": {}
},
"created_at": "2026-11-16T20:27:29.009834Z",
"started_at": "2026-11-16T20:27:29.013803Z",
"finished_at": "2026-11-16T20:27:29.582787Z"
}Its records, from GET /v1/runs/{id}/records (the values are an illustration; the fields are the ones above):
{
"records": [
{
"app_id": "string",
"bundle_id": null,
"url": "string",
"title": "string",
"subtitle": null,
"description": null,
"developer": {},
"category": null,
"genres": [],
"rating": null,
"rating_count": null,
"price": null,
"free": null,
"in_app_purchases": null,
"content_rating": null,
"version": null,
"updated_at": null,
"whats_new": null,
"icon": null,
"screenshots": [],
"privacy_policy_url": null,
"requirements": null,
"devices": [],
"country": "string",
"language": null,
"fetched_at": "2026-01-01T00:00:00Z"
}
],
"next_cursor": null
}A run does not always end ok. Results and statuses lists every status and the reasons every scraper shares.