---
title: "Recommend"
method: POST
path: "/recommend"
tags: ["recommend", "recommend"]
---

# Recommend

`POST /recommend`

## Request

- Base URL: `https://api.etymolt.com`
- URL: `https://api.etymolt.com/recommend`
- Auth: none declared

Single-decision recommendation. Eliminates the founder's mental load of
picking a name conditional on availability. Returns ONE primary + ONE
backup + an optional counter-recommendation against the founder's gut.

## Request body

- RecommendRequest
  - `brief` object
  - `founder_physics` FounderPhysics, required: Calibrates the engine to the founder's actual constraints.
    - `stage` 'pre_seed' | 'seed_to_a' | 'growth'
    - `category` 'dev_tools' | 'b2b_saas' | 'consumer' | 'deep_tech' | 'pharma_bio' | 'fintech' | 'ai_infra' | 'ai_agent'
    - `vertical` 'cleaning' | 'jewelry' | 'restaurant' | 'consulting' | 'ecom_retail' | 'saas_b2b' | 'saas_b2c' | 'trades' | 'health_wellness' | 'personal_services' | 'other': Customer vertical, used for vertical-tuned generation + SEO landing pages. Derived from corpus cluster prevalence (consulting/agency, ecom_retail, food/restaurant, construction/trades, health/wellness top non-SaaS clusters).
    - `domain_budget_usd` integer
    - `tm_litigation_appetite` 'low' | 'medium' | 'high'
    - `international_day_one` boolean
    - `voice_first` boolean
    - `handle_priority` string[]
    - `must_avoid_compounds` boolean
    - `founder_name` string, nullable
  - `founder_gut_choice` string, nullable
  - `candidate_pool` string[], nullable
  - `rfs_id` string, nullable
  - `rfs_audience_override` string, nullable
  - `rfs_unique_benefit_override` string, nullable

## Response `200`

Successful Response

- RecommendResponse
  - `primary` RecommendationCard, required
    - `name` string, required
    - `verdict` 'SHIP' | 'DECIDE' | 'KILL', required
    - `recall` number, required
    - `friction` number, required
    - `signal_quality` number, required
    - `jurors_agree` integer, required
    - `pre_acquired` PreAcquiredReceipt, required
      - `domains` string[], required
      - `handles` string[], required
      - `tm` string, required
      - `kit` string, required
      - `total_committed_usd` number, required
      - `fan_out_status` object
    - `expires_in_seconds` integer, required
    - `valid_until` string, date-time, required
    - `named_risks` NamedRisk[], required
      - `risk` string, required
      - `severity` 'low' | 'medium' | 'high', required
      - `hedge` string, required
      - `auto_mitigated` boolean
    - `trace_id` string, required
    - `spectrum_tier` string, required
  - `backup` RecommendationCard, required
    - `name` string, required
    - `verdict` 'SHIP' | 'DECIDE' | 'KILL', required
    - `recall` number, required
    - `friction` number, required
    - `signal_quality` number, required
    - `jurors_agree` integer, required
    - `pre_acquired` PreAcquiredReceipt, required
      - `domains` string[], required
      - `handles` string[], required
      - `tm` string, required
      - `kit` string, required
      - `total_committed_usd` number, required
      - `fan_out_status` object
    - `expires_in_seconds` integer, required
    - `valid_until` string, date-time, required
    - `named_risks` NamedRisk[], required
      - `risk` string, required
      - `severity` 'low' | 'medium' | 'high', required
      - `hedge` string, required
      - `auto_mitigated` boolean
    - `trace_id` string, required
    - `spectrum_tier` string, required
  - `counter_recommendation` CounterRecommendation
    - `founder_gut_choice` string, nullable
    - `verdict` 'SHIP' | 'DECIDE' | 'KILL'
    - `recall` number, nullable
    - `friction` number, nullable
    - `why_not_primary` string, nullable
  - `confirm_url` string, required
  - `trace_id` string, required
  - `duration_ms` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/etymolt/apis/etymolt-verify-ai-generated-brand-names.md) · [All operations](https://skmtc.dev/etymolt/apis/etymolt-verify-ai-generated-brand-names/llms.txt) · [OpenAPI document](https://skmtc.dev/etymolt/apis/etymolt-verify-ai-generated-brand-names/revisions/7228ffa1efa7?raw)