tools · catalog
23 callable contracts
tools/list, schema for schema.Keyword rank
App's position in App Store search results for a keyword (top 200), per storefront.›
Keyword suggestions
App Store search-autocomplete suggestions for a seed term, per storefront — the terms Apple itself suggests to users typing in the store, in suggestion order.›
Top apps for a keyword
Top-ranking apps for a keyword, per storefront: position, ratings, genre, and whether the keyword appears in the app's title.›
Keyword demand (Apple Search Ads popularity)
Keyword demand (popularity 0-100) plus competition count, per storefront.›
App lookup
Metadata for one app (by trackId) per storefront, including whether the app is available in that storefront at all.›
Find 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.›
ASO research bundle
One-call ASO research bundle for an app, per storefront: the current listing (title + web-scraped subtitle), its visible word pool, keyword candidates discovered from App Store autocomplete seeded with that pool (plus a…›
Metadata keyword coverage
Which search phrases a metadata draft can rank for, computed locally (no network).›
Recent customer reviews
Recent customer reviews for an app from Apple's public RSS feed, per storefront: rating distribution, average of the fetched reviews, and review texts (for mining user phrasing as keyword candidates).›
Top-chart positions
The app's position on the overall top-free, top-paid and top-grossing charts (top 100), per storefront.›
Modeled revenue estimate
Order-of-magnitude revenue estimate for an app, per storefront, MODELED from its public top-grossing chart rank (overall chart, falling back to the app's genre chart) — Apple publishes no revenue data for arbitrary apps…›
Manage tracked keywords
Manage this account's tracked set (the hosted replacement for the local track config file): every (app x keyword x storefront) combination is snapshotted by the daily managed run and on demand via the track tool.›
Track configured keywords
Snapshot ranks for every (app x keyword x storefront) in this account's tracked set (manage it with track_config) and report movement per combination.›
Rank history report
Read this account's server-side rank history (written by track and the daily managed run): one series per (keyword, app, storefront) with snapshot count, current/previous/best/worst rank and time range, plus the account…›
Apple's top search terms (weekly popularity)
Apple's own weekly App Store search-term popularity for a storefront, from the official Apple Ads API: the top terms by Apple's 1-100 popularity, optionally within one genre, with movement against an earlier week.›
Your plan, budget and capacity
This account's plan and remaining daily tool-call budget, tracked-set size against its cap, webhook and annotation state, and which data features this deployment serves.›
Rank-drop webhook
Push instead of poll: register one https URL and the daily managed run POSTs this account's rank drops there (JSON {event, accountId, sentAt, tracked, drops[]} where each drop carries appId, keyword, country, previous,…›
Mark the timeline
Timeline notes for this account, returned alongside history: record WHEN you changed metadata ("shipped new subtitle for US"), launched a campaign, or saw a review spike, so later rank movement reads as before/after ins…›
Connect App Store Connect
Connect this account's own App Store Connect API key so asc_listing and asc_update_listing can read and edit the real metadata of your apps.›
Read an app's App Store Connect listing
Read the real metadata of one of your own apps from App Store Connect: the hidden keyword field — the one thing public APIs never expose — plus name and subtitle per locale, promotional text, description and what's new,…›
Update an app's pending metadata
Write metadata for one locale of one of your own apps in App Store Connect.›
Request App Store analytics reports
Ask Apple to start generating daily analytics reports for one of your own apps — the one-time setup asc_analytics needs.›
Read an app's App Store funnel
The real acquisition funnel of one of your own apps from App Store Connect's analytics reports: impressions → product page views → taps → downloads (first-time + redownloads), per day, per source type (App Store search,…›