--- title: Search for iOS apps framework: Apple Ads role: symbol role_heading: Web Service Endpoint platforms: [search ads 5.0+] path: apple_ads/search-for-ios-apps --- # Search for iOS apps Searches for iOS apps to promote in a campaign. ## URL GET https://api.searchads.apple.com/api/v5/search/apps ## Query Parameters limit: The number of items to return per request. The maximum is 1000. GET https://api.searchads.apple.com/api/v5/search/apps?limit=100 offset: The offset pagination that limits the number of records returned. The start of each page is offset by the number specified. You can apply offset to most API calls, but not all GET endpoints support it. GET https://api.searchads.apple.com/api/v5/search/apps?limit=&offset= query: The query for a list of iOS apps using a matching prefix. GET https://api.searchads.apple.com/api/v5/search/apps?query=Run%20Ke The query search pattern uses a prefix-matching algorithm. You can use spaces in search patterns. Prefixes require a minimum of three characters. If you’re sending a quoted search string, use HTML encoding. returnOwnedApps: The list of apps belonging to your organization. GET https://api.searchads.apple.com/api/v5/search/apps?query=appexample&returnOwnedApps=true ## Response Codes 200 OK: If the call succeeds, the API returns the AppInfo object in the response payload with an HTTP status code of 200(OK). If unsuccessful, the HTTP status code indicates the error with details in the error message. 400 Bad Request: An invalid query or missing required parameters. 401 Unauthorized: An unauthenticated call fails to get the requested response. 403 Forbidden: Insufficient rights to the resource. 404 Not Found: The API can’t locate the resource. 429 : The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API. 500 Internal Server Error: The Apple Ads server is temporarily down or unreachable. The request may be valid, but you need to retry it later. ## Discussion Discussion Use this endpoint to search for iOS apps that you can promote in a campaign. You can use query parameters to fetch data. For more information, see the Use Query Parameters section of Using Apple Ads API Functionality. An app search returns your adamId, which you can use in Create a Campaign in addition to the AppDownloaderCriteria in the TargetingDimensions payload. You can apply targeting dimensions to ad groups using Create an Ad Group or Update an Ad Group endpoints. Payload Example: Search for iOS apps