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

> Searches DataForSEO's real-time, filterable Apple App Store listings database by app title (and/or description) and returns a unified AppList. Unlike the store-chart endpoints this one is the ONE true paginator — page with `limit` (≤50) + `offset` (then `offset_token` for deeper) and read the platform-wide `total`. Premium-tier because the upstream bills per returned item. Sourced from DataForSEO's synchronous live App Data database.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `title` | yes | App title to search for (e.g. 'photo editor'). |
| `description` | no | Optional app-description text to match. |
| `limit` | no | Apps per page (1–50, default 20). |
| `offset` | no | Pagination offset (up to 10,000; use offset_token beyond). |
| `offset_token` | no | Opaque deep-pagination cursor from a prior response. |
| `filters` | no | Advanced DataForSEO filter expression as a JSON array. |
| `country` | no | Storefront country as a DFS location name or numeric code. Defaults to the US. |
| `language` | no | Language code (e.g. 'en'). Defaults to 'en'. |

## Code example

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

## FAQ

### How do I query the App Store listings database via API?

Send a GET request to /v1/app_store/app-listings-search with a title plus optional filters. Unlike live app search, this hits a real-time, paginated listings database and returns a platform-wide total alongside the matching iOS apps.

### What makes app-listings-search different from app search?

App search runs a live keyword query and returns ranked store results. App-listings-search searches a database by title with limit and offset pagination, filters, and a total match count — built for bulk analysis and dataset building rather than store-style lookup.

### What does the platform-wide total give me?

Each response includes the total number of matching listings across the database, not just the current page. That total lets you size a result set, paginate confidently, and report how many iOS apps match a filter — unusual for a developer API.

### How much does the App Store listings endpoint cost?

App-listings-search runs on the premium tier at 10 credits per call, reflecting the per-item paginated database query behind it. New accounts get 100 free credits with no card, and an empty result is refunded automatically.

### Can I paginate and filter the listings?

Yes. Use limit (up to 50) and offset to page through the result set, then offset_token for deeper pages, and filters to narrow listings first. Each listing carries its numeric app id, so you can hand results straight to app-info or app-reviews.

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 query a paginated Apple App Store listings database via API
- How does the SocialCrawl App Store listings API return a platform-wide total?