Previsione per il Nome del Bambino¶

L'endpoint Baby Name Forecast confronta i nomi proposti e restituisce informazioni dettagliate sulla compatibilità dei nomi, ordinate. Supporta opzionalmente la data di nascita prevista e il punteggio di armonia con i nomi dei genitori. Utilizza questa pagina per le regole sui parametri pronte per l'integrazione, le opzioni consentite ed esempi di risposta.

Endpoint¶

Metodo	Percorso
`GET`	`https://api.numerologyapi.com/api/v1/baby-name-forecast`
`POST`	`https://api.numerologyapi.com/api/v1/baby-name-forecast`

Disponibilità¶

Autenticazione: X-API-Key (o Authorization: Bearer YOUR_API_KEY)
Valori supportati per lang: en, es, de, fr, pt, ar, hi, ja
Canale di accesso: API diretta (https://api.numerologyapi.com)
Gateway RapidAPI: Non supportato al momento per endpoint estesi
Sistemi numerologici opzionali: pythagorean, chaldean, vedic (pythagorean è il valore predefinito)

Parametri¶

Parametri di query GET¶

Parametro	Tipo	Obbligatorio	Valore predefinito	Opzioni	Descrizione
`candidate_names`	`array[string]`	Sì	`—`	Ripetizione del parametro della query; massimo `8`	Nomi di bambino suggeriti
`expected_birth_date`	`string`	No	`null`	`YYYY-MM-DD`	Data di nascita prevista
`parent_names`	`array[string]`	No	`[]`	Ripetizione del parametro della query	Nomi dei genitori (opzionali)
`num_sys`	`string`	No	`pythagorean`	`pythagorean`, `chaldean`, `vedic`	Sistema di numerologia utilizzato per i calcoli dei nomi
`lang`	`string`	No	`en`	`en`, `es`, `de`, `fr`, `pt`, `ar`, `hi`, `ja`	Lingua della risposta

Parametri della query POST¶

Parametro	Tipo	Obbligatorio	Valore predefinito	Opzioni	Descrizione
`lang`	`string`	No	`en`	`en`, `es`, `de`, `fr`, `pt`, `ar`, `hi`, `ja`	Lingua della risposta

Parametri del corpo POST¶

Parametro	Tipo	Obbligatorio	Valore predefinito	Opzioni	Descrizione
`candidate_names`	`array[string]`	Sì	`—`	`1..8`	Nomi di bambino suggeriti
`expected_birth_date`	`string \\| null`	No	`null`	`YYYY-MM-DD`	Data di nascita prevista
`parent_names`	`array[string]`	No	`[]`	Elenco opzionale	Nomi dei genitori (opzionali)
`num_sys`	`string`	No	`pythagorean`	`pythagorean`, `chaldean`, `vedic`	Sistema di numerologia utilizzato per i calcoli dei nomi

Esempi di Richiesta¶

GET¶

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.numerologyapi.com/api/v1/baby-name-forecast?candidate_names=Maya%20Rose%20Carter&candidate_names=Luna%20Elise%20Carter&expected_birth_date=2026-09-14&num_sys=pythagorean&lang=en"

POST¶

curl -X POST "https://api.numerologyapi.com/api/v1/baby-name-forecast?lang=en" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "candidate_names": ["Maya Rose Carter", "Luna Elise Carter"],
  "expected_birth_date": "2026-09-14",
  "parent_names": ["Nora Carter", "Eli Carter"],
  "num_sys": "pythagorean"
}'

Esempio del Corpo della Richiesta POST¶

{
  "candidate_names": ["Maya Rose Carter", "Luna Elise Carter"],
  "expected_birth_date": "2026-09-14",
  "parent_names": ["Nora Carter", "Eli Carter"],
  "num_sys": "pythagorean"
}

Punti Salienti della Risposta¶

recommended_name
candidate_count
expected_life_path_number
candidates[].combined_fit_score
candidates[].ranking_label
candidates[].meaning
comparison_notes

Esempio di Risposta¶

{
  "numerology_system": "pythagorean",
  "expected_birth_date": "2026-09-14",
  "expected_life_path_number": 6,
  "candidate_count": 2,
  "recommended_name": "Maya Rose Carter",
  "candidates": [
    {
      "candidate_name": "Maya Rose Carter",
      "expression_number": 3,
      "name_birth_harmony_score": 82,
      "combined_fit_score": 85,
      "ranking_label": "Strong Fit",
      "meaning": { "title": "The Expressive Child", "overview": "..." }
    }
  ]
}

Apri il Pannello di Controllo

Nota

This endpoint belongs to the Extended suite and is available through direct API access at https://api.numerologyapi.com. It is currently not supported via the RapidAPI gateway.