App Store App Detail

Lookup one Apple App Store app by app ID. Optionally includes recent reviews with sort and limit controls.

Execution Model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit Weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

Parameters

Name	Type	Requirement	Description
app_id / appId / id	string	REQUIRED	Numeric App Store app ID.
country	string	optional	Two-letter App Store country code.
include_reviews	boolean	optional	Fetch recent App Store customer reviews.
review_sort	string	optional	Review sort: mostRecent or mostHelpful.
review_limit / limit	number	optional	Maximum reviews to return (1-50).
timeout_ms	number	optional	Provider timeout in milliseconds (3000-60000).

Response Fields

Field	Type	Description
success	boolean	Whether the request completed successfully.
app	object	App metadata with app_id, app_name, developer, release notes, version, rating, genres, screenshots, file size, languages, and reviews when requested.
lookup_url / reviews_url	string	Provider URLs used.
time_taken	number	API response time in seconds.

cURL Example

curl -X POST "https://api.datablue.dev/v1/data/app-store/app" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "appId": "284882215",
  "country": "us",
  "include_reviews": true,
  "review_limit": 5
}'

System Responses

200 OK

Request processed successfully.

401 UNAUTHORIZED

Missing or invalid API key.

429 RATE LIMIT

System capacity exceeded.

500 SYSTEM FAILURE

Internal core exception.

EXAMPLE RESPONSE

{
  "success": true,
  "source": "app_store",
  "runtime": "http",
  "app_id": "284882215",
  "country": "us",
  "time_taken": 0.74,
  "app": {
    "app_id": "284882215",
    "app_name": "Facebook",
    "bundle_id": "com.facebook.Facebook",
    "developer": "Meta Platforms, Inc.",
    "price": 0,
    "currency": "USD",
    "rating": 4.2,
    "rating_count": 1000000,
    "primary_genre": "Social Networking",
    "reviews": []
  }
}