const base = "https://asc.example.com/v1/connections/conn_example";
const response = await fetch(`${base}/app-clips/app_clip_123/advanced-experiences`, {
headers: { Authorization: `Bearer ${process.env.ASC_FACADE_KEY}` }
});
const body = await response.json();
if (!response.ok) {
throw new Error(body.error?.message ?? `HTTP ${response.status}`);
}
console.log(body);
Python
import json
import os
from urllib.request import Request, urlopen
from urllib.error import HTTPError
base = "https://asc.example.com/v1/connections/conn_example"
request = Request(
f"{base}/app-clips/app_clip_123/advanced-experiences",
headers={"Authorization": f"Bearer {os.environ['ASC_FACADE_KEY']}"},
)
try:
with urlopen(request) as response:
print(json.load(response))
except HTTPError as error:
detail = json.load(error)
raise RuntimeError(detail["error"]["message"]) from error
asc.example.com is a placeholder for your deployment. Examples use fictional IDs.
Path parameters
Name
Type
Description
appClipIdRequired
string
The selected resource’s ID.
Query parameters
Name
Type
Description
statusOptional
string
Filter by status. Multiple values are comma-separated.ValuesRECEIVED, DEACTIVATED, APP_TRANSFER_IN_PROGRESS
placeStatusOptional
string
Filter by place status. Multiple values are comma-separated.ValuesPENDING, MATCHED, NO_MATCH
actionOptional
string
Filter by action. Multiple values are comma-separated.ValuesOPEN, VIEW, PLAY
fieldsOptional
string
Comma-separated attribute names to return. This selects read fields and does not expand relationships. Multiple values are comma-separated.Valueslink, version, status, action, isPoweredBy, place, placeStatus, businessCategory, defaultLanguage
limitOptional · Default 50
integer
Number of items per page, from 1 to 200.
cursorOptional
string
Opaque nextCursor from a previous response. Keep the route, connection, filters, and ordering unchanged.
Response
A page of flat objects, with an opaque continuation cursor.
Illustrative response. Optional read fields may be absent or null; unknown enum values are preserved.
Response fields
Name
Type
Description
items
object[]
The current page of plain resource objects. An empty collection returns [].
nextCursor
string | null
Opaque continuation token, or null when the collection is complete. Pass it back as cursor.
Each item
Name
Type
Description
id
string
Apple’s resource ID. Keep this string unchanged when addressing a resource.
link
string · uri
The link URL reported by Apple.
version
integer
The uploaded build’s version string; this is separate from the store versionString.
status
string
The status value reported by Apple for this resource.ValuesRECEIVED, DEACTIVATED, APP_TRANSFER_IN_PROGRESS
action
string
The action value reported by Apple for this resource.ValuesOPEN, VIEW, PLAY
isPoweredBy
boolean
Whether Apple marks this resource as is powered by.
place
object
The place value reported by Apple for this resource.
placeStatus
string
The place status value reported by Apple for this resource.ValuesPENDING, MATCHED, NO_MATCH
businessCategory
string
The business category value reported by Apple for this resource.ValuesAUTOMOTIVE, BEAUTY, BIKES, BOOKS, CASINO, EDUCATION, EDUCATION_JAPAN, ENTERTAINMENT, EV_CHARGER, FINANCIAL_USD, FINANCIAL_CNY, FINANCIAL_GBP, FINANCIAL_JPY, FINANCIAL_EUR, FITNESS, FOOD_AND_DRINK, GAS, GROCERY, HEALTH_AND_MEDICAL, HOTEL_AND_TRAVEL, MUSIC, PARKING, PET_SERVICES, PROFESSIONAL_SERVICES, SHOPPING, TICKETING, TRANSIT
defaultLanguage
string
The default language value reported by Apple for this resource.ValuesAR, CA, CS, DA, DE, EL, EN, ES, FI, FR, HE, HI, HR, HU, ID, IT, JA, KO, MS, NL, NO, PL, PT, RO, RU, SK, SV, TH, TR, UK, VI, ZH
appClipIdOptional linkage
string | null
ID of the related app clip. Present only when Apple supplies linkage; related objects are not loaded automatically.
headerImageIdOptional linkage
string | null
ID of the related header image. Present only when Apple supplies linkage; related objects are not loaded automatically.
place fields
Name
Type
Description
placeIdOptional
string
The ID of the selected place.
namesOptional
string[]
The names value reported by Apple for this resource.
mainAddressOptional
object
The main address value reported by Apple for this resource.
displayPointOptional
object
The display point value reported by Apple for this resource.
mapActionOptional
string
The map action value reported by Apple for this resource.ValuesBUY_TICKETS, VIEW_AVAILABILITY, VIEW_PRICING, HOTEL_BOOK_ROOM, PARKING_RESERVE_PARKING, RESTAURANT_JOIN_WAITLIST, RESTAURANT_ORDER_DELIVERY, RESTAURANT_ORDER_FOOD, RESTAURANT_ORDER_TAKEOUT, RESTAURANT_RESERVATION, SCHEDULE_APPOINTMENT, RESTAURANT_VIEW_MENU, THEATER_NOW_PLAYING, AIRLINE_BOOK_TRAVEL, AIRLINE_CHECK_IN, AIRLINE_FLIGHT_STATUS, APPLY, BOOK, BOOK_ACTIVITIES, BOOK_RIDES, BOOK_TEETIMES, BOOK_TOURS, CAREERS, CHARGE_EV, COUPONS, DONATE, EVENTS, EVENTS_SHOWS, EVENTS_SPORTS, GIFT_CARD, HOTEL_AMENITIES, JOIN, PARKING_AVAILABLE, RESTAURANT_PICKUP, RETAIL_SERVICE_QUOTE, RETAIL_STORE_DELIVERY, RETAIL_STORE_PICKUP, RETAIL_STORE_SHOP, SERVICES, SUPPORT, PAY_TO_PARK
relationshipOptional
string
The relationship value reported by Apple for this resource.ValuesOWNER, AUTHORIZED, OTHER
phoneNumberOptional
object
The phone number value reported by Apple for this resource.
homePageOptional
string
The home page value reported by Apple for this resource.
categoriesOptional
string[]
The performance categories included in this overview.
place.mainAddress fields
Name
Type
Description
fullAddressOptional
string
The full address value reported by Apple for this resource.
structuredAddressOptional
object
The structured address value reported by Apple for this resource.
place.mainAddress.structuredAddress fields
Name
Type
Description
streetAddressOptional
string[]
The street address value reported by Apple for this resource.
floorOptional
string
The floor value reported by Apple for this resource.
neighborhoodOptional
string
The neighborhood value reported by Apple for this resource.
localityOptional
string
The locality value reported by Apple for this resource.
stateProvinceOptional
string
The state province value reported by Apple for this resource.
postalCodeOptional
string
The postal code value reported by Apple for this resource.
countryCodeOptional
string
The country code value reported by Apple for this resource.
place.displayPoint fields
Name
Type
Description
coordinatesOptional
object
The coordinates value reported by Apple for this resource.
sourceOptional
string
The source value reported by Apple for this resource.ValuesCALCULATED, MANUALLY_PLACED
place.displayPoint.coordinates fields
Name
Type
Description
latitudeOptional
number
The latitude value reported by Apple for this resource.
longitudeOptional
number
The longitude value reported by Apple for this resource.
place.phoneNumber fields
Name
Type
Description
numberOptional
string
The number value reported by Apple for this resource.
typeOptional
string
The type value reported by Apple for this resource.ValuesFAX, LANDLINE, MOBILE, TOLLFREE
intentOptional
string
The intent value reported by Apple for this resource.
Behavior
A nested resource must belong to the selected parent and the configured connection. The adapter validates ownership before returning data.
Pagination
Pass nextCursor back as cursor with the same filters and ordering. Stop when it is null. Each request returns one bounded page; the service never reports a capped or incomplete traversal as a complete collection.
Errors
HTTP
Type
Description
400
invalid_query
Unsupported filter, sort, limit, or cursor.
401
unauthorized
Missing or invalid facade API key.
403
forbidden / upstream_forbidden
The caller or configured Apple key cannot read this resource.
404
resource_not_found
The requested resource, parent, or exact locale is absent or outside the caller’s scope.
429
rate_limited
A facade or Apple rate limit was reached. Respect Retry-After when returned.
502–504
upstream error
Apple authentication, response parsing, availability, or timeout failure; this is not an empty result.
Flatten Apple’s attributes into each resource object. Expose supplied singleton linkage as IDs, with no automatic relationship traversal. Read access does not make these fields writable.