Flavors API Documentation

This API serves your “Flavor of the Day” calendar from the Goodberry’s archive.

Read Endpoints

• ?when=today|yesterday|tomorrow[&tz=Region/City] — relative-day lookup
• ?date=YYYY-MM-DD — explicit date lookup

Flavor-centric Queries

• ?flavor=Name — all dates that flavor appeared
• ?flavor=Name&count=true — number of occurrences
• ?flavor=Name&next=true[&date=YYYY-MM-DD] — next occurrence
• ?flavor=Name&prev=true[&date=YYYY-MM-DD] — previous occurrence

Range & List

• ?from=YYYY-MM-DD&to=YYYY-MM-DD — list of {date,flavor}
• ?month=MM&year=YYYY — month shorthand
• ?distinct=true — unique flavors
• ?list=flavors|dates — full list of names or dates

Utility

• ?random=true — random {date,flavor}
• ?search=term — filter by substring
• ?stats=true — global statistics
• ?stats=true&month=MM — stats across all years for that month
• ?stats=true&month=MM&year=YYYY — stats for a specific month+year
• ?nextdate=true[&date=YYYY-MM-DD] — next calendar date
• ?prevdate=true[&date=YYYY-MM-DD] — previous calendar date

Output Formats

• &format=json|csv|xml (default JSON)
• &callback=fn — JSONP wrapper

Examples

GET  https://flavors.alekdarr.com/docs
GET  https://flavors.alekdarr.com/?when=today
GET  https://flavors.alekdarr.com/?date=2025-05-20
GET  https://flavors.alekdarr.com/?flavor=Nutella&count=true
GET  https://flavors.alekdarr.com/?from=2025-05-01&to=2025-05-10
GET  https://flavors.alekdarr.com/?distinct=true
GET  https://flavors.alekdarr.com/?random=true
GET  https://flavors.alekdarr.com/?search=Cherry
GET  https://flavors.alekdarr.com/?stats=true
GET  https://flavors.alekdarr.com/?stats=true&month=05
GET  https://flavors.alekdarr.com/?stats=true&month=05&year=2025
GET  https://flavors.alekdarr.com/?nextdate=true
GET  https://flavors.alekdarr.com/?prevdate=true