Why Is My New iOS App Not Showing Up When I Search for It on the App Store? (8 Developer Checks)

Checks 1 & 2: Is your app visible in Apple’s `lookup` endpoint yet?

When an app transitions to READY_FOR_SALE (or READY_FOR_DISTRIBUTION), Apple updates two separate backend systems on different schedules:

• Check 1 — The Store Lookup Database (`itunes.apple.com/lookup?id=YOUR_ID&country=us`): Usually populates within 1 to 4 hours of release. You can verify this immediately in terminal or by pasting your App Store link into Searchbop ([`lookupStoreApp()`](file:///Users/tarik/Desktop/TengrX-SEO/packages/core/src/aso/itunes.ts#L79-L96)). If `lookup` returns `"resultCount": 0`, your binary is still propagating to Apple’s edge servers. Wait 2 to 6 hours.
• Check 2 — The Full-Text Search Index (`itunes.apple.com/search?term=...`): Even after your direct App Store URL works, Apple’s search index takes 6 to 24 hours on a brand-new `1.0` launch to index your Title, Subtitle, and 100-byte Keyword field across all regional storefronts.

# 1. Check if Apple's Store Lookup API sees your app ID in the US store:
curl -s "https://itunes.apple.com/lookup?id=YOUR_NUMERIC_APP_ID&country=us" | grep -o '"trackName":"[^"]*"'

# 2. Check if Apple's Search API returns your app for your exact title + developer name:
curl -s "https://itunes.apple.com/search?entity=software&country=us&limit=50&term=YOUR_EXACT_APP_TITLE" | grep -o '"trackId":[0-9]*'

Checks 3 & 4: Why Apple autocorrects invented startup names

What if 24 hours have passed, `lookup` returns your app, and searching your exact brand name still shows zero results—or shows apps for a completely different word?

• Check 3 — Invented Brand Name Autocorrect: Suppose you named your app Calndr or Notez. Because your new app has zero historical search volume, Apple’s search parser assumes the user made a typo and silently rewrites the query to Calendar or Notes—dumping your brand-new app into a category SERP with 100,000-rating incumbents. Fix: Always pair your coined brand name with a clear, high-intent descriptive phrase in your 30-character Title (`Calndr: Shared Family Schedule`) so users searching `Calndr family schedule` bypass spellcheck rewrite.
• Check 4 — Storefront Country & Device Compatibility: Verify under Pricing and Availability in App Store Connect that the country your personal Apple ID belongs to is actually checked. Also verify that you did not accidentally build your binary with `UIDeviceFamily` restricted to iPad-only or require a minimum iOS version higher than the test device you are searching from.

Checks 5 & 6: Did your keyword changes actually ship with a released version?

If your app shows up for its brand name, why doesn’t it appear for any of the keywords you typed into App Store Connect?

Checks 7 & 8: Indexed at #180 vs. unindexed

Most of the time, when a developer says “my app isn’t showing up for my keywords,” the app is indexed—it is simply sitting at position `#145` or `#250+` because the chosen keywords have a **Difficulty score of 75 to 95**.

• Check 7 — Top-200 Rank Check: Paste your App Store URL into Searchbop. Searchbop queries the top 200 results (`limit=200`) for every keyword in your list. If you rank `#84`, your indexing works fine—you are in a competitive fight.
• Check 8 — Long-Tail Combination Test: Search the App Store for a 4-word combination combining two words from your Title and two words from your 100-byte Keyword field. If your app appears in the top 10 for that 4-word combination, Apple has indexed your metadata. Now your job is replacing overly broad head terms (`Difficulty > 70`) with winnable 2-to-3-word phrases (`Difficulty < 40`, `Popularity >= 20`).