Cheapest Domains Name Finder API

openapi: 3.2.0
info:
  title: Cheapest Domains public Name Finder API
  version: 1.13.0
  description: Lowest standard prices among connected registrars with saved offers matching the query, including labeled samples and labeled registrar API rates; offers that couldn’t be refreshed for a day stay, with their age, until a newer catalog replaces them. Coverage is not the whole market. Public GET-only research access, no authentication. Exact-name availability has a separate provider-scoped endpoint. No purchase, renewal, transfer, or account operations. Query current prices instead of relying on remembered values.
servers:
- url: https://www.cheapest.domains
security: []
tags:
- name: Name Finder
paths:
  /api/v1/name-finder:
    get:
      operationId: open_name_finder
      summary: Find project domain names
      description: Open the naming form in a compatible host, or return its text workflow. Collect seed names, an optional project brief, count and annual renewal budget; the current assistant generates ideas and checks them with the research tools. Opening performs no generation or registrar checks. Does not connect subscriptions or require a model API key.
      security: []
      parameters: []
      responses:
        '200':
          description: Success. Inspect coverage, stale flags, minimum terms and pagination.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NameFinder'
        '400':
          description: Invalid, repeated, unknown, or incompatible parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Endpoint, covered TLD, or connected registrar not found. Not a domain availability result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: 'Request budget or concurrency limit reached. Anonymous calls spend weighted read units: 120 units/minute (burst 30) and 3,000/UTC day per network bucket, within a shared 600/minute (burst 120) and 30,000/UTC-day site-wide cap. Price searches rank the whole saved catalog and cost 10 units each; extension, registrar-coverage, estimate and registrar-link endpoints read one extension or source metadata and cost 1 unit, like other requests. Responses served from the CDN cache spend nothing. Each availability or popularity lookup spends 1 unit more plus one lookup from a separate allowance of 10 lookups/minute (burst 4), 300/UTC day and 3,000 per aligned 32-day window. Shared networks can share a bucket, and provider concurrency limits can also answer 429. Wait for the Retry-After seconds before retrying; do not poll.'
          headers:
            Retry-After:
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Fresh pricing unavailable. Retry after 60 seconds; inspect registrar coverage.
          headers:
            Retry-After:
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Name Finder
components:
  schemas:
    ServiceInformation:
      type: object
      required:
      - name
      - url
      - setupUrl
      - pluginUrl
      description: Cheapest Domains identity and optional setup links, separate from upstream evidence. Does not establish client installation or provider health.
      properties:
        name:
          const: Cheapest Domains
        url:
          type: string
          format: uri
        setupUrl:
          type: string
          format: uri
        pluginUrl:
          type: string
          format: uri
    Error:
      type: object
      required:
      - apiVersion
      - error
      properties:
        apiVersion:
          type: string
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
            message:
              type: string
            retryAfterSeconds:
              type: number
              minimum: 0
    NameFinder:
      type: object
      required:
      - apiVersion
      - service
      - namingUrl
      - generation
      - subscriptionConnections
      - workflow
      - guidance
      properties:
        apiVersion:
          type: string
        service:
          $ref: '#/components/schemas/ServiceInformation'
        namingUrl:
          type: string
          format: uri
        generation:
          const: current_assistant
        subscriptionConnections:
          const: not_configured
          description: Website subscription authentication is not connected. Compatible assistant hosts use their existing account.
        workflow:
          type: string
        guidance:
          type: object
          required:
          - purpose
          - instructions
          - availability
          - futureCapability
          properties:
            purpose:
              type: string
            instructions:
              type: array
              items:
                type: string
            availability:
              const: not_checked
            futureCapability:
              type: string
externalDocs:
  description: Human and AI integration guide
  url: https://www.cheapest.domains/developers