Get to know our frameworks

Select an app template built on your preferred framework.

Build apps on our native app editor. Use drag and drop elements, Velo code and Wix APIs to develop custom features.

Streamline your app development process with the Wix CLI. Get a familiar developer experience with minimal setup and configuration.

Take full control over your app's tech stack, deployment, and hosting.

App templates

Wix Blocks templates

Wix CLI templates

Self-hosted templates

Kickstart your app development with templates built on your preferred Wix developer tool. Browse templates for practical foundation and get to know the Wix ecosystem.

Wix App Templates for Developers

This example apps can be used as a starting point for building your own app, for concrete examples of how to use Wix framework, or for inspiration.

Choose a template.<0 />Build an app.

Browse by:

How to build it step by step:

This template is built with:

Read how this template was built, step by step.

How we built this template

Deployment instructions:

Choose a package manager and run the command in your terminal.

Copy command

Before you get started, make sure you have the following:

Prerequisite steps

Get started with Wix CLI

Begin by setting up your Next.js project with your preferred hosting platform.

Select your hosting service

Start the deployment flow and set up your template repo on Netlify. After you finish set up, come back here and add your Netlify custom domain.

Copy the code from our Git repo to deploy your app on any platform that supports Next.js.

Start the deployment flow and set up your template repo on Vercel. After you finish set up, come back here and add your Vercel generated URL.

Add the base URL and give your app a name.

App details

Go to the app dashboard and test your app to ensure a smooth integration within the Wix ecosystem. <0>Learn more about app checks and testing</0>

Define your environment

Terminal

Related templates

Note

Warning

Your app name will be used as the namespace suffix.

Name your app to generate a namespace. This lets you refer to your app in code later on.

Go Headless

Build Apps

Client

API Preview

Develop Websites

REST

Velo

GraphQL (Alpha)

# About the SEO Keyword Suggestions Service Plugin

<blockquote class="important">

