{"uid":"cap_2QHa-JENLGEKBgnPv2qDS","slug":"mac-app-store-lookup-by-app-id-30b4b5b9","name":"Mac App Store Lookup by App ID","description":"Mac App Store app metadata from Apple's public iTunes Lookup API by App Store id: name, seller, version, price, average rating and rating count (0 when Apple shows none), genre and store link. Mac apps only.","url":"https://api.fadeandco.workers.dev/api/dev/mac-app-store?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Mac App Store track id, digits only, e.g. 497799835 (Xcode)"},"country":{"type":"string","description":"Two-letter store country code (default us)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"id":497799835,"name":"Xcode","genre":"Developer Tools","price":0,"seller":"Apple Inc.","source":"https://itunes.apple.com/lookup?id=497799835&country=us&entity=macSoftware","country":"us","version":"27.1","currency":"USD","storeUrl":"https://apps.apple.com/us/app/xcode/id497799835?mt=12&uo=4","checkedAt":"2026-10-23T09:35:51.302Z","ratingCount":0,"releaseDate":"2026-10-15T20:22:08Z","averageRating":0}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Q9Yxq16FHom2PZzHFHFta","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches Mac App Store metadata (name, seller, version, price, rating, genre, store link) for a given Mac app by its iTunes track ID.","exampleAgentPrompt":"What's the current version, price, and rating of Xcode (App Store ID 497799835) on the Mac App Store?","exampleUseCases":[{"title":"Check latest Xcode version","prompt":"Look up Xcode on the Mac App Store using ID 497799835 and tell me the current version number and when it was last released."},{"title":"Verify Mac app pricing","prompt":"Can you check the Mac App Store listing for app ID 1444383602 and tell me whether it's free or paid, and what the average rating is?"},{"title":"Enrich software directory with App Store data","prompt":"I have a list of Mac apps — can you pull the name, seller, genre, and store URL for the app with Mac App Store ID 1333542190 so I can add it to my software catalog?"}],"resultDescription":"A JSON object containing the app's numeric ID, name, genre, price, currency, seller name, version, release date, average rating, rating count, store URL, the iTunes source URL used, country code, and the timestamp when the data was checked.","failureModes":["Invalid or non-Mac App Store track ID returns no results or an error","Non-numeric ID format causes a validation error","App exists on iOS but not Mac App Store returns empty or mismatched data","Rating count and average rating return 0 when Apple has not published ratings for the app","Invalid country code may return no results or default to US store","Network timeout if Apple's iTunes Lookup API is temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need structured Mac App Store metadata for a specific app by its iTunes track ID, especially when you want version, pricing, seller, and rating data in a single call without scraping the App Store yourself. Prefer this over general web search when you need machine-readable, consistently structured output. Note this is Mac apps only — use the sibling Google Play endpoint for Android apps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:15.021Z","isFirstParty":false,"canonicalSlug":"mac-app-store-lookup-by-app-id-30b4b5b9"}