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.
search_url	string	iTunes Search API URL used.
time_taken	number	API response time in seconds.

cURL Example

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
}'

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",
  "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"
    }
  ]
}