Andras/BoundlessFlowCampus2K

Fork 0

Research API for name day view #974

New issue

Open

opened 2026-05-15 12:24:13 +00:00 by a24julot · 7 comments

a24julot commented

2026-05-15 12:24:13 +00:00

Collaborator

See if there is an API we could use to display todays name day (namnsdag).

a24julot added the

research

unassigned

labels

2026-05-15 12:24:13 +00:00

b24erika was assigned by a24julot

2026-05-18 13:05:33 +00:00

b24erika commented

2026-05-18 13:43:46 +00:00

Collaborator

Damberg Namnsdag API

Swedish name day API (free) that provides full dataset export, name-based search, date-based lookup (month + day) and today endpoint.

API design

Single endpoint api.php which support queries:

?today.
?name=anders.
?month=4&day=12.
no params is full dataset.

Features

Can give exact match, composite name match, partial contains match and closest match. Which also returns a "queryStatus" with the possible values:

Exact match.
Part of composite name match.
Name contains match.
Closest name.

## [Damberg Namnsdag API](https://www.damberg.one/blogg/2024/namnsdagar/api.html) Swedish name day API (free) that provides full dataset export, name-based search, date-based lookup (month + day) and today endpoint. ## API design Single endpoint api.php which support queries: - [?today](https://damberg.one/blogg/2024/namnsdagar/api.php?today). - [?name=anders](https://damberg.one/blogg/2024/namnsdagar/api.php?name=anders). - [?month=4&day=12](https://damberg.one/blogg/2024/namnsdagar/api.php?month=4&day=12). - no params is full [dataset](https://damberg.one/blogg/2024/namnsdagar/api.php). ## Features Can give exact match, composite name match, partial contains match and closest match. Which also returns a "queryStatus" with the possible values: - Exact match. - Part of composite name match. - Name contains match. - Closest name.

b24erika commented

2026-05-18 13:54:50 +00:00

Collaborator

Workgroup Namnsdag API

~~Swedish name day API (free), simple that focused on:~~

~~Name lookup.~~
~~Date lookup.~~
~~Wildcard search (Ann* find all names starting with Ann).~~

API design

~~Easy and clear separation between search and date lookup.~~

~~/api/namnsdag~~
~~/api/namnsdag?sök=anna~~
~~/api/namnsdag?sök=anna~~
~~/api/namnsdag?datum=2026-12-09~~

## ~~[Workgroup Namnsdag API](https://workgroup.se/api/namnsdag/)~~ ~~Swedish name day API (free), simple that focused on:~~ - ~~Name lookup.~~ - ~~Date lookup.~~ - ~~Wildcard search (Ann* find all names starting with Ann).~~ ## ~~API design~~ ~~Easy and clear separation between search and date lookup.~~ - ~~/api/namnsdag~~ - ~~/api/namnsdag?sök=anna~~ - ~~/api/namnsdag?sök=anna~~ - ~~/api/namnsdag?datum=2026-12-09~~

b24erika added

Team 1

and removed

unassigned

labels

2026-05-19 13:51:19 +00:00

b24erika commented

2026-05-19 14:19:17 +00:00

Collaborator

After investigating Workgroup further, it does not appear to be a real JSON API despite what the website states. The data seems to be loaded client-side via JavaScript. I will continue looking into other APIs.

