tools / find_app
find_app
read-onlyFind an app's trackId
Resolve an app name or bundle id to App Store trackIds, per storefront — the id every other tool takes as appId. A reverse-DNS bundle id (com.example.app) is looked up exactly; anything else runs a storefront search and returns the top matches in the order users would see them, so the first result is almost always the intended app (check developer and ratings when names collide). One request per storefront.
input
query *
string
App name (e.g. "Instagram") or bundle id (e.g. "com.burbn.instagram")
countries
string[]
2-letter storefront codes, e.g. ["US", "GB", "JP"]. Each storefront is queried separately; at most 25 per call.(default ["US"])
limit
integer
Max matches per storefront for name searches(default 5)
example call
tools/call → find_app
{ "name": "find_app", "arguments": { "query": "…" } }
output
query *
string
storefronts *
object[]
country *
string
matchedBy *
"bundleId" | "search"
exact bundle-id lookup, or storefront search in user-visible order
apps *
object[]
trackId *
integer
use as appId everywhere else
name *
string
bundleId *
string | null
developer *
string | null
genre *
string | null
rating *
number | null
ratings *
integer
price *
string | null
url *
string | null