| Search any of 115 country stores in Apple's own ranking order, or look up apps by ID, bundle ID, developer, or URL, and get 45+ fields per app, with up to 5,000 reviews per app (4 sort orders, developer replies included) and about 60 "You Might Also Like" apps. |
photo editor. Results come in Apple's own ranking order, up to about 250 apps per keyword.
## `startUrls` (type: `array`):
Add App Store app pages (apps.apple.com/us/app/instagram/id389801252) or developer pages (apps.apple.com/us/developer/meta-platforms-inc/id284882218). The store country in the URL is used for that lookup.
## `appIds` (type: `array`):
Add numeric App Store IDs, the digits after id in an app URL (e.g. 389801252 for Instagram).
## `bundleIds` (type: `array`):
Add bundle identifiers, e.g. com.burbn.instagram.
## `developerIds` (type: `array`):
Add numeric developer IDs (the digits after id in a developer URL). Returns every app the developer publishes in the chosen store (up to 200 per developer).
## `mode` (type: `string`):
Optional. Search uses only the keyword; Lookup uses only IDs and URLs. Leave empty to run everything you entered.
## `country` (type: `string`):
App Store storefront to read prices, rankings, ratings and reviews from.
## `lang` (type: `string`):
Optional language for app names, descriptions and genres, e.g. en, es, fr-CA or pt-BR. Works when the store offers that language; otherwise the store's default language is used.
## `page` (type: `integer`):
Search results page to start from. Each page holds up to 50 apps.
## `endPage` (type: `integer`):
Last search results page to request. When reviews are on, it also caps the number of review pages per app (20 reviews per page). Leave empty to page until results run out or Max apps is reached.
## `maxItems` (type: `integer`):
Maximum number of apps to save in this run (across search and lookups). Leave empty for no limit.
## `includeReviews` (type: `boolean`):
Fetch customer reviews for every app and attach them in the reviews array. Billed per page of 20 reviews.
## `reviewsSort` (type: `string`):
Order of the reviews. Only used when Include reviews is on.
## `includeSimilarApps` (type: `boolean`):
Fetch the app's "You Might Also Like" list and attach it in the similarApps array.
## `customMapFunction` (type: `string`):
Optional JavaScript function applied to each app before it is saved, e.g. (app) => ({ name: app.trackName, rating: app.averageUserRating }). It must be a plain synchronous function that returns an object. Functions containing new Date, Date.now or 1970 are rejected. If it fails, the original item is saved.
## `outputConnector` (type: `string`):
Optional MCP connector to deliver the results to. Authorize it first in Apify Console → Settings → API & Integrations → MCP connectors.
## `deliverTarget` (type: `string`):
URL or ID of where the connector writes. Notion: a page URL (a typed database is created for you) or an existing database URL. Todoist: a project URL or ID. Some services need none.
## `deliverMode` (type: `string`):
perPost writes one record per app; summary writes a single roll-up for the run.
## `deliverMaxItems` (type: `integer`):
Optional cap on how many records perPost delivers (ignored in summary mode).
## Actor input object example
```json
{
"term": "photo editor",
"country": "us",
"page": 1,
"endPage": 1,
"maxItems": 20,
"includeReviews": false,
"reviewsSort": "mostRecent",
"includeSimilarApps": false,
"deliverMode": "perPost"
}
```
# Actor output Schema
## `dataset` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '