{"uid":"cap_tpvMPELn-TYq9IVa88Rsh","slug":"apple-app-store-search-api-347b0254","name":"Apple App Store Search API","description":"Apple App Store search — find iOS apps by term and get id, developer, price, rating, genres, description, size, icon & screenshots as clean JSON.","url":"https://appstore.use.x402atlas.com/search","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":["term"],"properties":{"num":{"type":"integer","default":10,"maximum":200,"minimum":1,"description":"Optional results per page, 1–200 (default 10)"},"lang":{"type":"string","maxLength":12,"description":"Optional language code (e.g. en-us)"},"page":{"type":"integer","minimum":1,"description":"Optional page number"},"term":{"type":"string","maxLength":200,"description":"App Store search query (app name, category, or keyword)"},"country":{"type":"string","maxLength":2,"description":"Optional two-letter store country (e.g. us, gb)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["term","queried_at","results"],"properties":{"term":{"type":"string","description":"Echoed search term"},"results":{"type":"array","items":{"type":"object","required":["title"],"properties":{"id":{"type":"integer","description":"App Store app id"},"link":{"type":"string"},"logos":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string"},"size":{"type":"string"}}}},"price":{"type":"object","properties":{"type":{"type":"string"},"amount":{"type":"number"},"symbol":{"type":"string"},"currency":{"type":"string"}}},"title":{"type":"string"},"genres":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"primary":{"type":"boolean"}}}},"rating":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"count":{"type":"integer"},"rating":{"type":"number"}}}},"version":{"type":"string"},"position":{"type":"integer"},"bundle_id":{"type":"string"},"developer":{"type":"object","properties":{"id":{"type":"integer"},"link":{"type":"string"},"name":{"type":"string"}}},"age_rating":{"type":"string"},"description":{"type":"string"},"screenshots":{"type":"object","description":"Screenshot media grouped by device family (e.g. iphone, ipad)","additionalProperties":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string"},"size":{"type":"string"}}}}},"release_note":{"type":"string"},"size_in_bytes":{"type":"integer"},"minimum_os_version":{"type":"string"}}}},"queried_at":{"type":"string","format":"date-time"}}}}}}},"responseSchema":{"type":"json","example":{"term":"weather","results":[{"id":1069513131,"price":{"type":"Free"},"title":"CARROT Weather: Alerts & Radar","rating":[{"type":"App Store","count":51000,"rating":4.8}],"position":1,"bundle_id":"com.grailr.CARROTWeather","developer":{"name":"Grailr LLC"}}],"queried_at":"2026-07-11T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ygmzDC5xwKnE7HwScLL1Z","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search the Apple App Store by keyword and retrieve app metadata including id, developer, price, rating, genres, description, size, icon, and screenshots as JSON.","exampleAgentPrompt":"Search the Apple App Store for 'meditation' apps and give me the top 5 results from the US store — include their ratings, prices, and developer names.","exampleUseCases":null,"resultDescription":"A JSON object containing the echoed search term, query timestamp, and an array of app results each with app id, title, bundle id, developer info, price (amount, currency, type), rating(s) with count, genres (with primary flag), version, app store link, icon/logo URLs, screenshots, and result position.","failureModes":["Missing required 'term' parameter returns a 400 error","Invalid country code may return empty results or default to a fallback store","Requesting more than 200 results per page is rejected","App Store may return fewer results than requested for niche queries","Payment failure (insufficient USDC balance) blocks the request","Rate limiting or network issues from the upstream App Store API"],"whenToPreferThis":"Use this endpoint when you need to search the Apple App Store by keyword and receive structured JSON metadata for multiple apps — ideal for app discovery, competitive research, or populating a UI with app listings. Prefer this over the sibling product-detail endpoint when you don't yet know the specific app ID and need to search by name, category, or keyword. Supports pagination and multi-country/language queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:30:24.288Z","isFirstParty":false}