App Market Listing API: Sample Flows

This article presents possible use cases and corresponding sample flows that you can support. This can be a helpful jumping off point as you plan your implementation.

Search for a published app by name

Call Search Market Listings to find published apps by keyword or name — for example, before installing an app or recommending it to a user. The search returns only PUBLISHED listings and defaults to English.

To search for a published app by name:

1. Call Search Market Listings with:
   • searchTerm set to the app name or keyword.
   • languageCode set to the desired language. Omit to default to en.
   • Optional paging to control the result size (up to 50 per page).
2. Iterate through the returned marketListings to identify the relevant app.
3. Use the appId from the result in downstream operations, such as app installation.

Find a listing for a specific app

Call Search Market Listings to retrieve the published listing for an app when you know its name. This is useful when you want to display listing details such as the app description, categories, or marketing assets.

To find a listing for a specific app:

1. Call Search Market Listings with:
   • searchTerm set to the app name.
   • languageCode set to the desired language. Omit to default to en.
2. Iterate through the returned marketListings to find the exact match by app name.
3. Use the listing data as needed — for example, to display the app description or marketing assets.