Naamvoorspelling¶

Het Naamvoorspellings-endpoint vergelijkt baby-namen en geeft gerangschikte inzichten over de geschiktheid van namen. Het ondersteunt optionele verwachte geboortedatum en een score voor harmonie tussen ouders en kind. Gebruik deze pagina voor parameterregels, toegestane opties en voorbeeldantwoorden die klaar zijn voor integratie.

Endpoint¶

Methode	Pad
`GET`	`https://api.numerologyapi.com/api/v1/baby-name-forecast`
`POST`	`https://api.numerologyapi.com/api/v1/baby-name-forecast`

Beschikbaarheid¶

Authenticatie: X-API-Key (of Authorization: Bearer YOUR_API_KEY)
Ondersteunde waarden voor lang: en, es, de, fr, pt, ar, hi, ja
Toegangs kanaal: directe API (https://api.numerologyapi.com)
RapidAPI gateway: Niet momenteel ondersteund voor uitgebreide endpoints
Optionele numerologie systemen: pythagorean, chaldean, vedic (pythagorean is de standaard)

Parameters¶

GET Query Parameters¶

Parameter	Type	Vereist	Standaard	Opties	Beschrijving
`candidate_names`	`array[string]`	Ja	`—`	Herhaal query parameter; maximaal aantal `8`	Suggesties voor baby namen
`expected_birth_date`	`string`	Nee	`null`	`YYYY-MM-DD`	Verwachte geboortedatum
`parent_names`	`array[string]`	Nee	`[]`	Herhaal query parameter	Optionele namen van ouders
`num_sys`	`string`	Nee	`pythagorean`	`pythagorean`, `chaldean`, `vedic`	Numerologie systeem voor naam berekeningen
`lang`	`string`	Nee	`en`	`en`, `es`, `de`, `fr`, `pt`, `ar`, `hi`, `ja`	Antwoordtaal

Query Parameters voor POST verzoeken¶

Parameter	Type	Vereist	Standaard	Opties	Beschrijving
`lang`	`string`	Nee	`en`	`en`, `es`, `de`, `fr`, `pt`, `ar`, `hi`, `ja`	Antwoordtaal

Parameters voor het POST Body¶

Parameter	Type	Vereist	Standaard	Opties	Beschrijving
`candidate_names`	`array[string]`	Ja	`—`	`1..8` items	Babynaam suggesties
`expected_birth_date`	`string \\| null`	Nee	`null`	`YYYY-MM-DD`	Verwachte geboortedatum
`parent_names`	`array[string]`	Nee	`[]`	Optionele lijst	Optionele namen van ouders
`num_sys`	`string`	Nee	`pythagorean`	`pythagorean`, `chaldean`, `vedic`	Numerologie systeem voor naamberekeningen

Voorbeeldverzoeken¶

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

Voorbeeld van het POST-lichaam¶

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

Belangrijke punten in de respons¶

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

Voorbeeld van de respons¶

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

Dashboard openen

Opmerking

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.