> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Sample Flows

## Article: Sample Flows

## Article Link: https://dev.wix.com/docs/api-reference/app-management/market-listing/sample-flows.md

## Article Content:

# 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](https://dev.wix.com/docs/api-reference/app-management/market-listing/search-market-listings.md) 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](https://dev.wix.com/docs/api-reference/app-management/market-listing/search-market-listings.md) 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](https://dev.wix.com/docs/api-reference/app-management/market-listing/search-market-listings.md) 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](https://dev.wix.com/docs/api-reference/app-management/market-listing/search-market-listings.md) 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.