# App Store App Search API (https://www.socialcrawl.dev/platforms/app_store/app-search)

> Returns a unified AppList of Apple App Store apps matching a keyword — title, icon, rating, price/is_free, and store URL on every item, on the same canonical `App` shape used across every app marketplace (`app.store` = "app_store"). Detail-only fields (description, screenshots, developer) are null on search items; fetch /v1/app_store/app-info for the full record. Sourced from DataForSEO's task-based App Data API (first calls ~7-15s, then cached).

TL;DR: `GET /v1/app_store/app-search` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search keyword (e.g. 'photo editor'). |
| `country` | no | Storefront country as a DFS location name ('United States') or numeric location code ('2840'). Defaults to the US. |
| `language` | no | Language code (e.g. 'en'). Defaults to 'en'. |
| `depth` | no | Number of results to retrieve (default 100, rounded up to multiples of 100, max 300). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/app_store/app-search?query=photo%20editor" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search the Apple App Store with an API?

Send a GET request to /v1/app_store/app-search with a query parameter (e.g. query=photo editor). The response is a unified AppList — each item has the title, icon, rating, price, and the numeric app id you pass to app-info.

### What fields does App Store search return?

Each result includes the numeric app id, title, icon URL, average rating with count, price, a free flag, and store URL — enough to render a results grid or feed app ids into the app-info endpoint. Detail-only fields like description and screenshots are null on search items.

### How is app search different from the listings endpoint?

App search runs a live keyword query against the Apple App Store and returns ranked matches, like the store's own search box. The app-listings-search endpoint queries a paginated database by title with filters and a platform-wide total instead.

### How much does App Store app search cost?

App search runs on the advanced tier at 5 credits per call, since it fetches a fresh ranked result set from the Apple App Store. New accounts get 100 free credits with no card, and an empty result is refunded automatically.

### Can I search the App Store by country or language?

Yes. Optional country and language parameters set the storefront and locale, so you can search the same keyword across regions. Pass the numeric app id from any result into app-info or app-reviews to fetch deeper detail.

See the full App Store API: https://www.socialcrawl.dev/platforms/app_store

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to search the Apple App Store with an API
- What does the SocialCrawl App Store search API return?