List all apps registered in the App Store Connect account.

Args:

• limit (number): Maximum number of apps to return (default 20, max 200)

• nextUrl (string, optional): Pagination URL returned by a previous call. Pass it back to fetch the next page.

Returns: { "count": number, // number of apps in this response "items": [ { "id": string, // App Store Connect app ID "name": string, "bundleId": string, "sku": string, "primaryLocale": string } ], "nextUrl": string | undefined // pass to a subsequent call to fetch the next page, absent if no more pages }

List customer reviews for an app.

Args:

• appId (string, required): The App Store Connect app ID

• sort (string): 'createdDate' | '-createdDate' (default) | 'rating' | '-rating'

• territory (string, optional): ISO 3166-1 alpha-3 territory code filter (e.g. 'USA', 'JPN')

• rating (number, optional): Filter by star rating, 1-5

• limit (number): Maximum number of reviews to return (default 20, max 200)

• nextUrl (string, optional): Pagination URL returned by a previous call

Returns: { "count": number, "items": [ { "id": string, "rating": number, // 1-5 "title": string, "body": string, "reviewerNickname": string, "createdDate": string, // ISO 8601 "territory": string // ISO 3166-1 alpha-3 } ], "nextUrl": string | undefined }

Create a developer response to a customer review. If a response already exists for the review, this will fail (use the App Store Connect UI or API to update/delete an existing response first).

Args:

• reviewId (string, required): The customer review ID to respond to

• responseBody (string, required): The response text (max 5970 characters)

Returns: { "id": string, // response ID "state": string, // e.g. "PENDING_PUBLISH", "PUBLISHED" "responseBody": string, "lastModifiedDate": string }

Error Handling:

• Returns an error if the review already has a response

• Returns "Error: Resource not found" if reviewId does not exist

List builds uploaded for an app, sorted by upload date (newest first).

Args:

• appId (string, required): The App Store Connect app ID

• limit (number): Maximum number of builds to return (default 20, max 200)

• nextUrl (string, optional): Pagination URL returned by a previous call

Returns: { "count": number, "items": [ { "id": string, "version": string, // build number, e.g. "42" "uploadedDate": string, // ISO 8601 "processingState": string, // e.g. "PROCESSING", "VALID", "FAILED", "INVALID" "expired": boolean, "expirationDate": string // ISO 8601 } ], "nextUrl": string | undefined }

List App Store versions for an app (both released and in-progress).

Args:

• appId (string, required): The App Store Connect app ID

• limit (number): Maximum number of versions to return (default 20, max 200)

• nextUrl (string, optional): Pagination URL returned by a previous call

Returns: { "count": number, "items": [ { "id": string, "versionString": string, // e.g. "1.3.3" "appStoreState": string, // e.g. "READY_FOR_SALE", "IN_REVIEW", "PREPARE_FOR_SUBMISSION" "platform": string, // e.g. "IOS" "releaseType": string, // e.g. "MANUAL", "AFTER_APPROVAL", "SCHEDULED" "createdDate": string // ISO 8601 } ], "nextUrl": string | undefined }

Fetch a sales summary report (SALES / SUMMARY / version 1.0) for the vendor configured via the ASC_VENDOR_NUMBER environment variable.

Args:

• reportDate (string, required): Date of the report. Format depends on frequency: DAILY / WEEKLY -> "YYYY-MM-DD" MONTHLY -> "YYYY-MM" YEARLY -> "YYYY"

• frequency (string): "DAILY" (default) | "WEEKLY" | "MONTHLY" | "YEARLY"

Returns: { "totalRows": number, // total number of data rows in the report "returnedRows": number, // number of rows included in this response (max 50) "truncated": boolean, // true if totalRows > returnedRows "rows": [ { : , ... } ] }

Error Handling:

• Returns an error if ASC_VENDOR_NUMBER is not set

• Returns "Error: Resource not found" (HTTP 404) if no report exists for the given date/frequency

Check an app's search ranking for a keyword on the App Store, using the public iTunes Search API. No App Store Connect authentication (JWT) is required for this tool.

Args:

• keyword (string, required): The search keyword

• country (string): ISO 3166-1 alpha-2 country code (default 'jp')

• bundleId (string, optional): Bundle ID of the target app. If provided, its rank within the top 200 results is looked up.

• topN (number): Number of top results to include (default 10, max 50)

Returns: { "keyword": string, "country": string, "totalResults": number, "targetRank": number | null, // bundleId指定時にランクが見つかった場合のみ数値、それ以外はnull "targetNote": string | undefined, // targetRankがnullの場合の理由 "target": { // bundleIdが上位200件内で見つかった場合のみ "trackName": string, "averageUserRating": number, "userRatingCount": number } | undefined, "topResults": [ { "rank": number, "trackName": string, "bundleId": string, "averageUserRating": number, "userRatingCount": number, "price": number, "genres": string[] // 先頭2件のみ } ] }

Error Handling:

• iTunes Search APIはレート制限(目安: 約20リクエスト/分)があり、超過するとHTTP 403が返ることがある。その場合は時間をおいて再試行すること。

Ensure an ONGOING analytics report request exists for an app. If one already exists it is reused; otherwise a new one is created. Call this first, before asc_list_analytics_reports.

Args:

• appId (string, required): The App Store Connect app ID

Returns: { "requestId": string, // pass to asc_list_analytics_reports "accessType": "ONGOING", "created": boolean, // true if a new request was just created, false if an existing ONGOING request was reused "note": string // reminds that report generation can take up to 48 hours after first creation }

List analytics reports available under an analytics report request. Call asc_request_analytics_reports first to obtain requestId.

Args:

• requestId (string, required): The analytics report request ID

• category (string, optional): Filter by category

• limit (number): Maximum number of reports to return (default 20, max 200)

• nextUrl (string, optional): Pagination URL returned by a previous call

Returns: { "count": number, "items": [ { "reportId": string, // pass to asc_get_analytics_report_data "name": string, "category": string } ], "nextUrl": string | undefined }

Fetch the data of an analytics report: resolves the latest (or specified) report instance, downloads and decompresses its segments, and returns a preview of the combined rows.

Args:

• reportId (string, required): The analytics report ID returned by asc_list_analytics_reports

• granularity (string): "DAILY" (default) | "WEEKLY" | "MONTHLY"

• processingDate (string, optional): YYYY-MM-DD. If omitted, the latest available instance is used.

Returns: { "reportId": string, "instanceId": string, "processingDate": string, // YYYY-MM-DD "granularity": string, "segmentCount": number, "totalRows": number, // total number of data rows across all segments "returnedRows": number, // number of rows included in this response (max 50) "truncated": boolean, // true if totalRows > returnedRows "rows": [ { : , ... } ] }

Error Handling:

• Returns an error if no report instance matches the given granularity/processingDate (report may not be generated yet; can take up to 48 hours after the ONGOING request was created)

Create a new App Store version (e.g. to start preparing the next release) for an app.

Args:

• appId (string, required): The App Store Connect app ID

• versionString (string, required): The version number, e.g. "1.3.4"

• platform (string): "IOS" (default) | "MAC_OS" | "TV_OS" | "VISION_OS"

Returns: { "versionId": string, "versionString": string, "appStoreState": string // typically "PREPARE_FOR_SUBMISSION" right after creation }

Error Handling:

• Returns an error if a version with the same versionString already exists for the app

Create localized App Store metadata for a version, including release notes, keywords, and promotional text.

List per-locale App Store version metadata (description, keywords, what's new, etc.) for an App Store version.

Args:

• versionId (string, required): The App Store version ID

• limit (number): Maximum number of localizations to return (default 20, max 200)

• nextUrl (string, optional): Pagination URL returned by a previous call

Returns: { "count": number, "items": [ { "id": string, // pass to asc_update_version_localization "locale": string, // e.g. "ja", "en-US" "description": string, "keywords": string, "whatsNew": string, "promotionalText": string, "supportUrl": string, "marketingUrl": string } ], "nextUrl": string | undefined }

Update per-locale App Store version metadata. Only the fields you pass are updated; omitted fields are left unchanged.

Note: promotionalText can be updated anytime; other fields (description, keywords, whatsNew, supportUrl, marketingUrl) can only be updated while the version is in an editable state (e.g. PREPARE_FOR_SUBMISSION, DEVELOPER_REJECTED, REJECTED).

Args:

• localizationId (string, required): The App Store version localization ID (from asc_list_version_localizations)

• description (string, optional)

• keywords (string, optional): comma-separated

• whatsNew (string, optional)

• promotionalText (string, optional)

• supportUrl (string, optional)

• marketingUrl (string, optional)

At least one of the optional fields must be provided.

Returns: { "id": string, "locale": string, "description": string, "keywords": string, "whatsNew": string, "promotionalText": string, "supportUrl": string, "marketingUrl": string }

Error Handling:

• Returns an error if no updatable field is provided

• Returns an error if the version is not in an editable state for the fields being changed

List per-locale app-level metadata (name, subtitle, privacy policy URL) across all appInfos of an app. An app usually has two appInfos: the live one and the one currently being edited (distinguished by appInfoState).

Args:

• appId (string, required): The App Store Connect app ID

Returns: { "count": number, "items": [ { "id": string, // pass to asc_update_app_info_localization "appInfoId": string, "appInfoState": string, // e.g. "READY_FOR_DISTRIBUTION", "PREPARE_FOR_SUBMISSION" "locale": string, "name": string, "subtitle": string, "privacyPolicyUrl": string } ] }

Update per-locale app-level metadata (name, subtitle, privacy policy URL). Only the fields you pass are updated. Only editable while the corresponding appInfo is in an editable state.

Args:

• localizationId (string, required): The app info localization ID (from asc_list_app_info_localizations)

• name (string, optional)

• subtitle (string, optional)

• privacyPolicyUrl (string, optional)

At least one of the optional fields must be provided.

Returns: { "id": string, "locale": string, "name": string, "subtitle": string, "privacyPolicyUrl": string }

Error Handling:

• Returns an error if no updatable field is provided

• Returns an error if the appInfo is not in an editable state

Attach a build to an App Store version's "build" relationship. This is required before the version can be submitted for review.

Args:

• versionId (string, required): The App Store version ID

• buildId (string, required): The build ID to attach

Returns: { "versionId": string, "buildId": string, "success": true }

Error Handling:

• Returns an error if the build is not valid/processed, or if the version is not in an editable state

Get the App Review contact information, demo account, and notes for an App Store version.

Create the App Review contact information, optional demo account, and notes for a version.

Update only the provided App Review contact, demo account, or notes fields.

Create a review submission, add one App Store version, and submit it to App Review.

Submit a Product Page Optimization experiment or custom product page version to App Review.

Create a screenshot container for one App Store version locale and display type.

List screenshot sets for an App Store version localization.

List the ordered screenshots and upload processing states in a screenshot set.

Reserve, upload, and commit one local screenshot file to an existing screenshot set.

Delete one screenshot, or a screenshot set and every screenshot it contains.

Update version metadata and choose manual, automatic, or scheduled release behavior.

Enable a seven-day phased release for an App Store version.

Start, pause, resume, or complete an existing phased release.

Release an approved App Store version that is waiting for a manual release.

List selectable customer prices and proceeds for an app in one territory.

Get the current and scheduled manual prices for an app, including their price point IDs.

Set or schedule an app price from a price point in the base territory; other territories are equalized automatically.

Get global and per-territory App Store availability, release, and pre-order settings.

List every territory availability with pagination for an app availability resource.

Enable or disable an app in one territory and update its release or pre-order dates.

List internal and external TestFlight groups for an app.

Create an internal or external TestFlight group, with optional public-link settings.

List TestFlight testers, optionally filtering by exact email address.

Create or invite a TestFlight tester account.

Add one or more testers or builds to an existing TestFlight group.

List localized What to Test text for a TestFlight build.

Create or update localized What to Test text for a TestFlight build.

Get internal and external testing states and the buildBetaDetail ID for a build.

Enable or disable automatic tester invitations when an external build becomes available.

Submit a build to Beta App Review before external TestFlight distribution.

List Product Page Optimization A/B experiments for an App Store version.

Create a Product Page Optimization experiment and set its traffic percentage.

Rename, start, stop, complete, or change traffic for a Product Page Optimization experiment.

Create a named treatment variant for a Product Page Optimization experiment.

List the treatment variants in a Product Page Optimization experiment.

Create a locale container for treatment screenshots and previews.

List custom App Store product pages and their public URLs.

Create a named custom App Store product page for targeted campaigns.

Rename or show and hide a custom product page.

Create an editable version of a custom product page, with an optional app deep link.

List editable and reviewed versions of a custom product page.

Update the app deep link for an editable custom product page version.

Create localized promotional text and an asset container for a custom product page version.

Get launch time, hangs, memory, battery, disk, animation, termination, or storage metrics for an app or build.

List recurring crash, hang, and disk-write signatures collected for a build.

Download anonymized call-stack logs and insights for one diagnostic signature.