iTunes API lookup数据不同步，如何获取对应App Store实时应用信息？

Hey Terry, I’ve dealt with this exact frustration before—those regional sync lags in the iTunes Lookup API can be really annoying when you’re trying to verify a newly released app version. Let’s walk through why this happens and how you can get more accurate, real-time app info for your target App Store region.

Why the Delay Happens #

The iTunes Lookup API relies on global and regional App Store server caches. When you push a new version to App Store Connect, Apple needs to sync that update across all its regional App Store nodes. The default API request might hit a cached global endpoint or a regional node that hasn’t finished syncing yet, hence the outdated version data even after you’ve downloaded the new build.

Solutions to Get Real-Time Regional Data #

1. Add the country Parameter to Your API Request #

The biggest fix is to explicitly target the App Store region you care about using the country query parameter. This directs the API to pull data directly from that region’s server, which syncs updates much faster than the global cache.

For example, if you’re targeting the Chinese App Store, modify your URL to:

https://itunes.apple.com/lookup?id=xxxx&country=cn

Replace xxxx with your app’s Apple ID, and cn with the two-letter country code for your target region (e.g., us for the US, jp for Japan).

2. Force the Request to Ignore Caches #

Both client-side caches and CDN caches can hold onto old API responses. To bypass this, set a strict cache policy on your URL request to ensure you’re pulling fresh data every time.

Here’s how to update your function:

func getInfoFromAppStore(_ success: @escaping (_ json: [String: Any?]) -> Void) { 
    guard let url = URL(string: "https://itunes.apple.com/lookup?id=xxxx&country=cn") else { return } 
    var request = URLRequest(url: url)
    // Ignore local and remote caches to get fresh data
    request.cachePolicy = .reloadIgnoringLocalAndRemoteCacheData
    
    session.dataTask(with: request) { (data, urlResponse, error) in 
        guard let data = data, error == nil else { 
            print("Request error: \(error?.localizedDescription ?? "Unknown error")")
            return 
        } 
        do {
            let responseObject = try JSONSerialization.jsonObject(with: data, options: [.allowFragments]) 
            if let json = responseObject as? [String: Any?] { 
                success(json) 
            }
        } catch {
            print("JSON parsing error: \(error)")
        }
    }.resume() 
}

I also replaced the try? with a proper do-catch block here—it helps with debugging if you run into parsing issues later.

3. (For Developers) Use App Store Connect API (Optional) #

If you’re checking your own app’s version, the App Store Connect API provides more immediate status updates about your app’s release state. This requires authentication with an API key, but it can give you real-time info about whether your version has rolled out to specific regions. Keep in mind this is only useful for apps you own, not third-party apps.

Final Notes #

Even with these fixes, you might still see a few minutes of delay (since regional servers need time to fully sync), but it should cut down the 2-hour wait significantly. Make sure the country parameter matches the region where you downloaded the new app version—this ensures you’re comparing apples to apples.

内容的提问来源于stack exchange，提问作者Terry