> 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: Introduction

## Article: Introduction

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

## Article Content:

# About the App Market Listing API

The App Market Listing API lets you retrieve and search for app listings in the Wix App Market.
Each listing is the localized marketing page for an app, containing its name, description, categories, assets, and other marketing content.

With the App Market Listing API, you can:

- Search published listings by keyword or app name for a given language.

## Before you begin

It's important to note the following points before starting to code:

- A market listing is uniquely identified by the combination of `appId`, `languageCode`, and `status`. An app has one `DRAFT` and one `PUBLISHED` listing for each supported language.
- Search Market Listings is keyword-based and returns only `PUBLISHED` listings. Call it when searching by app name or keyword. It returns up to 50 results per page and defaults to English (`en`).

## Market listing lifecycle

Before your app can go live in the Wix App Market, your listing goes through a submission and review process:

1. **Prepare your listing**: Add your app's name, description, categories, and marketing assets in the app dashboard. Your listing is in `DRAFT` status while you work on it.

2. **Submit for review**: When your listing is ready, submit it from the app dashboard. See [Submit Your First App Version](https://dev.wix.com/docs/build-apps/launch-your-app/app-distribution/submit-your-first-app-version.md) for what's required. If the submission passes Wix review, your listing moves to `APPROVED` status.

3. **Go live**: The next time you publish an app version, Wix automatically promotes the `APPROVED` listing to `PUBLISHED`, making it visible in the Wix App Market.

## Use cases

- [Search for a published app by name](https://dev.wix.com/docs/api-reference/app-management/market-listing/sample-flows.md#search-for-a-published-app-by-name)
- [Find a listing for a specific app](https://dev.wix.com/docs/api-reference/app-management/market-listing/sample-flows.md#find-a-listing-for-a-specific-app)

## Terminology

- **Market listing:** A localized marketing page for an app in the Wix App Market. Uniquely identified by the combination of `appId`, `languageCode`, and `status`.
- **Status:** Lifecycle stage of a listing.
  - `DRAFT`: Editable working copy of the listing in the app dashboard.
  - `PUBLISHED`: Live listing visible to users in the Wix App Market.
  - `APPROVED`: Post-review, pre-publication state. The listing has passed review but hasn't been promoted to `PUBLISHED` yet.
- **Classification:** How the app integrates with Wix or who can install it. Each app has exactly one classification:
  - `SITE_APP`: A publicly listed app that users install on their Wix sites.
  - `PRIVATE_APP`: An app restricted to the owner account and its sub-accounts. Not available in the public App Market.
  - `VELO_APP`: An app built for the Velo development environment.
  - `API_KEY`: An app that authenticates using an API key to access Wix services, without installing on a site.
  - `HEADLESS`: A headless app that accesses Wix public services without installing on a site.
  - `FUNCTION_ACTIVATION_APP`: An app scoped to a specific site that tracks activated functions on that site.
- **Installation requirement:** Conditions that control where and how an app can be installed, including geographic restrictions, language restrictions, app dependencies, and Wix Premium requirements.

@sdk_package_setup