App Store Search

Search Apple App Store apps and return normalized app metadata including app ID, bundle ID, developer, price, rating, genres, icon, screenshots, and App Store URL.

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
term	string	Required	App search term.
country	string	Optional	Two-letter App Store country code.
limit	number	Optional	Maximum apps to return (1-200).
media	string	Optional	iTunes media filter.
entity	string	Optional	iTunes entity filter.
timeout_ms	number	Optional	Provider timeout in milliseconds (3000-60000).

Response fields

Field	Type	Description
success	boolean	Whether the request completed successfully.
apps	array	App rows with app_id, app_name, bundle_id, developer, description, price, rating, rating_count, genres, icon, screenshots, and app_url.
time_taken	number	API response time in seconds.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/app-store/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "term": "fitness tracker",
  "country": "us",
  "limit": 10
}'

Example response

{
  "success": true,
  "source": "app_store",
  "term": "fitness tracker",
  "country": "us",
  "total_results": 2,
  "time_taken": 0.61,
  "apps": [
    {
      "position": 1,
      "app_id": "123456789",
      "app_name": "Fitness Tracker",
      "bundle_id": "com.example.fitness",
      "developer": "Example Inc.",
      "price": 0,
      "currency": "USD",
      "rating": 4.7,
      "rating_count": 18234,
      "primary_genre": "Health & Fitness",
      "app_url": "https://apps.apple.com/us/app/example/id123456789"
    }
  ]
}