Sample Use Cases & Flows: Domain Search

This article shares possible use cases your app 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.

Your app could help site owners identify an available, spot-on domain. Then, you could purchase the domain for them and assign it to their site.

To discover and register 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. Optional: In case the relevant site is a free Wix site, use the Resellers API to assign a Premium plan to it. Make sure to save the productInstanceId.
4. Use the Resellers API to create a product instance for the relevant domain TLD and privacy.
5. Register the domain through Wix by calling Create Registered Domain. Make sure to pass a site ID to assign it to the relevant Wix site.
6. Call Get Registered Domain in regular intervals to confirm that the registered domain's status has changed to "ACTIVE".

Your app could help the site owner check the availability of their favorite domain. Then, you could purchase the domain for them 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. Optional: In case the relevant site is a free Wix site, use the Resellers API to assign a Premium plan to it. Make sure to save the productInstanceId.
4. Use the Resellers API to create a product instance for the relevant domain TLD and privacy.
5. Register the domain through Wix by calling Create Registered Domain. Make sure to pass a site ID to assign it to the relevant Wix site.
6. Call Get Registered Domain in regular intervals to confirm that the registered domain's status has changed to "ACTIVE".