Contents

Get Metadata for Your Books

Fetch metadata for your books by using their identifiers.

URL

GET https://api.ent.apple.com/v1/catalog/{storefront}/stoken-authenticated-books

Path Parameters

NameTypeDescription
storefront Requiredstring

An iTunes Store territory that you specify with an ISO 3166 alpha-2 country code. The possible values are the id attributes of Storefrontobjects.

Query Parameters

NameTypeDescription
additionalPlatforms Optional[string]

Additional platforms the app supports that you want to get metadata for.

ids Optional[string]

The unique identifiers for the books.

l Optionalstring

The localization to use, which you specify with a language tag. The possible values are in the supportedLanguageTags array belonging to the Storefront object that storefront specifies. Otherwise, the default is defaultLanguageTag in Storefront.

platform Requiredstring

The platform the user-facing app is running on. You use this to get metadata for the specified platform.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
ResourceCollectionResponse

The request was successful.

401Unauthorized
Content-Type: application/json
UnauthorizedResponse

A response indicating an incorrect Authorization header.

500Internal Server Error
Content-Type: application/json
ErrorsResponse

A response indicating an error occurred on the server.

Discussion

Example Request and Response

Topics

Responses

See Also

App and book metadata