List all org-level ACLs (orgs your API user can access, with orgName / currency / paymentModel / roleNames). Use this to discover the orgId for ASA_ORG_ID. Does not require X-AP-Context.

Return information about the calling API user (userId, parentOrgId).

Search the App Store for apps to target / advertise. Returns adamId, name, developerName, and country availability. You need adamId to create campaigns.

Search geo entities by name (Country / AdminArea / Locality). Pass countrycode (lowercase, Apple's quirk) to scope an admin-area or locality search to one country.

Resolve geos by raw IDs. Each request item is { id: 'CountryCode|adminArea|locality', entity: 'Country|AdminArea|Locality' }. Useful when a report returns geo IDs you want named.

Fetch App Store metadata for an app: appName, developerName, primaryGenre, secondaryGenre, iconPictureUrl, availableStorefronts, deviceClasses, etc.

Get localized default product-page details for an app (subtitle, short description, screenshots, app preview) per locale.

Find app-eligibility records by selector (filterable by supplySource, countryOrRegion, deviceClass, state).

Find App Store screenshots / app-preview assets for an app — returns assetGenIds you can use to author creatives or audit rejected assets.

List supported app-preview device-size mappings (e.g. IPHONE_61, IPAD_129). Used when authoring creatives or interpreting screenshot/preview metadata.

List supported countries / regions with their default and supported product-page languages.

List Custom Product Pages for an app.

Fetch a single Custom Product Page by ID.

List the locales available for a Custom Product Page (with localized assets per locale).

Create a new campaign. The minimum useful body specifies adamId, name, countriesOrRegions, adChannelType, supplySources, billingEvent, and a budget.

Fetch a single campaign by ID.

List all campaigns in the org (paginated). For richer filtering use campaigns_find.

Search campaigns with a selector — supports conditions (EQUALS/IN/CONTAINS/...), orderBy, and pagination.

Update a campaign. Pass only the fields you want to change. Use clearGeoTargetingOnCountryOrRegionChange=true if you change countriesOrRegions.

Permanently delete a campaign. Cannot be undone.

Create an ad group within a campaign. Bid + targeting live here, not on the campaign.

Fetch a single ad group.

List all ad groups in a campaign (paginated).

Find ad groups within a single campaign using a selector.

Find ad groups across the entire org with a selector.

Update an ad group. Pass only the fields you want to change.

Delete an ad group.

Create a creative (a reference to a default product page, custom product page, or creative set). Ads bind to creatives via creativeId.

List all creatives in the org (paginated).

Fetch a single creative by ID.

Find creatives across the org with a selector.

Create an ad inside an ad group. Ads bind a Creative (creativeId) to the ad group; the creative itself can wrap a Custom Product Page, Default Product Page, or Creative Set reference.

Fetch a single ad by ID.

List all ads in an ad group.

Find ads across all ad groups in a campaign with a selector.

Find ads across the entire org with a selector.

Update an ad — typically status, name, or repointing to a different creativeId.

Delete an ad.

Bulk-create targeting (positive) keywords on an ad group. Pass up to 1000 per call.

Fetch a single targeting keyword by ID.

List targeting keywords on an ad group (paginated).

Find targeting keywords across all ad groups in a campaign with a selector. Apple does not expose a per-ad-group find — filter by adGroupId in the selector if needed.

Bulk-update targeting keywords (status, bid, text, matchType). Each entry must include id.

Bulk-delete targeting keywords by ID.

Delete a single targeting keyword by ID (uses Apple's REST DELETE variant).

Bulk-create negative keywords on an ad group.

Fetch a single ad-group-level negative keyword by ID.

List ad-group-level negative keywords (paginated).

Find ad-group-level negative keywords across all ad groups in a campaign with a selector.

Bulk-update ad-group-level negative keywords. Each entry must include id.

Bulk-delete ad-group-level negative keywords by ID.

Bulk-create campaign-level negative keywords (apply across all ad groups).

Fetch a single campaign-level negative keyword by ID.

List campaign-level negative keywords (paginated).

Find campaign-level negative keywords within a single campaign with a selector.

Bulk-update campaign-level negative keywords.

Bulk-delete campaign-level negative keywords by ID.

Campaign-level performance report. Returns rows with impressions, taps, installs, spend, CPT/CPM/CPI, conversion rate, etc. Pass groupBy to pivot by country, device, age, gender.

Ad-group-level report within a single campaign.

Keyword report rolled up across all ad groups in one campaign.

Keyword report scoped to a single ad group.

Search-terms report rolled up across all ad groups in a campaign. Reveals what users actually typed — harvest new keywords or negatives from here.

Search-terms report scoped to a single ad group.

Ad-level performance (per Custom Product Page / creative variation) rolled up across the campaign.

Create an Impression Share (Share of Voice) report — async. Returns a reportId you poll with custom_reports_get until state=COMPLETED.

Fetch a single Impression Share report — poll until state=COMPLETED to read rows (rank, impressionShare, lowImpressionShare, highImpressionShare, searchPopularity).

List all Impression Share reports created in the org.

Create a budget order (LOC accounts only). Wraps Apple's {bo, orgIds} envelope.

Fetch a single budget order by ID.

List all budget orders in the org (paginated).

Update a budget order. Most fields are editable post-creation; status is read-only. v5 has no delete endpoint for budget orders.

Find ad-creative rejection reasons (filterable by adamId, productPageId, assetGenId, countryOrRegion, languageCode, supplySource, reasonLevel). Use this to audit why a creative was rejected by Apple's review team.

Fetch a single rejection reason by ID.

Escape hatch: call any Apple Search Ads endpoint by method + path. Authentication and org context are handled for you. Use only if no dedicated tool covers the endpoint you need.