{"openapi":"3.1.0","info":{"title":"API.SH: App Store","version":"1.0.0","description":"The App Store API from API.SH: public App Store data as clean JSON. Every endpoint is a GET with query parameters and your key in the x-api-key header. Calls that run cost the credits shown (x-credits): successes, and lookups that found nothing (404). Refused calls and errors on our side are free. Docs: https://api.sh/docs · Every platform: https://api.sh/openapi.json","contact":{"name":"API.SH support","email":"support@api.sh","url":"https://api.sh/contact"},"termsOfService":"https://api.sh/legal/terms"},"servers":[{"url":"https://api.api.sh"}],"security":[{"apiKey":[]}],"tags":[{"name":"Account","description":"Your balance, usage, logs and past responses. Free."},{"name":"App Store","description":"8 endpoints (search & seo)","x-slug":"app-store","x-domains":["apps.apple.com"]}],"paths":{"/v1/account":{"get":{"operationId":"getAccount","tags":["Account"],"summary":"Balance, plan, spend and spend limits","description":"Credits by bucket (free monthly, plan, pay-as-you-go), the plan, credits spent today and this month (UTC), your spend limits and the key used. Free: costs no credits.","responses":{"200":{"description":"Account","content":{"application/json":{"example":{"success":true,"account":{"id":"8f0c…","status":"active","unlimited":false},"credits":{"total":41250,"free":100,"plan":0,"payg":41150,"free_resets_at":"2026-11-01T00:00:00Z"},"plan":null,"spend":{"today":120,"this_month":3400,"daily_limit":5000,"monthly_limit":null,"period":"UTC"},"key":{"id":"…","name":"production","prefix":"ash_li","created_at":"2026-10-01T00:00:00Z"}}}}},"401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/account/usage":{"get":{"operationId":"getAccountUsage","tags":["Account"],"summary":"Usage per day and per endpoint","description":"Calls, errors and credits per UTC day, and the top endpoints by credits. Free. Add output=csv for the daily rows as CSV.","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":90,"default":30}},{"$ref":"#/components/parameters/output"}],"responses":{"200":{"description":"Usage","content":{"application/json":{"schema":{"type":"object"}},"text/csv":{"schema":{"type":"string"}}}},"401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/account/logs":{"get":{"operationId":"listAccountLogs","tags":["Account"],"summary":"Your calls of the last 30 days","description":"Newest first. Filter by status, route prefix, key or time; page with `before` (the `next` value). Add output=csv|ndjson to download (up to 5,000 rows per request; the next cursor is in the x-next-cursor header). Free.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"status","in":"query","required":false,"description":"ok, error, or an HTTP status like 502.","schema":{"type":"string"}},{"name":"route","in":"query","required":false,"description":"Route prefix, e.g. /tiktok/v1","schema":{"type":"string"}},{"name":"key","in":"query","required":false,"description":"Only calls made with this key id.","schema":{"type":"string","format":"uuid"}},{"name":"since","in":"query","required":false,"description":"ISO time.","schema":{"type":"string","format":"date-time"}},{"name":"before","in":"query","required":false,"description":"Cursor from `next`.","schema":{"type":"string"}},{"$ref":"#/components/parameters/output"}],"responses":{"200":{"description":"Calls","content":{"application/json":{"schema":{"type":"object"}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/results/{request_id}":{"get":{"operationId":"getResult","tags":["Account"],"summary":"Fetch a past response again, free","description":"The exact response a call returned, for 30 days after the call, at no cost. Use the call's x-request-id. Supports output=csv|ndjson.","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The stored response (headers: x-refetch: 1, x-original-time, x-original-route).","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found, or not public. A lookup that ran costs the endpoint's price (credits_used says); an unknown route is free.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Older than 30 days.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/app-store/v1/charts":{"get":{"operationId":"appStoreCharts","summary":"App Store charts","description":"Apples top charts: top free/paid/grossing and new apps for iPhone, iPad or Mac, overall or for one genre, up to 200. Every response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/app-store-charts","tags":["App Store"],"x-credits":1,"parameters":[{"name":"chart","in":"query","required":false,"description":"top-free (default), top-paid, top-grossing, top-free-ipad, top-paid-ipad, top-grossing-ipad, new, new-free, new-paid, top-free-mac, top-paid-mac, top-grossing-mac.","schema":{"type":"string"},"example":"top-free"},{"name":"country","in":"query","required":false,"description":"e.g. us.","schema":{"type":"string"}},{"name":"genre","in":"query","required":false,"description":"App Store genre id, e.g. 6014 (Games).","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1-200 (default 100).","schema":{"type":"integer"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"chart":"top-free","country":"us","genre":null,"count":100,"updated":"2026-11-03T21:39:41-07:00","apps":[{"rank":1,"app_id":"6741796873","bundle_id":"com.ss.iphone.ugc.tiktok.pro","name":"TikTok Pro - Events","developer":"TikTok Ltd.","developer_url":"https://apps.apple.com/us/developer/tiktok-ltd/id1322881000?uo=2","price":"0.00","currency":"USD","category":"Entertainment","category_id":"6016","released":"2026-06-03T00:00:00-07:00","summary":"TikTok Pro - Events is a global discovery platform for videos where you can discover cool, funny, and educational short videos, as well as s…","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/c7/e0/05/c7e00539-f686-7de1-776b-2389d4f8d3af/AppIcon_TikTok-0-0-1x_U007emarketing-0-8…","url":"https://apps.apple.com/us/app/tiktok-pro-events/id6741796873?uo=2"},{"rank":2,"app_id":"284862083","bundle_id":"com.nytimes.NYTimes","name":"NYTimes: US and World News","developer":"The New York Times Company","developer_url":"https://apps.apple.com/us/developer/the-new-york-times-company/id284862086?uo=2","price":"0.00","currency":"USD","category":"News","category_id":"6009","released":"2019-01-31T00:00:00-07:00","summary":"Discover original reporting and understand the events shaping the world in The New York Times app. Follow breaking news and get live updates…","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/1f/85/a4/1f85a424-868d-7dcb-5d8b-9bf0c0207e39/Release-0-0-1x_U007epad-0-1-0-85-220.png…","url":"https://apps.apple.com/us/app/nytimes-us-and-world-news/id284862083?uo=2"},"… 98 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/app-store/v1/developer":{"get":{"operationId":"appStoreDeveloper","summary":"App Store developer apps","description":"Every app of an App Store developer (Apples Lookup API), by developer id or developer page URL. Every response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/app-store-developer","tags":["App Store"],"x-credits":1,"parameters":[{"name":"id","in":"query","required":true,"description":"Developer (artist) id or developer page URL.","schema":{"type":"string"},"example":"284882218"},{"name":"country","in":"query","required":false,"description":"e.g. us.","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"developer_id":"284882218","name":"Meta Platforms, Inc.","url":"https://apps.apple.com/us/developer/meta-platforms-inc/id284882218?uo=4","country":"us","count":16,"apps":[{"app_id":284882215,"bundle_id":"com.facebook.Facebook","name":"Facebook","developer":"Meta Platforms, Inc.","developer_id":284882218,"price":0,"currency":"USD","formatted_price":"Free","rating":4.52665,"ratings":29025931,"genre":"Social Networking","genres":["Social Networking"],"version":"585.0.0","released":"2019-02-05T08:00:00Z","updated":"2026-10-28T14:06:51Z","size_bytes":536087552,"content_rating":"12+","minimum_os":"15.1","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/77/5b/7b/775b7b40-4e22-ba5e-2255-668c2473048c/Icon-Production-0-0-1x_U007epad-0-1-0-sR…","url":"https://apps.apple.com/us/app/facebook/id284882215?uo=4","description":"Where real people propel your curiosity. Whether you’re thrifting gear, showing reels to that group who gets it, or sharing laughs over fun …","release_notes":"Our teams have solved many crashes, fixed issues you’ve reported and made the app faster.","screenshots":["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/4e/ef/b5/4eefb5b1-7289-7b88-9614-e3e259408334/f254967c-6ef9-4cc6-b4bf-e89cf01633…","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/af/c7/fc/afc7fcd3-26e8-3fe8-b058-de223e847969/c795c58d-ec37-463c-9ab9-ba0b8bc00d…","… 8 more"],"ipad_screenshots":["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/2d/d9/a0/2dd9a035-19ab-c666-6227-75a7727d9abd/iPad2-Marketplace.png/576x768bb.pn…","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/72/ab/1e/72ab1e12-0ae0-7b12-1a57-0e963b3fe2ef/iPad2-Feed.png/576x768bb.png","… 2 more"],"languages":["AR","HR","… 30 more"],"seller":"Meta Platforms, Inc.","seller_url":"http://www.facebook.com/mobile"},{"app_id":454638411,"bundle_id":"com.facebook.Messenger","name":"Messenger","developer":"Meta Platforms, Inc.","developer_id":284882218,"price":0,"currency":"USD","formatted_price":"Free","rating":4.66166,"ratings":13936965,"genre":"Social Networking","genres":["Social Networking","Productivity"],"version":"585.0.0","released":"2011-08-09T19:49:28Z","updated":"2026-10-27T21:03:24Z","size_bytes":290678784,"content_rating":"12+","minimum_os":"15.1","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/49/bf/d5/49bfd562-f165-a59c-c82d-49d20cd98931/AppIcon-0-0-1x_U007epad-0-1-0-sRGB-85-22…","url":"https://apps.apple.com/us/app/messenger/id454638411?uo=4","description":"Messenger is a free messaging app that helps you connect with anyone, anywhere. Stay in touch with your friends and family, explore your int…","release_notes":"We update our app regularly to make it even better for you to easily connect to the people that matter. Update to the latest version to get …","screenshots":["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/90/cd/bd/90cdbdf8-1c5e-e760-56c8-dfc19dc25715/messenger_appstore_iphone_1320x286…","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/b4/dc/8c/b4dc8ce4-cb5d-9a8c-7177-e4e0a8d45153/messenger_appstore_iphone_1320x286…","… 6 more"],"ipad_screenshots":["https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/3e/a5/50/3ea550d2-bff3-d09e-5459-c341c7c4e6a4/7f6fd0a2-ee06-4b01-b04a-d9fec7b1c6de_iPa…","https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/9e/8a/d8/9e8ad888-2abe-c2cd-12db-fad2878e8208/c937f0f4-9f1f-4b81-8186-ea5d90618f1f_iPa…"],"languages":["HR","CS","… 27 more"],"seller":"Meta Platforms, Inc.","seller_url":"http://www.facebook.com/mobile/messenger"},"… 14 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/app-store/v1/lookup":{"get":{"operationId":"appStoreLookup","summary":"App Store app details","description":"One app (by app_id or bundle_id) or up to 100 apps at once (`ids`) from the App Store, in Apple's own result fields (resultCount, results). With `include=in_app_purchases` (one app; one more page read) also `in_app_purchases`: the in-app purchase names and prices the app's store page lists for that country.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/app-store-lookup","tags":["App Store"],"x-credits":1,"parameters":[{"name":"app_id","in":"query","required":false,"description":"App Store id (or use bundle_id).","schema":{"type":"string"},"example":"389801252"},{"name":"bundle_id","in":"query","required":false,"description":"e.g. com.burbn.instagram.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"e.g. us.","schema":{"type":"string"}},{"name":"ids","in":"query","required":false,"description":"Up to 100 comma-separated App Store ids in one call (instead of app_id).","schema":{"type":"string"}},{"name":"include","in":"query","required":false,"description":"in_app_purchases: add the in-app purchase list (name, price) of one app.","schema":{"type":"string","enum":["in_app_purchases"]}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"resultCount":1,"results":[{"advisories":["Infrequent/Mild Profanity or Crude Humor","Infrequent/Mild Mature/Suggestive Themes","… 2 more"],"isGameCenterEnabled":false,"features":["iosUniversal"],"supportedDevices":["iPhone5s-iPhone5s","iPadAir-iPadAir","… 128 more"],"kind":"software","screenshotUrls":["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/40/d2/ed/40d2ed5a-6217-60a0-22bb-ca38d63689b4/1_iOS_5.5.jpg/392x696bb.jpg","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/ef/2a/8b/ef2a8b44-fa9c-83b5-ec6a-b548a3c6b803/1_iOS_5.5.jpg/392x696bb.jpg","… 6 more"],"ipadScreenshotUrls":["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/b2/12/12/b21212a8-9d4d-12e2-d9c8-4b668cf66587/10.5__Following_tab.png/360x480bb.…","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/86/89/b8/8689b8a4-503f-3254-0a10-1a5097953382/10.5__Home.png/360x480bb.jpg","… 4 more"],"appletvScreenshotUrls":[],"artworkUrl60":"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/65/b4/b1/65b4b1e1-9891-0b84-4d9a-6370410bfbf4/Prod-0-0-1x_U007epad-0-1-0-sRGB-85-220.p…","artworkUrl512":"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/65/b4/b1/65b4b1e1-9891-0b84-4d9a-6370410bfbf4/Prod-0-0-1x_U007epad-0-1-0-sRGB-85-220.p…","artworkUrl100":"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/65/b4/b1/65b4b1e1-9891-0b84-4d9a-6370410bfbf4/Prod-0-0-1x_U007epad-0-1-0-sRGB-85-220.p…","artistViewUrl":"https://apps.apple.com/us/developer/instagram-inc/id389801255?uo=4","currentVersionReleaseDate":"2026-11-02T13:26:16Z","genres":["Photo & Video","Social Networking"],"artistId":389801255,"artistName":"Instagram, Inc.","releaseDate":"2010-10-06T08:12:41Z","releaseNotes":"Performance optimizations and stability improvements for a smoother, more reliable experience.","minimumOsVersion":"16.3","genreIds":["6008","6005"],"primaryGenreName":"Photo & Video","primaryGenreId":6008,"sellerName":"Instagram, Inc.","isVppDeviceBasedLicensingEnabled":true,"version":"454.0.0","wrapperType":"software","currency":"USD","description":"Little moments lead to big friendships. Share yours on Instagram. \n— From Meta\n\nConnect with friends, find other fans, and see what people a…","sellerUrl":"http://instagram.com/","averageUserRating":4.69054,"trackCensoredName":"Instagram","languageCodesISO2A":["BN","HR","… 37 more"],"fileSizeBytes":"700670976","formattedPrice":"Free","contentAdvisoryRating":"12+","userRatingCountForCurrentVersion":29674034,"trackViewUrl":"https://apps.apple.com/us/app/instagram/id389801252?uo=4","trackContentRating":"12+","averageUserRatingForCurrentVersion":4.69054,"bundleId":"com.burbn.instagram","…":"4 more fields"}],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/app-store/v1/privacy":{"get":{"operationId":"appStorePrivacy","summary":"App Store privacy labels","description":"An app's App Privacy labels: data used to track you, data linked to you and data not linked to you, each with the data categories (and purposes when given), plus the developer's privacy policy link.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/app-store-privacy","tags":["App Store"],"x-credits":1,"parameters":[{"name":"app_id","in":"query","required":true,"description":"Numeric app id, id389801252, or an apps.apple.com link.","schema":{"type":"string"},"example":"389801252"},{"name":"country","in":"query","required":false,"description":"Store country, 2 letters (default us).","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"app_id":"389801252","country":"us","name":"Instagram","url":"https://apps.apple.com/us/app/id389801252","summary":"The developer, Instagram, Inc., indicated that the app’s privacy practices may include handling of data as described below. For more informa…","privacy_policy_url":"http://instagram.com/legal/privacy/","count":2,"types":[{"id":"DATA_USED_TO_TRACK_YOU","title":"Data Used to Track You","detail":"The following data may be used to track you across apps and websites owned by other companies:","purposes":[],"categories":[{"id":"CONTACT_INFO","title":"Contact Info","data_types":[]},{"id":"IDENTIFIERS","title":"Identifiers","data_types":[]},"… 1 more"]},{"id":"DATA_LINKED_TO_YOU","title":"Data Linked to You","detail":"The following data may be collected and linked to your identity:","purposes":[],"categories":[{"id":"HEALTH_AND_FITNESS","title":"Health & Fitness","data_types":[]},{"id":"PURCHASES","title":"Purchases","data_types":[]},"… 12 more"]}],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/app-store/v1/reviews":{"get":{"operationId":"appStoreReviews","summary":"App Store reviews","description":"Pass `next_page` from the previous response; `next_page` is null on the last page.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/app-store-reviews","tags":["App Store"],"x-credits":1,"parameters":[{"name":"app_id","in":"query","required":true,"schema":{"type":"string"},"example":"835599320"},{"name":"page","in":"query","required":false,"description":"Page number. Pass `next_page` from the previous response; `next_page` is null on the last page.","schema":{"type":"integer"}},{"name":"country","in":"query","required":false,"description":"Two-letter store country.","schema":{"type":"string"},"example":"us"},{"name":"sort","in":"query","required":false,"description":"recent (default) or helpful.","schema":{"type":"string","enum":["recent","helpful"]}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"app_id":"389801252","country":"us","sort":"recent","page":1,"next_page":2,"reviews":[{"author":"","title":"instagram","content":"Best app i used !!!","rating":"5","updated":"2026-11-02T16:42:38-07:00","id":"14743782103","version":"454.0.0","vote_sum":0,"vote_count":0,"content_type":"Application","author_url":"https://itunes.apple.com/us/reviews/id733769167","url":"https://itunes.apple.com/us/review?id=389801252&type=Purple%20Software"},{"author":"","title":"There is some random people that come on here of naked girls that I see when I post ok my story.","content":"The ads are getting annoying and it should be back to normal how it was the story’s help but the ads do not","rating":"1","updated":"2026-11-02T16:15:31-07:00","id":"14743709068","version":"454.0.0","vote_sum":0,"vote_count":0,"content_type":"Application","author_url":"https://itunes.apple.com/us/reviews/id873419741","url":"https://itunes.apple.com/us/review?id=389801252&type=Purple%20Software"},"… 48 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/app-store/v1/search":{"get":{"operationId":"appStoreSearch","summary":"App Store search","description":"App Store search (Apples Search API): name, developer, price, rating, ratings count, genre, version, size, content rating, icon, screenshots, description. page x limit can go up to 200. Pass `next_page` back as `page`. Every response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/app-store-search","tags":["App Store"],"x-credits":1,"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"notes"},{"name":"country","in":"query","required":false,"description":"e.g. us.","schema":{"type":"string"}},{"name":"device","in":"query","required":false,"description":"iphone (default), ipad, mac.","schema":{"type":"string","enum":["iphone","ipad","mac"]}},{"name":"limit","in":"query","required":false,"description":"1-200 (default 50).","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"lang","in":"query","required":false,"description":"e.g. en_us.","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"query":"instagram","country":"us","device":"iphone","page":1,"limit":50,"count":41,"next_page":null,"apps":[{"position":1,"app_id":389801252,"bundle_id":"com.burbn.instagram","name":"Instagram","developer":"Instagram, Inc.","developer_id":389801255,"price":0,"currency":"USD","formatted_price":"Free","rating":4.69054,"ratings":29676549,"genre":"Photo & Video","genres":["Photo & Video","Social Networking"],"version":"454.0.0","released":"2010-10-06T08:12:41Z","updated":"2026-11-02T13:26:16Z","size_bytes":700670976,"content_rating":"12+","minimum_os":"16.3","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/65/b4/b1/65b4b1e1-9891-0b84-4d9a-6370410bfbf4/Prod-0-0-1x_U007epad-0-1-0-sRGB-85-220.p…","url":"https://apps.apple.com/us/app/instagram/id389801252?uo=4","description":"Little moments lead to big friendships. Share yours on Instagram. \n— From Meta\n\nConnect with friends, find other fans, and see what people a…","release_notes":"Performance optimizations and stability improvements for a smoother, more reliable experience.","screenshots":["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/40/d2/ed/40d2ed5a-6217-60a0-22bb-ca38d63689b4/1_iOS_5.5.jpg/392x696bb.jpg","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/ef/2a/8b/ef2a8b44-fa9c-83b5-ec6a-b548a3c6b803/1_iOS_5.5.jpg/392x696bb.jpg","… 6 more"],"ipad_screenshots":["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/b2/12/12/b21212a8-9d4d-12e2-d9c8-4b668cf66587/10.5__Following_tab.png/360x480bb.…","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/86/89/b8/8689b8a4-503f-3254-0a10-1a5097953382/10.5__Home.png/360x480bb.jpg","… 4 more"],"languages":["BN","HR","… 37 more"],"seller":"Instagram, Inc.","seller_url":"http://instagram.com/"},{"position":2,"app_id":835599320,"bundle_id":"com.zhiliaoapp.musically","name":"TikTok - Videos, Shop & LIVE","developer":"TikTok Ltd.","developer_id":1322881000,"price":0,"currency":"USD","formatted_price":"Free","rating":4.72095,"ratings":18422424,"genre":"Entertainment","genres":["Entertainment","Photo & Video"],"version":"47.6.0","released":"2014-04-02T22:44:45Z","updated":"2026-11-02T22:22:26Z","size_bytes":1079879680,"content_rating":"12+","minimum_os":"15.0","icon":"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/4b/af/40/4baf40d2-5fec-a1fe-da33-cafd0c87f18b/TikTok_AppIcon26-0-0-1x_U007epad-0-1-0-8…","url":"https://apps.apple.com/us/app/tiktok-videos-shop-live/id835599320?uo=4","description":"TikTok is the global discovery platform for videos, streaming on LIVE, shopping, and more. Our mission is to inspire creativity and bring jo…","release_notes":"Quickly find and tag your friends in comments.","screenshots":["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/6c/a1/6a/6ca16a58-1937-7122-e65b-2d901f84fdbb/oEEEv6yBAvIC3s9IGZ1A83wu5TAjAsxiAj…","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/27/ce/2f/27ce2fc4-a338-95ab-3bbe-1b9062cf537d/e6733d76-8afb-4efa-b9a1-9937cdd227…","… 5 more"],"ipad_screenshots":["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/fd/56/a6/fd56a634-ac12-ed70-e74d-360162f72cb2/db2f0a01-028f-4159-bb7f-8719b149c0…","https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/a8/9f/f7/a89ff761-af76-c625-a27b-27fd1b80f230/4ab1f1f0-0316-4039-90f6-9ce710b62f…","… 2 more"],"languages":["SQ","AR","… 48 more"],"seller":"TIKTOK PTE. LTD.","seller_url":"http://www.tiktok.com"},"… 39 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/app-store/v1/similar":{"get":{"operationId":"appStoreSimilar","summary":"App Store similar apps","description":"The apps the App Store shows under You Might Also Like for an app, and the other apps by the same developer: id, name, subtitle, developer, rating and count, age rating, icon and link.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/app-store-similar","tags":["App Store"],"x-credits":1,"parameters":[{"name":"app_id","in":"query","required":true,"description":"Numeric app id, id389801252, or an apps.apple.com link.","schema":{"type":"string"},"example":"389801252"},{"name":"country","in":"query","required":false,"description":"Store country, 2 letters (default us).","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"app_id":"389801252","country":"us","name":"Instagram","url":"https://apps.apple.com/us/app/id389801252","similar_count":10,"similar":[{"id":"447188370","name":"Snapchat","subtitle":"Share the moment!","developer":"Snap, Inc.","bundle_id":"com.toyopagroup.picaboo","rating":4.5,"rating_count":"6.1M","age_rating":"13+","editors_choice":false,"icon":"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/50/62/d8/5062d8dc-9731-35be-1f30-f86fb093d119/Placeholder.mill/512x512bb.png","url":"https://apps.apple.com/app/id447188370","price":null},{"id":"544007664","name":"YouTube","subtitle":"Videos, Music and Live Streams","developer":"Google","bundle_id":"com.google.ios.youtube","rating":4.7,"rating_count":"50M","age_rating":"13+","editors_choice":false,"icon":"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/df/3b/b5/df3bb5ba-7ef0-44ae-fcab-43eb0b97798a/Placeholder.mill/512x512bb.png","url":"https://apps.apple.com/app/id544007664","price":null},"… 8 more"],"more_by_developer_title":"More by Instagram, Inc.","more_by_developer":[{"id":"6446901002","name":"Threads","subtitle":"Join the conversation","developer":"Instagram, Inc.","bundle_id":"com.burbn.barcelona","rating":4.6,"rating_count":"2.3M","age_rating":"13+","editors_choice":false,"icon":"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/84/b1/25/84b125ce-138c-54e4-693d-51674f5907ec/Placeholder.mill/512x512bb.png","url":"https://apps.apple.com/app/id6446901002","price":null},{"id":"6738967378","name":"Edits: Video Editor","subtitle":"Video maker from Instagram","developer":"Instagram, Inc.","bundle_id":"com.burbn.basel","rating":4.8,"rating_count":"101K","age_rating":"4+","editors_choice":false,"icon":"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/c8/fa/1b/c8fa1be5-cb12-baaf-b080-74f77f601e36/Placeholder.mill/512x512bb.png","url":"https://apps.apple.com/app/id6738967378","price":null},"… 1 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/app-store/v1/versions":{"get":{"operationId":"appStoreVersions","summary":"App Store version history","description":"An app's version history from the App Store: version number, release date and release notes, newest first (the page lists the most recent versions, about 25).\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/app-store-versions","tags":["App Store"],"x-credits":1,"parameters":[{"name":"app_id","in":"query","required":true,"description":"Numeric app id, id389801252, or an apps.apple.com link.","schema":{"type":"string"},"example":"389801252"},{"name":"country","in":"query","required":false,"description":"Store country, 2 letters (default us).","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"app_id":"389801252","country":"us","name":"Instagram","url":"https://apps.apple.com/us/app/id389801252","count":25,"versions":[{"version":"454.0.0","released":"2026-11-02T13:26:16.000Z","notes":"Performance optimizations and stability improvements for a smoother, more reliable experience."},{"version":"453.0","released":"2026-10-26T12:40:24.000Z","notes":"Performance optimizations and stability improvements for a smoother, more reliable experience."},"… 23 more"],"note":"The App Store page lists the most recent versions (up to about 25).","cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Create keys at https://app.api.sh/keys. Authorization: Bearer <key> also works."}},"parameters":{"raw":{"name":"raw","in":"query","required":false,"description":"0 leaves out the bulky `raw` source blocks (often 10-30x smaller).","schema":{"type":"string","enum":["0","1"]}},"fields":{"name":"fields","in":"query","required":false,"description":"Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.","schema":{"type":"string"}},"fresh":{"name":"fresh","in":"query","required":false,"description":"1 skips the 24-hour cache and fetches live.","schema":{"type":"string","enum":["1"]}},"output":{"name":"output","in":"query","required":false,"description":"csv or ndjson returns the response's records (its main list, or the object as one row) as CSV or NDJSON instead of JSON.","schema":{"type":"string","enum":["json","csv","ndjson"]}},"records":{"name":"records","in":"query","required":false,"description":"With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row.","schema":{"type":"string"}}},"schemas":{"Error":{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"type":"string"}},"required":["success","error"]}},"responses":{"E400":{"description":"A parameter is missing or invalid. Not charged (unless the call ran and the source rejected the value; credits_used says).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E402":{"description":"Not enough credits, a spend limit you set was reached (`spend_limit`), or the key's monthly credit cap was reached (`key_cap`). Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E404":{"description":"Not found, or not public. A lookup that ran costs the endpoint's price (credits_used says); an unknown route is free.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E502":{"description":"The source site failed this time; retry. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E503":{"description":"Endpoint paused or temporarily unavailable; may include retry-after. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"headers":{"x-request-id":{"description":"The call's id (logs, re-fetch with /v1/results/{id}).","schema":{"type":"string","format":"uuid"}},"x-credits-used":{"description":"Credits charged for this call.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Balance after the call.","schema":{"type":"integer"}}}},"externalDocs":{"url":"https://api.sh/docs"}}