> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dotlet.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Domains

> Search for available domains based on a keyword.

Returns a list of domain suggestions with availability and pricing.



## OpenAPI

````yaml POST /api/v1/registrar/search
openapi: 3.1.0
info:
  title: Dotlet API
  description: >-
    The Dotlet API lets you search, register, and manage domains, configure DNS
    records, and embed domain purchasing flows in your own product.


    All endpoints are authenticated with an API key or bearer token, and all
    request and response bodies are JSON.
  version: 0.1.1
  contact:
    name: Dotlet Support
    url: https://dotlet.net/support
    email: support@dotlet.net
servers:
  - url: https://api.dotlet.net
    description: Production
security: []
tags:
  - name: Domains
    description: Search, price, register, renew, and manage domains.
  - name: Orders
    description: Create and track domain orders separately from immediate purchases.
  - name: DNS
    description: Manage DNS records for domains hosted with Dotlet.
  - name: Hosted Sessions
    description: Create embeddable, scoped sessions for end users in your own product.
paths:
  /api/v1/registrar/search:
    post:
      tags:
        - Domains
      summary: Search Domains
      description: |-
        Search for available domains based on a keyword.

        Returns a list of domain suggestions with availability and pricing.
      operationId: search_domains_api_v1_registrar_search_post
      parameters:
        - name: registrar
          in: query
          required: false
          schema:
            type: string
            default: namecheap
            title: Registrar
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DomainSearchRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DomainSearchResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    DomainSearchRequest:
      properties:
        query:
          type: string
          maxLength: 100
          minLength: 1
          title: Query
        tlds:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Tlds
        limit:
          type: integer
          maximum: 50
          minimum: 1
          title: Limit
          default: 10
      type: object
      required:
        - query
      title: DomainSearchRequest
      description: Request to search for domains
    DomainSearchResponse:
      properties:
        query:
          type: string
          title: Query
        suggestions:
          items:
            $ref: '#/components/schemas/DomainSuggestionResponse'
          type: array
          title: Suggestions
      type: object
      required:
        - query
        - suggestions
      title: DomainSearchResponse
      description: Response for domain search
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DomainSuggestionResponse:
      properties:
        domain:
          type: string
          title: Domain
        available:
          type: boolean
          title: Available
        price:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Price
        currency:
          type: string
          title: Currency
          default: USD
      type: object
      required:
        - domain
        - available
      title: DomainSuggestionResponse
      description: Domain suggestion
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      scheme: bearer

````