---
title: Domain Research
summary: The <a href="https://docs.fastly.com/products/domain-research-api">Domain Research API</a> lets you programmatically retrieve algorithmic domain search results, and check domains for detailed availability.
url: https://www.fastly.com/documentation/reference/api/domain-management/domain-research
---

The <a href="https://docs.fastly.com/products/domain-research-api">Domain Research API</a> lets you programmatically retrieve algorithmic domain search results, and check domains for detailed availability.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `currency` | string | The currency for the aftermarket offer. |
| `price` | string | The price for the domain from the aftermarket vendor. |
| `vendor` | string | The aftermarket vendor. |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `domain` | string | The domain provided in the status request. |
| `offers` | array |  |
| `scope` | string | The scope provided in the status request. |
| `status` | string | A space-delimited string of the varying statuses associated with the domain provided. |
| `tags` | string | A space-delimited string of the varying tags associated with the domain provided. |
| `zone` | string | The zone of the domain provided of the status request. |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `domain` | string | The suggested domain, consisting of a subdomain and zone. |
| `path` | string | If present, the path is to be appended to the domain to complete the suggestion. |
| `subdomain` | string | The subdomain of the suggested domain. |
| `zone` | string | The zone of the suggested domain. |

## API endpoints

### Suggest domains

**GET** `/domain-management/v1/tools/suggest`

The <code>Suggest</code> method performs a real-time query of the search term(s) against the <a href="http://zonedb.org">known zone database</a>,
making recommendations, stemming, and applying Unicode folding, IDN normalization, registrar supported-zone
restrictions, and other refinements. <strong>Note:</strong> <code>Suggest</code> method responses do not include domain availability status.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `defaults` | string | query | No | Comma-separated list of default zones to include in the search results response. |
| `keywords` | string | query | No | Comma-separated list of keywords for seeding the results. For example, a new gTLD like kitchen, or a related keyword like vegan. Helpful for search result relevance (e.g. from a targeted ad click, a user profile, etc.). |
| `location` | string | query | No | Override IP location detection for country-code zones, with a two-character country code. E.g. to include Geo-relevant zones in the search results. |
| `query` | string | query | Yes | Term(s) to search against. |
| `vendor` | string | query | No | The domain name of a specific registrar or vendor, for filtering results by the zones supported by the vendor. |

### Domain status

**GET** `/domain-management/v1/tools/status`

The <code>Status</code> method checks the availability status of a single domain name.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `domain` | string | query | Yes | Domain name you are checking. |
| `scope` | string | query | No | Include <code>scope=estimate</code> to perform an Estimated status check. Otherwise, a <code>Precise</code> status check is performed by default. |