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:

• Query listings by app ID, language, status, and other listing fields.
• 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.
• Both Query Market Listing and Search Market Listings return listings across all apps. Filter by appId if you only want listings for a specific app.
• 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 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
• Find a listing for a specific app
• Retrieve all language variants for an 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.