Docs/App Store App Detail
Docs / API reference
POST/v1/data/app-store/app
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. |
| time_taken | number | API response time in seconds. |
Request and response
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
}'Example response
{
"success": true,
"source": "app_store",
"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": []
}
}