Sample Use Cases & Flows: Domain Search

This article shares possible use cases your implementation could support, as well as example flows. 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.

Discover a domain

You could help site owners identify an available, spot-on domain. Then, you or the site owner can purchase the domain and assign it to their Wix site.

To discover a domain:

  1. Call Suggest Domains to retrieve a list of relevant available domains.
  2. Display the suggestions to the site owners and let them select their preferred choice.
  3. If the relevant site is a free Wix site, call Resellers Create Package v2 to assign a Premium plan to it. Make sure to save the productInstanceId.
  4. Call Resellers Create Package v2 to create a product instance for the relevant domain TLD and privacy.
  5. Prompt the site owner to register the domain through Wix at https://manage.wix.com/account/domains, or register the domain on your own.
  6. If you register the domain on your own, connect the domain by following one of the use cases described in Connected Domains.

Check a domain's availability

You could help the site owner check the availability of their favorite domain. Then, the site owner can purchase the domain and assign it to their site.

To check a domain's availability and register it:

  1. Ask the site owners what their favorite domain is.
  2. Call Check Domain Availability to verify that the domain is still available. If its isn't available, start over or follow the flow above.
  3. If the relevant site is a free Wix site, call Resellers Create Package v2 to assign a Premium plan to it. Make sure to save the productInstanceId.
  4. Call Resellers Create Package v2 to create a product instance for the relevant domain TLD and privacy.
  5. Prompt the site owner to register the domain through Wix at https://manage.wix.com/account/domains, or register the domain on your own.
  6. If you register the domain on your own, connect the domain by following one of the use cases described in Connected Domains.
Did this help?