{"openapi":"3.1.0","info":{"title":"MoonSpace API","version":"1.0.0","description":"App Store intelligence: apps, charts, ads, creators and reviews. Every tool takes GET query parameters or a POST JSON body. Calls draw on the workspace's monthly credits; amounts in responses are centi-credits (1 credit = 100)."},"security":[{"bearer":[]}],"paths":{"/v1/search_apps":{"get":{"summary":"Search apps","description":"Search the App Store catalog by words and filters (genre, category, tag, rating, rating count, price, storefront, release and update dates). Returns apps with their key listing fields. 0.5 credits per item returned.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":50,"per":"item","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"search_apps_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Words to find in name, seller or description.","type":"string","minLength":1,"maxLength":200},"description":"Words to find in name, seller or description."},{"name":"genre","in":"query","required":false,"schema":{"description":"App Store primary genre, for example Health & Fitness.","type":"string","minLength":1,"maxLength":100},"description":"App Store primary genre, for example Health & Fitness."},{"name":"category","in":"query","required":false,"schema":{"description":"MoonSpace category.","type":"string","minLength":1,"maxLength":100},"description":"MoonSpace category."},{"name":"tag","in":"query","required":false,"schema":{"description":"MoonSpace tag.","type":"string","minLength":1,"maxLength":100},"description":"MoonSpace tag."},{"name":"minRating","in":"query","required":false,"schema":{"description":"Lowest average rating, 0 to 5.","type":"number","minimum":0,"maximum":5},"description":"Lowest average rating, 0 to 5."},{"name":"minRatings","in":"query","required":false,"schema":{"description":"Fewest ratings.","type":"integer","minimum":0,"maximum":9007199254740991},"description":"Fewest ratings."},{"name":"maxRatings","in":"query","required":false,"schema":{"description":"Most ratings.","type":"integer","minimum":0,"maximum":9007199254740991},"description":"Most ratings."},{"name":"priceFree","in":"query","required":false,"schema":{"description":"true for free apps only, false for paid only.","type":"boolean"},"description":"true for free apps only, false for paid only."},{"name":"country","in":"query","required":false,"schema":{"description":"Only apps available in this storefront.","type":"string","pattern":"^[a-z]{2}$"},"description":"Only apps available in this storefront."},{"name":"releasedAfter","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Released on or after this day (YYYY-MM-DD, UTC)."},"description":"Released on or after this day (YYYY-MM-DD, UTC)."},{"name":"updatedAfter","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Updated on or after this day (YYYY-MM-DD, UTC)."},"description":"Updated on or after this day (YYYY-MM-DD, UTC)."},{"name":"sort","in":"query","required":false,"schema":{"default":"ratings","description":"ratings (most ratings first, default), rating (highest average) or released (newest). rating and released need q, genre, category or tag.","type":"string","enum":["ratings","rating","released"]},"description":"ratings (most ratings first, default), rating (highest average) or released (newest). rating and released need q, genre, category or tag."},{"name":"limit","in":"query","required":false,"schema":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"description":"Items per page, 1 to 100."},{"name":"cursor","in":"query","required":false,"schema":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"description":"pagination.nextCursor of the previous page, to fetch the next one."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"Search apps","description":"Search the App Store catalog by words and filters (genre, category, tag, rating, rating count, price, storefront, release and update dates). Returns apps with their key listing fields. 0.5 credits per item returned.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":50,"per":"item","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"search_apps","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"description":"Words to find in name, seller or description.","type":"string","minLength":1,"maxLength":200},"genre":{"description":"App Store primary genre, for example Health & Fitness.","type":"string","minLength":1,"maxLength":100},"category":{"description":"MoonSpace category.","type":"string","minLength":1,"maxLength":100},"tag":{"description":"MoonSpace tag.","type":"string","minLength":1,"maxLength":100},"minRating":{"description":"Lowest average rating, 0 to 5.","type":"number","minimum":0,"maximum":5},"minRatings":{"description":"Fewest ratings.","type":"integer","minimum":0,"maximum":9007199254740991},"maxRatings":{"description":"Most ratings.","type":"integer","minimum":0,"maximum":9007199254740991},"priceFree":{"description":"true for free apps only, false for paid only.","type":"boolean"},"country":{"description":"Only apps available in this storefront.","type":"string","pattern":"^[a-z]{2}$"},"releasedAfter":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Released on or after this day (YYYY-MM-DD, UTC)."},"updatedAfter":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Updated on or after this day (YYYY-MM-DD, UTC)."},"sort":{"default":"ratings","description":"ratings (most ratings first, default), rating (highest average) or released (newest). rating and released need q, genre, category or tag.","type":"string","enum":["ratings","rating","released"]},"limit":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"cursor":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"additionalProperties":false}}}}}},"/v1/get_app_detail":{"get":{"summary":"Get app detail","description":"Full profile of one app: listing, description, categories and tags, per-country prices and plans, recent versions and the storefronts it is in. 1 credit per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":100,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_app_detail_get","parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},{"name":"country","in":"query","required":false,"schema":{"description":"Storefront for the listing fields; defaults to the app primary storefront.","type":"string","pattern":"^[a-z]{2}$"},"description":"Storefront for the listing fields; defaults to the app primary storefront."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"Get app detail","description":"Full profile of one app: listing, description, categories and tags, per-country prices and plans, recent versions and the storefronts it is in. 1 credit per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":100,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_app_detail","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"country":{"description":"Storefront for the listing fields; defaults to the app primary storefront.","type":"string","pattern":"^[a-z]{2}$"},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"required":["appId"],"additionalProperties":false}}}}}},"/v1/get_app_historicals":{"get":{"summary":"Get app history","description":"Daily history of an app in one storefront: average rating, rating count, price and version, from 2026-10-29 on. 1 credit per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":100,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_app_historicals_get","parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},{"name":"country","in":"query","required":false,"schema":{"default":"us","type":"string","pattern":"^[a-z]{2}$","description":"Two-letter storefront code, for example us or gb."},"description":"Two-letter storefront code, for example us or gb."},{"name":"period","in":"query","required":false,"schema":{"default":"30d","description":"30d (default), 90d, 365d or all.","type":"string","enum":["30d","90d","365d","all"]},"description":"30d (default), 90d, 365d or all."},{"name":"metrics","in":"query","required":false,"schema":{"description":"Series to return; all of them when left out.","minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["rating","ratingCount","price","version"]}},"description":"Series to return; all of them when left out.","style":"form","explode":false},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"Get app history","description":"Daily history of an app in one storefront: average rating, rating count, price and version, from 2026-10-29 on. 1 credit per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":100,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_app_historicals","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"country":{"default":"us","type":"string","pattern":"^[a-z]{2}$","description":"Two-letter storefront code, for example us or gb."},"period":{"default":"30d","description":"30d (default), 90d, 365d or all.","type":"string","enum":["30d","90d","365d","all"]},"metrics":{"description":"Series to return; all of them when left out.","minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["rating","ratingCount","price","version"]}},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"required":["appId"],"additionalProperties":false}}}}}},"/v1/list_store_rankings":{"get":{"summary":"List store rankings","description":"One App Store top chart (free, paid or grossing) for a storefront and genre on a day, in rank order. The latest day by default. 0.25 credits per item returned.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":25,"per":"item","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"list_store_rankings_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"default":"us","type":"string","pattern":"^[a-z]{2}$","description":"Two-letter storefront code, for example us or gb."},"description":"Two-letter storefront code, for example us or gb."},{"name":"chart","in":"query","required":false,"schema":{"default":"free","description":"Chart: free, paid or grossing.","type":"string","enum":["free","paid","grossing"]},"description":"Chart: free, paid or grossing."},{"name":"genre","in":"query","required":false,"schema":{"default":"0","description":"App Store genre id; 0 (default) is the overall chart.","type":"string","pattern":"^\\d{1,6}$"},"description":"App Store genre id; 0 (default) is the overall chart."},{"name":"source","in":"query","required":false,"schema":{"default":"rss","description":"Chart feed: rss (default, every chart) or marketing.","type":"string","enum":["rss","marketing"]},"description":"Chart feed: rss (default, every chart) or marketing."},{"name":"date","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Chart day; the latest when left out (YYYY-MM-DD, UTC)."},"description":"Chart day; the latest when left out (YYYY-MM-DD, UTC)."},{"name":"limit","in":"query","required":false,"schema":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"description":"Items per page, 1 to 100."},{"name":"cursor","in":"query","required":false,"schema":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"description":"pagination.nextCursor of the previous page, to fetch the next one."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"List store rankings","description":"One App Store top chart (free, paid or grossing) for a storefront and genre on a day, in rank order. The latest day by default. 0.25 credits per item returned.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":25,"per":"item","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"list_store_rankings","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"default":"us","type":"string","pattern":"^[a-z]{2}$","description":"Two-letter storefront code, for example us or gb."},"chart":{"default":"free","description":"Chart: free, paid or grossing.","type":"string","enum":["free","paid","grossing"]},"genre":{"default":"0","description":"App Store genre id; 0 (default) is the overall chart.","type":"string","pattern":"^\\d{1,6}$"},"source":{"default":"rss","description":"Chart feed: rss (default, every chart) or marketing.","type":"string","enum":["rss","marketing"]},"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Chart day; the latest when left out (YYYY-MM-DD, UTC)."},"limit":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"cursor":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"additionalProperties":false}}}}}},"/v1/get_store_ranking_history":{"get":{"summary":"Get ranking history","description":"Daily rank of one app in one chart, storefront and genre, telling days off the chart from days with no data. 2 credits per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":200,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_store_ranking_history_get","parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},{"name":"country","in":"query","required":false,"schema":{"default":"us","type":"string","pattern":"^[a-z]{2}$","description":"Two-letter storefront code, for example us or gb."},"description":"Two-letter storefront code, for example us or gb."},{"name":"chart","in":"query","required":false,"schema":{"default":"free","description":"Chart: free, paid or grossing.","type":"string","enum":["free","paid","grossing"]},"description":"Chart: free, paid or grossing."},{"name":"genre","in":"query","required":false,"schema":{"default":"0","description":"App Store genre id; 0 (default) is the overall chart.","type":"string","pattern":"^\\d{1,6}$"},"description":"App Store genre id; 0 (default) is the overall chart."},{"name":"source","in":"query","required":false,"schema":{"default":"rss","description":"Chart feed: rss (default, every chart) or marketing.","type":"string","enum":["rss","marketing"]},"description":"Chart feed: rss (default, every chart) or marketing."},{"name":"days","in":"query","required":false,"schema":{"default":30,"description":"Days of history, 1 to 365.","type":"integer","minimum":1,"maximum":365},"description":"Days of history, 1 to 365."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"Get ranking history","description":"Daily rank of one app in one chart, storefront and genre, telling days off the chart from days with no data. 2 credits per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":200,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_store_ranking_history","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"country":{"default":"us","type":"string","pattern":"^[a-z]{2}$","description":"Two-letter storefront code, for example us or gb."},"chart":{"default":"free","description":"Chart: free, paid or grossing.","type":"string","enum":["free","paid","grossing"]},"genre":{"default":"0","description":"App Store genre id; 0 (default) is the overall chart.","type":"string","pattern":"^\\d{1,6}$"},"source":{"default":"rss","description":"Chart feed: rss (default, every chart) or marketing.","type":"string","enum":["rss","marketing"]},"days":{"default":30,"description":"Days of history, 1 to 365.","type":"integer","minimum":1,"maximum":365},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"required":["appId"],"additionalProperties":false}}}}}},"/v1/search_ads":{"get":{"summary":"Search ads","description":"Meta ads, for one app or across the catalog, filtered by status, media type and start date. Word search needs appId. 0.5 credits per item returned.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":50,"per":"item","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"search_ads_get","parameters":[{"name":"appId","in":"query","required":false,"schema":{"description":"Only ads attributed to this app.","type":"string","minLength":1,"maxLength":2048},"description":"Only ads attributed to this app."},{"name":"q","in":"query","required":false,"schema":{"description":"Words to find in the ad title or body; needs appId.","type":"string","minLength":1,"maxLength":200},"description":"Words to find in the ad title or body; needs appId."},{"name":"status","in":"query","required":false,"schema":{"default":"all","description":"active, inactive or all (default).","type":"string","enum":["active","inactive","all"]},"description":"active, inactive or all (default)."},{"name":"mediaType","in":"query","required":false,"schema":{"description":"image, video or carousel.","type":"string","enum":["image","video","carousel"]},"description":"image, video or carousel."},{"name":"startedAfter","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Started on or after this day (YYYY-MM-DD, UTC)."},"description":"Started on or after this day (YYYY-MM-DD, UTC)."},{"name":"startedBefore","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Started on or before this day (YYYY-MM-DD, UTC)."},"description":"Started on or before this day (YYYY-MM-DD, UTC)."},{"name":"sort","in":"query","required":false,"schema":{"default":"created","description":"created (newest found first, default) or start_date (newest start first).","type":"string","enum":["start_date","created"]},"description":"created (newest found first, default) or start_date (newest start first)."},{"name":"limit","in":"query","required":false,"schema":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"description":"Items per page, 1 to 100."},{"name":"cursor","in":"query","required":false,"schema":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"description":"pagination.nextCursor of the previous page, to fetch the next one."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"Search ads","description":"Meta ads, for one app or across the catalog, filtered by status, media type and start date. Word search needs appId. 0.5 credits per item returned.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":50,"per":"item","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"search_ads","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"description":"Only ads attributed to this app.","type":"string","minLength":1,"maxLength":2048},"q":{"description":"Words to find in the ad title or body; needs appId.","type":"string","minLength":1,"maxLength":200},"status":{"default":"all","description":"active, inactive or all (default).","type":"string","enum":["active","inactive","all"]},"mediaType":{"description":"image, video or carousel.","type":"string","enum":["image","video","carousel"]},"startedAfter":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Started on or after this day (YYYY-MM-DD, UTC)."},"startedBefore":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Started on or before this day (YYYY-MM-DD, UTC)."},"sort":{"default":"created","description":"created (newest found first, default) or start_date (newest start first).","type":"string","enum":["start_date","created"]},"limit":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"cursor":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"additionalProperties":false}}}}}},"/v1/get_ad_detail":{"get":{"summary":"Get ad detail","description":"One ad with its creative, when it was seen running, its advertiser, and the hooks and angles found in it. 1 credit per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":100,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_ad_detail_get","parameters":[{"name":"adId","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Ad id from search_ads."},"description":"Ad id from search_ads."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"Get ad detail","description":"One ad with its creative, when it was seen running, its advertiser, and the hooks and angles found in it. 1 credit per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":100,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_ad_detail","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"adId":{"type":"string","minLength":1,"maxLength":64,"description":"Ad id from search_ads."},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"required":["adId"],"additionalProperties":false}}}}}},"/v1/list_creators":{"get":{"summary":"List creators","description":"TikTok and Instagram creators confirmed as posting about an app, with follower counts and post stats. 0.5 credits per item returned.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":50,"per":"item","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"list_creators_get","parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["tiktok","instagram"],"description":"tiktok or instagram."},"description":"tiktok or instagram."},{"name":"minFollowers","in":"query","required":false,"schema":{"description":"Fewest followers.","type":"integer","minimum":0,"maximum":9007199254740991},"description":"Fewest followers."},{"name":"maxFollowers","in":"query","required":false,"schema":{"description":"Most followers.","type":"integer","minimum":0,"maximum":9007199254740991},"description":"Most followers."},{"name":"sort","in":"query","required":false,"schema":{"default":"views","description":"views (top post views, default), followers or latest (most recent post).","type":"string","enum":["views","followers","latest"]},"description":"views (top post views, default), followers or latest (most recent post)."},{"name":"limit","in":"query","required":false,"schema":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"description":"Items per page, 1 to 100."},{"name":"cursor","in":"query","required":false,"schema":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"description":"pagination.nextCursor of the previous page, to fetch the next one."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"List creators","description":"TikTok and Instagram creators confirmed as posting about an app, with follower counts and post stats. 0.5 credits per item returned.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":50,"per":"item","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"list_creators","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"platform":{"type":"string","enum":["tiktok","instagram"],"description":"tiktok or instagram."},"minFollowers":{"description":"Fewest followers.","type":"integer","minimum":0,"maximum":9007199254740991},"maxFollowers":{"description":"Most followers.","type":"integer","minimum":0,"maximum":9007199254740991},"sort":{"default":"views","description":"views (top post views, default), followers or latest (most recent post).","type":"string","enum":["views","followers","latest"]},"limit":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"cursor":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"required":["appId"],"additionalProperties":false}}}}}},"/v1/list_organic_content":{"get":{"summary":"List organic content","description":"TikTok and Instagram posts about an app, with views, likes, comments, shares and the paid-partnership flag. 0.5 credits per item returned.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":50,"per":"item","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"list_organic_content_get","parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["tiktok","instagram"],"description":"tiktok or instagram."},"description":"tiktok or instagram."},{"name":"sort","in":"query","required":false,"schema":{"default":"posted","description":"posted (newest, default) or views.","type":"string","enum":["posted","views"]},"description":"posted (newest, default) or views."},{"name":"postedAfter","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Posted on or after this day (YYYY-MM-DD, UTC)."},"description":"Posted on or after this day (YYYY-MM-DD, UTC)."},{"name":"limit","in":"query","required":false,"schema":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"description":"Items per page, 1 to 100."},{"name":"cursor","in":"query","required":false,"schema":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"description":"pagination.nextCursor of the previous page, to fetch the next one."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"List organic content","description":"TikTok and Instagram posts about an app, with views, likes, comments, shares and the paid-partnership flag. 0.5 credits per item returned.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":50,"per":"item","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"list_organic_content","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"platform":{"type":"string","enum":["tiktok","instagram"],"description":"tiktok or instagram."},"sort":{"default":"posted","description":"posted (newest, default) or views.","type":"string","enum":["posted","views"]},"postedAfter":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Posted on or after this day (YYYY-MM-DD, UTC)."},"limit":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"cursor":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"required":["appId"],"additionalProperties":false}}}}}},"/v1/get_app_reviews":{"get":{"summary":"Get app reviews","description":"Stored App Store reviews of an app, newest first, with rating, title, body, version and storefront. coverage tells whether the app is tracked for reviews. 0.25 credits per item returned.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":25,"per":"item","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_app_reviews_get","parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},{"name":"country","in":"query","required":false,"schema":{"description":"Only reviews from this storefront.","type":"string","pattern":"^[a-z]{2}$"},"description":"Only reviews from this storefront."},{"name":"minRating","in":"query","required":false,"schema":{"description":"Lowest star rating, 1 to 5.","type":"integer","minimum":1,"maximum":5},"description":"Lowest star rating, 1 to 5."},{"name":"maxRating","in":"query","required":false,"schema":{"description":"Highest star rating, 1 to 5.","type":"integer","minimum":1,"maximum":5},"description":"Highest star rating, 1 to 5."},{"name":"sort","in":"query","required":false,"schema":{"default":"newest","description":"newest (default).","type":"string","enum":["newest"]},"description":"newest (default)."},{"name":"limit","in":"query","required":false,"schema":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"description":"Items per page, 1 to 100."},{"name":"cursor","in":"query","required":false,"schema":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"description":"pagination.nextCursor of the previous page, to fetch the next one."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"Get app reviews","description":"Stored App Store reviews of an app, newest first, with rating, title, body, version and storefront. coverage tells whether the app is tracked for reviews. 0.25 credits per item returned.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":25,"per":"item","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_app_reviews","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"country":{"description":"Only reviews from this storefront.","type":"string","pattern":"^[a-z]{2}$"},"minRating":{"description":"Lowest star rating, 1 to 5.","type":"integer","minimum":1,"maximum":5},"maxRating":{"description":"Highest star rating, 1 to 5.","type":"integer","minimum":1,"maximum":5},"sort":{"default":"newest","description":"newest (default).","type":"string","enum":["newest"]},"limit":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"cursor":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"required":["appId"],"additionalProperties":false}}}}}},"/v1/get_supported_countries":{"get":{"summary":"Get supported countries","description":"The App Store storefronts MoonSpace tracks, as two-letter codes. Needs no credential. Free.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":0,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[],"operationId":"get_supported_countries_get","parameters":[]},"post":{"summary":"Get supported countries","description":"The App Store storefronts MoonSpace tracks, as two-letter codes. Needs no credential. Free.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":0,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[],"operationId":"get_supported_countries","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}},"/v1/list_favorite_apps":{"get":{"summary":"List favorite apps","description":"The apps your workspace tracks. Free.","tags":["Workspace"],"x-moonspace-cost":{"costCenti":0,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"list_favorite_apps_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"description":"Items per page, 1 to 100."},{"name":"cursor","in":"query","required":false,"schema":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"description":"pagination.nextCursor of the previous page, to fetch the next one."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"List favorite apps","description":"The apps your workspace tracks. Free.","tags":["Workspace"],"x-moonspace-cost":{"costCenti":0,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"list_favorite_apps","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"cursor":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"additionalProperties":false}}}}}},"/v1/get_app_prices":{"get":{"summary":"Get app prices","description":"In-app purchase and subscription prices of an app per storefront, with past captures. 1 credit per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":100,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_app_prices_get","parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},{"name":"country","in":"query","required":false,"schema":{"description":"Only this storefront; every storefront when left out.","type":"string","pattern":"^[a-z]{2}$"},"description":"Only this storefront; every storefront when left out."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"Get app prices","description":"In-app purchase and subscription prices of an app per storefront, with past captures. 1 credit per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":100,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_app_prices","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"country":{"description":"Only this storefront; every storefront when left out.","type":"string","pattern":"^[a-z]{2}$"},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"required":["appId"],"additionalProperties":false}}}}}},"/v1/get_app_versions":{"get":{"summary":"Get app versions","description":"Version history of an app with release dates, newest first. 1 credit per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":100,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_app_versions_get","parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},{"name":"limit","in":"query","required":false,"schema":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"description":"Items per page, 1 to 100."},{"name":"cursor","in":"query","required":false,"schema":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"description":"pagination.nextCursor of the previous page, to fetch the next one."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"Get app versions","description":"Version history of an app with release dates, newest first. 1 credit per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":100,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_app_versions","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"limit":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"cursor":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"required":["appId"],"additionalProperties":false}}}}}},"/v1/get_market_presence":{"get":{"summary":"Get market presence","description":"The storefronts an app is in, with its rating and best current chart rank in each. 1 credit per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":100,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_market_presence_get","parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"Get market presence","description":"The storefronts an app is in, with its rating and best current chart rank in each. 1 credit per call.","tags":["Catalog"],"x-moonspace-cost":{"costCenti":100,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_market_presence","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string","minLength":1,"maxLength":2048,"description":"The app: a MoonSpace app id, a numeric App Store id, or an apps.apple.com link to the app."},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"required":["appId"],"additionalProperties":false}}}}}},"/v1/list_competitors":{"get":{"summary":"List competitors","description":"The apps your workspace tracks, with their role (your own app or a competitor). Free.","tags":["Workspace"],"x-moonspace-cost":{"costCenti":0,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"list_competitors_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"description":"Items per page, 1 to 100."},{"name":"cursor","in":"query","required":false,"schema":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"description":"pagination.nextCursor of the previous page, to fetch the next one."},{"name":"view","in":"query","required":false,"schema":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"description":"compact (default) returns the key fields; full returns every field."},{"name":"fields","in":"query","required":false,"schema":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"},"description":"Comma-separated fields to keep in each item, for example name,developer."}]},"post":{"summary":"List competitors","description":"The apps your workspace tracks, with their role (your own app or a competitor). Free.","tags":["Workspace"],"x-moonspace-cost":{"costCenti":0,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"list_competitors","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"default":25,"description":"Items per page, 1 to 100.","type":"integer","minimum":1,"maximum":100},"cursor":{"description":"pagination.nextCursor of the previous page, to fetch the next one.","type":"string","minLength":1,"maxLength":4096},"view":{"default":"compact","description":"compact (default) returns the key fields; full returns every field.","type":"string","enum":["compact","full"]},"fields":{"description":"Comma-separated fields to keep in each item, for example name,developer.","type":"string","maxLength":1000,"pattern":"^[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*(,[A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)*$"}},"additionalProperties":false}}}}}},"/v1/get_credit_balance":{"get":{"summary":"Get credit balance","description":"Your workspace's plan, credits left, and credits used today and this month, with the period dates. Free.","tags":["Workspace"],"x-moonspace-cost":{"costCenti":0,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_credit_balance_get","parameters":[]},"post":{"summary":"Get credit balance","description":"Your workspace's plan, credits left, and credits used today and this month, with the period dates. Free.","tags":["Workspace"],"x-moonspace-cost":{"costCenti":0,"per":"call","paidOnly":false},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"invalid_input (with zod issues), invalid_json or invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"missing_credential or invalid_credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits: not even one item is affordable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_a_member, no_entitlement, plan_required for a paid-only tool, or tool_disabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"unknown_tool, or app_not_found when no visible app matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"payload_too_large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: wait for the Retry-After seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"not_implemented: the tool is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"entitlements_stale: workspace access cannot be verified right now; retry after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"get_credit_balance","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"An API key (msk_...) or an OAuth access token."}},"schemas":{"Envelope":{"type":"object","required":["data","pagination","credits","dataAsOf"],"properties":{"data":{"description":"A list of items, or one item, after the fields projection."},"pagination":{"type":"object","required":["nextCursor"],"properties":{"nextCursor":{"type":["string","null"],"description":"Send as cursor, with the same other inputs, for the next page."},"total":{"type":"integer","description":"Exact number of matches, when known."}}},"truncated":{"type":"boolean","description":"Present (true) when the credit balance cut the page short."},"credits":{"type":"object","required":["charged","remaining"],"description":"Centi-credits (1 credit = 100).","properties":{"charged":{"type":"integer"},"remaining":{"type":["integer","null"],"description":"What can still be spent now: the lower of the monthly and daily amounts left."},"shortfall":{"type":"integer","description":"Requested minus charged, when truncated."},"limit":{"type":"string","enum":["monthly","daily"]}}},"dataAsOf":{"type":["integer","null"],"description":"Unix milliseconds the data was current at."},"coverage":{"type":"string","enum":["tracked","not_tracked"],"description":"get_app_reviews only: not_tracked means MoonSpace does not collect reviews for the app, so an empty list is not an answer."}}},"Error":{"type":"object","required":["code"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","integer"]}},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"servers":[{"url":"https://api.usemoonspace.com"}]}