French Public Holidays & Business-Day Engine avatar

French Public Holidays & Business-Day Engine

Pricing

Pay per usage

Go to Apify Store
French Public Holidays & Business-Day Engine

French Public Holidays & Business-Day Engine

French public holidays (jours feries) with 3 modes: list by year/zone, classify dates, and count business/working days in ranges. All zones, cached, parallel. Free.

Pricing

Pay per usage

Rating

0.0

(0)

Developer

DEV DEV

DEV DEV

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

14 hours ago

Last modified

Share

French Public Holidays & Business-Day Engine — Pro

Free Apify actor. Three tools in one around official French public holidays (jours feries): list them, classify arbitrary dates, and count business (working) days in date ranges. Jours feries et calcul de jours ouvres.

Source: official calendrier.api.gouv.fr (Etalab / DINUM). No API key. Open Licence 2.0.

Modes

  • list — every public holiday for the given years and zone (optional month filter). Each item: date, name, weekday, is_weekend.
  • check — for each date in dates: is_holiday (+ name), is_weekend, is_business_day, weekday.
  • businessDays — for each range in ranges ("YYYY-MM-DD..YYYY-MM-DD"): total_days, business_days, weekend_days, holiday_days, and the list of holidays in range.

Supports all zones: metropole, Alsace-Moselle and overseas territories.

Runtime (developer-grade)

Holiday data is fetched once per year and cached; requests run with bounded parallelism (maxConcurrency). Resilient HTTP client (timeout, backoff+jitter, 429/5xx), optional Apify proxy, global maxItems cap, structured logs, and a run summary in the key-value store (OUTPUT).

Output (businessDays, trimmed)

{
"status": "found", "mode": "businessDays", "zone": "metropole",
"start": "2026-01-01", "end": "2026-03-31",
"total_days": 90, "business_days": 62, "weekend_days": 26,
"holiday_days": 2, "holidays_in_range": ["2026-01-01", "2026-04-06"]
}

Every entry yields an item with status: found, not_found, error.

Use cases

  • Compute working days for SLAs, payroll, delivery and billing.
  • Check whether a date is a holiday/weekend before scheduling.
  • Feed HR and planning systems with official holidays by zone.
  • Compare holidays between mainland France and overseas territories.

Limitations & fair use

  • Alsace-Moselle and overseas zones have specific extra holidays; pick the right zone.

More actors by this developer

See the full range of French open-data actors: https://apify.com/vigilant_jasmine