What is the home storefront?
The home storefront isapp.country, and it comes from the URL you imported. A URL such as apps.apple.com/de/app/... imports a de home market, and the import dialog lets you override it. A bare iTunes id, or a URL with no country segment, falls back to DEFAULT_COUNTRY, which defaults to us.
Country codes are two lowercase letters, and each one must be a storefront of the app’s store. See Which codes are storefronts?
The home storefront drives everything that asobeast stores once per app.
A full per market app detail switcher is backlog, not a shipped feature.
How does one search serve everyone?
A position check searcheskeyword.country, not app.country. From that single search asobeast records positions for the primary app and for every competitor attached to it in that storefront.
That is why adding a competitor costs no extra store requests. Ten competitors on a keyword are still one search.
What does a market cost?
The same phrase tracked inus and in pl is two keyword rows, checked by two searches. Markets multiply, keywords multiply, and both draw on the same fixed request budget.
Rankings, difficulty and traffic all differ per storefront, so the second market is real data rather than a copy.
Two places show you the cost before it bites.
- The settings page carries a daily request budget card with the estimated requests broken down by kind, your capacity and a utilization meter.
GET /jobs/budgetreturns the same estimate, and the dashboard warns when the daily pipeline would exceed 85 percent of capacity.
SCRAPE_ITUNES_RPM and accept the risk. See The daily pipeline and rate limits.
How do you add a market?
On the keyword monitor, switch markets with the country filter, which shows the keyword count per market, then add keywords into the market you selected. A market with no keywords yet shows an empty state with an add button.Which codes are storefronts?
A home storefront and every keyword market must be a place where the app’s store operates. asobeast checks the code against the store before it reaches it, so a code that is not a storefront is refused at once instead of failing every job it would have queued.
The two lists differ, so the check is made per store.
pw is an App Store storefront that Google Play does not list, and 51 codes such as ad, bd and li are Google Play locations without an App Store storefront. Kosovo is xk in both stores.
The refusal names the store, for example zz is not an App Store storefront or pw is not a Google Play location. It applies to importing an app, adding keywords, reactivating a paused keyword, deep search, keyword suggestions and the market availability check. A store URL whose country segment or gl parameter names no storefront is refused the same way.
An upgrade pauses any keyword that was already tracked in a code that is not a storefront. Its history stays, and it stops producing failed jobs.