Acme. It returns each matching listing with its name, its store and a direct link, so you can review apps that use the brand.
In the API reference these endpoints sit under the App Store Search tag. In the dashboard the source is Search by Source → App Store Monitoring.
The flow is asynchronous: start a search, poll it until it finishes, then read the listings.
Availability and cost
Availability: the App Store Impersonation plan feature. Not every plan includes it. Manage → Buy more in the dashboard lists the features your plan includes. Plans and quotas explains how plan features work. Cost: no metered allowance. Calls count toward your organization’s per-second rate limit, and every2xx response to an API-key request uses one unit of your monthly API Calls allowance. A non-2xx response is refunded.
Without the feature, or when your license is not active, the four search endpoints (create_, get_, list_ and delete_store_search_request) return 403:
429 or the capacity 409. A 429 with "message": "Rate limit exceeded" comes from the rate limit or the API Calls allowance. Rate limits explains both.
What a search matches
A search looks for the term in four places, one after another:- Google Play’s app search, then a web search of
play.google.com/store/apps. - The Apple App Store’s app search, then a web search of
apps.apple.com.
- Send the brand as people would see it. The term is matched as plain text, with no operators or wildcards.
Acmematches “Acme Wallet” and “ACME Rewards”.acme.commatches only listings that containacme.comitself. - A search runs once. It does not refresh. Start a new search to pick up listings published since, or create a monitor.
Run a search
1
Start the search
create_store_search_request takes one field, search_term: required, 1 to 255 characters.201 with the search:id. is_monitoring, alert_cycle, is_email, is_reporting and report_id are scheduling fields that a search you start here leaves at their defaults.2
Poll until it finishes
Fetch the search with
get_store_search_request until status is finished.status takes two values:in_progress: still running.finished: done. Read the listings.
finished, with fewer listings or none. Poll every 10 seconds or slower: each successful poll uses an API call.3
Read the listings
list_store_search_result returns the listings of one search. Pass the search id as searchrequest.There is no filter or sort parameter. Listings come ordered by
updated_at, newest first, with listings that have no updated_at at the top.What comes back
count: listings the search found, across all pages.next/previous:nullat either end. The URLs point at the internal search service, not atclient-api.leak.center, so don’t call them. Raisepageuntilnextisnull.
Manage searches and listings
list_store_search_requestlists your organization’s searches, newest first.page_sizedefaults to20, max100.orderingtakescreate_date,-create_date,update_dateor-update_date.delete_store_search_resultremoves one listing from a search and returns204.delete_store_search_requestremoves a search and all of its listings and returns204.
Watch the brand continuously
A search runs once. To re-run a brand on a schedule and receive only new listings, create a monitor on thestore source. See Create a monitoring rule. A monitor on this source needs the same App Store Impersonation plan feature.
Quick search also runs this source for domain and brand searches. It searches a domain without its top-level domain, so acme.com is searched as acme. On a plan without the feature, quick search reports this source as not_entitled.
To find look-alike domains rather than apps, see Domain monitoring.
Errors
Errors lists every error the API returns.