---
title: "Suggest domains for a query"
method: GET
path: "/v1/domains/research/suggestions"
tags: ["Domains"]
---

# Suggest domains for a query

`GET /v1/domains/research/suggestions`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/domains/research/suggestions`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Host-better-auth.session_token`
  - none

Returns ranked domain suggestions for a search query.

## Query parameters

- `teamId` string: Optional team context. Requires access to the team.
- `q` string, required: What the domain is for: a word, a brand, or a short phrase.
- `limit` integer: Maximum suggestions to return.

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object, required
    - `query` string, required
    - `suggestions` object[], required
      - `domain` string, required
      - `label` string, required
      - `sld` string, required
      - `tld` string, required
      - `source` 'exact' | 'tld' | 'hack' | 'variant' | 'ai', required
      - `category` 'best' | 'fast' | 'creative' | 'ideas' | 'short' | 'classic' | 'all', required
      - `score` number, required
      - `supportedForPurchase` boolean, required
      - `purchasable` boolean, required
      - `connectable` boolean, required
      - `reason` string, required

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

[API](https://skmtc.dev/spacefast/apis/spacefast-api.md) · [All operations](https://skmtc.dev/spacefast/apis/spacefast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spacefast/apis/spacefast-api/revisions/bd165bc7c983?raw)