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.

App Store App Detail Endpoint

Look up one app and optionally include customer reviews.

Getting Started

Send your API key as a bearer token. Start with the smallest request below.

Look Up an App

Send the numeric app_id; appId and id are accepted aliases.

curl -X POST "https://api.datablue.dev/v1/data/app-store/app" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "app_id": "284882215",
  "country": "us"
}'
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": []
  }
}

Storefront

Choose a Storefront

Set country to the two-letter App Store country.

curl -X POST "https://api.datablue.dev/v1/data/app-store/app" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "app_id": "284882215",
  "country": "gb"
}'
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": []
  }
}

Reviews

Include Reviews

Set include_reviews, then choose review_sort and review_limit; limit is an alias.

curl -X POST "https://api.datablue.dev/v1/data/app-store/app" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "app_id": "284882215",
  "country": "us",
  "include_reviews": true,
  "review_sort": "mostHelpful",
  "review_limit": 20
}'
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": []
  }
}

Request Controls

Set Provider Timeout

Set timeout_ms from 3,000 to 60,000 milliseconds.

curl -X POST "https://api.datablue.dev/v1/data/app-store/app" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "app_id": "284882215",
  "timeout_ms": 30000
}'
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": []
  }
}

Response

Read normalized metadata from app; requested customer reviews appear in app.reviews.

Error Handling

Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.

Parameters

NameTypeRequirementDescription
app_id / appId / idstringRequiredNumeric App Store app ID.
countrystringOptionalTwo-letter App Store country code.
include_reviewsbooleanOptionalFetch recent App Store customer reviews.
review_sortstringOptionalReview sort: mostRecent or mostHelpful.
review_limit / limitnumberOptionalMaximum reviews to return (1-50).
timeout_msnumberOptionalProvider timeout in milliseconds (3000-60000).

Response fields

FieldTypeDescription
successbooleanWhether the request completed successfully.
appobjectApp metadata with app_id, app_name, developer, release notes, version, rating, genres, screenshots, file size, languages, and reviews when requested.
time_takennumberAPI 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": []
  }
}