--- title: Search for Apps framework: Apple Ads Platform API role: symbol role_heading: Web Service Endpoint platforms: [apple ads platform api 1.0+] path: apple-ads-platform-api/searches-for-a-list-of-apps --- # Search for Apps Search the App Store for apps matching the supplied criteria and return app details. ## URL GET https://api.ads.apple.com/v1/search/apps ## Query Parameters query: Free-text search matched against app name and developer name. Must contain at least one alphanumeric character and a minimum of 3 characters (2 for CJK languages). returnOwnedApps: Flag that returns apps owned by the caller’s organization when set to true. Can be combined with query and cpids, or used on its own. Defaults to false. cpids: Comma-separated list of iTunes content provider identifiers. Scopes the search to apps owned by those providers. storeFronts: One or more App Store country or region codes (ISO 3166-1 alpha-2). Repeat the parameter for multiple values. All values must be enabled App Store countries or regions, or the call returns INVALID_COUNTRY_CODE. offset: Pagination offset for results. Defaults to 0. limit: Maximum number of results to return. Defaults to 20, capped at the service-side maximum (MAXLIMIT). ## Header Parameters X-Ap-Context: ## Response Codes 200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error: ## Query Parameters Query Parameters Discussion This endpoint searches the App Store for apps by name, content provider, or returns apps owned by the caller’s organization. It’s useful for discovering apps to target or advertise before building campaigns. You must supply at least one of query, cpids, or returnOwnedApps=true. The API rejects calls that supply none of these with INVALID_INPUT. The returned adamId is the primary identifier used in campaign promotedObject and creative destination fields. Payload Examples ## See Also - [Get App Details by Adam ID](apple-ads-platform-api/get-app-details-by-adam-id.md) - [Query Supported App Languages](apple-ads-platform-api/query-supported-app-languages.md)