**Important**: To test an app with the SEO Keyword Suggestions service plugin, please [contact us](fallback::https://www.wix.com/support-chatbot?nodeId=25a57397-ccf7-4376-8b74-48d51edf7159&referral=devRels). Our team can add the app to the SEO Setup Checklist flow for testing.

</blockquote>

As a service plugin provider (formerly SPI) of SEO keyword research tools, you can integrate with Wix to enable Wix users to optimize their SEO strategy.

Using the SEO Keyword Suggestions service plugin, you can design your app to:
- Enable Wix users to check the SEO strength of a potential keyword.
- Suggest similar keywords to compare SEO strength.
- Provide analysis about the suggested keywords based on search volume and ranking difficulty.
- Update Wix users about remaining credit in their plan.

## How to become an SEO keyword suggestion provider

To become an SEO keyword suggestion provider,
[add the **Seo Keywords Suggestions** extension](portalId::63e3acd8-2a9c-421d-8f92-d02930eeb59eresourceId::e68963a0-5a92-4e35-8eb3-90de7b47b986#configure-an-extension-in-the-development-center*fallback::https://dev.wix.com/docs/rest/articles/getting-started/service-provider-interface#configure-an-extension-in-the-development-center)
in your app's configuration in Wix Developers Center.

Provide the necessary configuration for your app:

| Name                    | Type          | Description                                                                                                                                                                                           |
| ----------------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `baseUri`               | string        | **Required.** Base URI where the endpoints are called. Wix appends the endpoint path to the base URI. For example, to call the Get Quota endpoint at `https://my-seo-suggestions/v1/get-quota`, the base URI you provide here is `https://my-seo-suggestions.com`.                                                                                                  |
| `upgradeUrl`            | string        | URL of the page where users can purchase a paid plan. Wix offers a link to this page when you respond with a value of `false` in quota's `paidPlan` property.                                         |
| `supportedCountryCodes` | array<string> | **Required.** List of countries you support for SEO analysis. 2-letter country code in [ISO-3166 alpha-2](fallback::https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) format. |
| `quotaEnabled`          | boolean       | Whether there is a quota limit in the service. When set to true, include the quota object in responses.                                                                                               |
| `landingPageUrl`        | string        | **Required.** Your website's landing page.                                                                                                                                                            |

## Terminology

 - **Suggested keywords**: Keywords suggested by your app to compare SEO strength of potential keywords and enable optimization of SEO strategy.

- **Quota**: Details of the plan such as credit remaining in terms of number of searches left, total available searches, and start and end dates of the quota cycle.



# Sample Flows
This article shares some use cases your app could support, as well as a sample flow that could support each use case. You're certainly not limited to these use cases, but they can be a helpful jumping off point as you plan your app's implementation.



## SEO List Suggested Keywords Flow

A Wix user wishes to determine the strongest SEO keywords for their site. When the `quotaEnabled` parameter is set to `true` in the configuration, you return a quota object in addition to the data object.

1. The Wix user provides a keyword to Wix to check its SEO strength.

2. Wix sends a [List Suggested Keywords](fallback::https://dev.wix.com/api/rest/marketing/seo-keyword-suggestions-spi/list-suggested-keywords) request to your app using the configured `baseUri`. 

    ```json
    {
        "keyword": "pizza",
        "countryCode": "US"
    }
    ```

3. Your app sends a response. 

   Wix expects an object containing either a 4xx HTTP status code (and some errors) or a 200 HTTP status code and the List Suggested Keywords response.

You can see an example of the response in the [List Suggested Keywords](fallback::https://dev.wix.com/api/rest/marketing/seo-keyword-suggestions-spi/list-suggested-keywords) code example. 

## Get Quota Flow

When a Wix user initially opens the SEO page in the Dashboard, Wix requests information about the current quota plan.

1. The Wix user opens the SEO page in the Dashboard.

2. Wix sends a [Get Quota](fallback::https://dev.wix.com/api/rest/marketing/seo-keyword-suggestions-spi/get-quota) request to your app using the configured `baseUri`. No parameters are sent.

3. Your app sends a response. 

   Wix expects an object containing either a 4xx HTTP status code (and some errors) or a 200 HTTP status code and the Get Quota response.

You can see an example of the response in the [Get Quota](fallback::https://dev.wix.com/api/rest/marketing/seo-keyword-suggestions-spi/get-quota) code example. 


value

BoolValue

StringValue

nanos

seconds

Timestamp

this message is not directly used by any service,
it exists to describe the expected parameters that SHOULD be provided to invoked Velo methods as part of open-platform.
e.g. SPIs, event-handlers, etc..
NOTE: this context object MUST be provided as the last argument in each Velo method signature.

Example:
```typescript
export function wixStores_onOrderCanceled({ event, metadata }: OrderCanceledEvent) {
...
}
```

[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 3-letter currency code.

currency

An object that describes the identity that triggered this request.

instanceId

A string representing a language and region in the format of `"xx-XX"`. First 2 letters represent the language code according to ISO 639-1. This is followed by a dash "-", and then a by 2 capital letters representing the region according to ISO 3166-2. For example, `"en-US"`.

languages

A unique identifier of the request. You may print this ID to your logs to help with future debugging and easier correlation with Wix's logs.

requestId

Context

identityType

IdentificationData

IdentityType

ID of a site visitor that has not logged in to the site.

anonymousVisitorId

appId

ID of a site visitor that has logged in to the site.

memberId

ID of a Wix user (site owner, contributor, etc.).

wixUserId

GetQuotaRequest

*Required if `quotaEnabled` is `true` in the configuration**. Information about remaining credit in the plan.

GetQuotaResponse

Specific country for analysis.

2-letter country code in
[ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)
format.

countryCode

keyword

ListSuggestedKeywordsRequest

data

ListSuggestedKeywordsResponse

*Required**. End date and time of the current quota cycle as UTC datetime in `YYYY-MM-DDThh:mm[:ss][.sss]Z` format.
After this time, the quota is reset

endDate

*Required**. Total number of searches available in the current quota cycle.

limit

*Required**. Whether the user currently has a paid plan.
If `false`, the user is offered an upgrade using the `upgradeUrl` from the configuration.

paidPlan

*Required**. Number of searches left until the end of the current quota cycle.

remaining

*Required**. Start date and time of the current quota cycle as UTC datetime in `YYYY-MM-DDThh:mm[:ss][.sss]Z` format.

startDate

Quota

SearcherIntent

Base URL of your SEO implementation. Wix sends API requests to endpoints implemented using this URL.

baseUri

landingPageUrl

Whether there is a quota limit in the service. When set to true, include the quota object in responses.

quotaEnabled

List of countries you support for SEO analysis.
2-letter country code in [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)
format.

supportedCountryCodes

URL of the page where users can purchase a paid plan. Wix offers a link to this page when you respond with a value of `false` in quota's `paidPlan` property.

upgradeUrl

SeoKeywordsSuggestionsSPIConfig

*Required**. Indicates how competitive the keyword is and how difficult to rank in an organic search. A higher difficulty means the keyword has a lower search ranking. <br>
Min: `1` <br>
Max: `100`

difficulty

*Required**. Keyword suggestions offered by the SEO tool.

*Required**. Trends in searches for the keyword per month over the last 12 months.

Must include exactly 12 values.

Typically, the trend values represent the number of searches relative to the peak search volume.

A value of `1.0` represents the highest search volume for the term. A value of `0.50` means that there were half as many searches. <br>
Min: `0.0` <br>
Max: `1.0`

latestTrends

User's reason for searching for the keyword (optional):
- `COMMERCIAL`: Users searched for specific brands or services, usually with an intent to purchase.
- `INFORMATIONAL`: Users searched for information about a topic.
- `NAVIGATIONAL`: Users searched for a specific page, site, or physical location.
- `TRANSACTIONAL`: Users searched to perform a transaction, for example a purchase.

searcherIntent

*Required**. Average number of searches per month for the keyword.

volume

SuggestedKeywords

This method requests keyword suggestions for a specified phrase.
You provide statistical data about the requested keyword and a list of similar keywords
so the user can compare the SEO strength of the suggested keywords.

Wix calls this method when a Wix user requests data about a keyword via the SEO page of the Dashboard.

OutOfQuotaError

MissingTokenError

List suggested keywords

ListSuggestedKeywords

This method requests information about remaining quota in the plan.
A Wix user can purchase a paid plan from your site or utilize a free plan
if you offer one.
You provide information about the current plan including how many searches remain
out of the total in the plan, the dates of the plan, and whether the user currently has a paid plan.

Wix calls this method when a Wix user opens the SEO page of the Dashboard.