Référence Développeur

Recette de recherche de domaines Documentation de l'API

Recette de recherche de domaines Documentation de l'API: Découverte de domaines alimentée par l'IA avec filtrage et vérification de disponibilité en temps réel.

Recette de recherche de domaines

Découverte de domaines alimentée par l'IA avec filtrage et vérification de disponibilité en temps réel.

GET /v1/recipes/domain-finder

Paramètres de Requête

Paramètre	Type	Description
keywords requis	string	Mots-clés pour les suggestions de domaines
tlds optionnel	string	TLDs séparés par des virgules à vérifier (par défaut : com,io,co,app)

La réponse inclut

AI-generated domain suggestions
Statut de disponibilité en temps réel
Tarification pour les domaines disponibles
Score de marque pour chaque suggestion

Champs de Réponse

Champ	Type
`success`	boolean
`data`	object
`data.results[]`	object[]
`data.results[]`	object
`data.results[].domain`	string
`data.results[].available`	boolean
`data.results[].brand_score`	number
`data.results[].value_estimate`	object
`data.results[].value_estimate.low`	number
`data.results[].value_estimate.mid`	number
`data.results[].value_estimate.high`	number
`data.results[].registration_price`	number
`data.results[].best_registrar`	string
`data.results[].social_availability`	object
`data.results[].social_availability.github`	boolean
`data.results[].social_availability.twitter`	boolean
`data.results[].recommendation_score`	number
`data.results[].notes[]`	string[]
`data.filters_applied`	object
`data.filters_applied.tlds[]`	string[]
`data.filters_applied.style`	string
`data.filters_applied.max_length`	number
`data.alternatives_considered`	number
`data.search_criteria`	object
`data.search_criteria.keywords[]`	string[]
`data.search_criteria.tlds[]`	string[]
`data.search_criteria.style`	string
`data.search_criteria.max_length`	number
`data.search_criteria.budget`	object
`data.search_criteria.budget.max`	number
`data.search_criteria.budget.currency`	string
`data.search_criteria.require_social[]`	string[]
`data.search_criteria.limit`	number
`meta`	object
`meta.recipe_name`	string
`meta.credits_used`	number
`meta.credits_saved`	number
`meta.duration_ms`	number
`meta.components_called[]`	string[]
`meta.cached_components[]`	string[]
`meta.timestamp`	string
`errors[]`	array

Exemple de Réponse

{
  "success": true,
  "data": {
    "results": [
      {
        "domain": "launchgrid.com",
        "available": true,
        "brand_score": 86,
        "value_estimate": {
          "low": 400,
          "mid": 1200,
          "high": 2800
        },
        "registration_price": 10.99,
        "best_registrar": "porkbun",
        "social_availability": {
          "github": true,
          "twitter": false
        },
        "recommendation_score": 92,
        "notes": [
          "Style: brandable",
          "Within budget"
        ]
      }
    ],
    "filters_applied": {
      "tlds": [
        "com",
        "io"
      ],
      "style": "brandable",
      "max_length": 12
    },
    "alternatives_considered": 42,
    "search_criteria": {
      "keywords": [
        "launch",
        "grid"
      ],
      "tlds": [
        "com",
        "io"
      ],
      "style": "brandable",
      "max_length": 12,
      "budget": {
        "max": 20,
        "currency": "USD"
      },
      "require_social": [
        "github",
        "twitter"
      ],
      "limit": 10
    }
  },
  "meta": {
    "recipe_name": "domain-finder",
    "credits_used": 10,
    "credits_saved": 15,
    "duration_ms": 611,
    "components_called": [
      "suggest",
      "availability",
      "valuation",
      "scoring",
      "social",
      "pricing"
    ],
    "cached_components": [
      "pricing"
    ],
    "timestamp": "2026-04-15T10:11:00Z"
  },
  "errors": []
}