After investigating Workgroup further, it does not appear to be a real JSON API despite what the website states. The [data](https://workgroup.se/namnsdagar.js) seems to be loaded client-side via JavaScript. I will continue looking into other APIs.

b24erika commented

2026-05-19 14:37:17 +00:00

Collaborator

Faboul API

Swedish days API (free), focused on:

Swedish holidays.
Name days.
Flag days.
Date-based lookup.

API design

Easy and structured with date endpoints.

/dagar/v2.1/2015 (year).
/dagar/v2.1/2015/02 (month).
/dagar/v2.1/2015/01/06 (date).
/dagar/v2.1/2015?callback=dinmetod (JSONP).

Features

JSON support.
JSONP support.
HTTPS support.

## [Faboul API](https://sholiday.faboul.se/) Swedish days API (free), focused on: - Swedish holidays. - Name days. - Flag days. - Date-based lookup. ## API design Easy and structured with date endpoints. - [/dagar/v2.1/2015](https://sholiday.faboul.se/dagar/v2.1/2015) (year). - [/dagar/v2.1/2015/02](https://sholiday.faboul.se/dagar/v2.1/2015/02) (month). - [/dagar/v2.1/2015/01/06](http://sholiday.faboul.se/dagar/v2.1/2015/01/06) (date). - /dagar/v2.1/2015?callback=dinmetod (JSONP). ## Features - JSON support. - JSONP support. - HTTPS support.

b24erika commented

2026-05-20 13:00:48 +00:00

Collaborator

Conclusion

Faboul API is the better choice. It returns well-structured JSON data, unlike the Damberg API, whose responses are less organized.

Faboul also uses clearer endpoints while offering additional calendar features such as:

Swedish holidays
Flag days

Another downside of the Damberg API is that its name day data does not always align with "standard" Swedish name days, with some dates containing more than six names (link).

## Conclusion Faboul API is the better choice. It returns well-structured JSON data, unlike the Damberg API, whose responses are less organized. Faboul also uses clearer endpoints while offering additional calendar features such as: - Swedish holidays - Flag days Another downside of the Damberg API is that its name day data does not always align with "standard" Swedish name days, with some dates containing more than six names ([link](https://www.damberg.one/blogg/2024/namnsdagar/)).

b24erika added the

needs review

label

2026-05-20 13:13:01 +00:00

a24julot commented

2026-05-21 08:36:24 +00:00

Author

Collaborator

Requesting review from @f21marfo

f21marfo commented

2026-05-21 09:01:25 +00:00

Collaborator

Review on #974

Whats done

Tested endpoints on Windows 11 25H2 using Edge

Damberg Namsdag API's do not return true JSON results.
- Name endpoint produces a JSON that is often polluted with php-error codes.
Faboul API does return true JSON results.

Conclusion

The research appears sound and I concur with the recommendation of Faboul API over Damberg, the later of which is wholly unsuitable. Especially since the one and only endpoint that yields a true JSON, is frequently polluted.
Of additional note, that should be mentioned, is that the Faboul API JSON's are nested and contain nested key-value pairs as well as nested arrays. I have enclosed an indented version output from the date example above, for clarity.

{
	"cachetid":"2026-05-21 10:54:20","version":"2.1",
	"uri":"\/dagar\/v2.1\/2015\/01\/06",
	"startdatum":"2015-01-06",
	"slutdatum":"2015-01-06",
	"dagar":[
	{
		"datum":"2015-01-06",
		"veckodag":"Tisdag",
		"arbetsfri dag":"Ja",
		"r\u00f6d dag":"Ja",
		"vecka":"02",
		"dag i vecka":"2",
		"helgdag":"Trettondedag jul",
		"namnsdag":["Kasper","Melker","Baltsar"],
		"flaggdag":""
	}]
}

# Review on #974 ## Whats done ### Tested endpoints on Windows 11 25H2 using Edge + Damberg Namsdag API's do not return true JSON results. + Name endpoint produces a JSON that is often polluted with php-error codes. + Faboul API does return true JSON results. ## Conclusion + The research appears sound and I concur with the recommendation of Faboul API over Damberg, the later of which is wholly unsuitable. Especially since the one and only endpoint that yields a true JSON, is frequently polluted. + Of additional note, that should be mentioned, is that the Faboul API JSON's are nested and contain nested key-value pairs as well as nested arrays. I have enclosed an indented version output from the date example above, for clarity. ``` { "cachetid":"2026-05-21 10:54:20","version":"2.1", "uri":"\/dagar\/v2.1\/2015\/01\/06", "startdatum":"2015-01-06", "slutdatum":"2015-01-06", "dagar":[ { "datum":"2015-01-06", "veckodag":"Tisdag", "arbetsfri dag":"Ja", "r\u00f6d dag":"Ja", "vecka":"02", "dag i vecka":"2", "helgdag":"Trettondedag jul", "namnsdag":["Kasper","Melker","Baltsar"], "flaggdag":"" }] } ```