Previsão de Nomes para Bebês¶

O endpoint Previsão de Nomes para Bebês compara candidatos a nomes e retorna insights classificados sobre a adequação do nome. Suporta datas de nascimento esperadas opcionais e pontuação de harmonia com o nome dos pais. Use esta página para regras de parâmetros prontas para integração, opções permitidas e exemplos de resposta.

Endpoint¶

Método	Caminho
`GET`	`https://api.numerologyapi.com/api/v1/baby-name-forecast`
`POST`	`https://api.numerologyapi.com/api/v1/baby-name-forecast`

Disponibilidade¶

Autenticação: X-API-Key (ou Authorization: Bearer YOUR_API_KEY)
Valores suportados de lang: en, es, de, fr, pt, ar, hi, ja
Canal de acesso: API direta (https://api.numerologyapi.com)
Gateway RapidAPI: Não suportado para endpoints extensos
Sistemas numerológicos opcionais: pythagorean, chaldean, vedic (pythagorean é o padrão)

Parâmetros¶

Parâmetros de Consulta GET| Parâmetro | Tipo | Obrigatório | Valor Padrão | Opções | Descrição |¶

|---|---|---|---|---|---| | candidate_names | array[string] | Sim | — | Repetir parâmetro da consulta; máximo 8 | Nomes de bebê sugeridos | | expected_birth_date | string | Não | null | YYYY-MM-DD | Data de nascimento esperada | | parent_names | array[string] | Não | [] | Repetir parâmetro da consulta | Nomes dos pais (opcional) | | num_sys | string | Não | pythagorean | pythagorean, chaldean, vedic | Sistema de numerologia utilizado para cálculos de nome | | lang | string | Não | en | en, es, de, fr, pt, ar, hi, ja | Idioma da resposta |

Parâmetros da Requisição POST (Query)¶

Parâmetro	Tipo	Obrigatório	Valor Padrão	Opções	Descrição
`lang`	`string`	Não	`en`	`en`, `es`, `de`, `fr`, `pt`, `ar`, `hi`, `ja`	Idioma da resposta

Parâmetros do Corpo da Requisição POST| Parâmetro | Tipo | Obrigatório | Padrão | Opções | Descrição |¶

|---|---|---|---|---|---| | candidate_names | array[string] | Sim | — | 1..8 itens | Nomes de bebê candidatos | | expected_birth_date | string \| null | Não | null | YYYY-MM-DD | Data de nascimento esperada | | parent_names | array[string] | Não | [] | Lista opcional | Nomes dos pais (opcional) | | num_sys | string | Não | pythagorean | pythagorean, chaldean, vedic | Sistema de numerologia usado para cálculos de nome |

Exemplos de Requisições¶

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"
}'

Exemplo do Corpo da Requisição (POST)¶

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

Destaques da Resposta¶

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

Exemplo de Resposta¶

{
  "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": "..." }
    }
  ]
}

Abrir Painel

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.