Social media holiday calendar 2026-2027 API

Public holidays in 8 countries plus the awareness days, weeks and months worth planning posts around, November 2026 to December 2027, each with the page its date comes from. Filter by month, country, type and topic, then download your list as a CSV or add it to your calendar.

• Endpoint: GET https://postboost.co/app/api/tools/social-media-holiday-calendar (operationId listAwarenessDays)
• Web tool: postboost.co/tools/social-media-holiday-calendar
• Token: optional (limits)
• MCP: tool list-awareness-days on https://postboost.co/mcp/tools

Request

Query parameter	Type	Default	Description
from	string		First date (YYYY-MM-DD); entries that end on or after it. Omit it for the whole range.
to	string		Last date (YYYY-MM-DD); entries that start on or before it.
country	string: US, GB, CA, AU, IN, DE, FR, TR		Country code: that country's entries plus the worldwide (global) ones.
type	string: public-holiday, awareness-day, awareness-week, awareness-month, social-media-day		Entry type.
topic	string: business, health, environment, food, tech, culture, social-media, family, sport		Topic.

Call it

curl

curl 'https://postboost.co/app/api/tools/social-media-holiday-calendar?from=2026-12-01&to=2026-12-31&country=US'

Python

from postboost import ApiClient, Configuration
from postboost.api.free_tools_api import FreeToolsApi

with ApiClient(Configuration()) as client:
    api = FreeToolsApi(client)
    result = api.list_awareness_days(from='2026-12-01', to='2026-12-31', country='US')
    print(result.to_dict())

Node.js

import { FreeToolsApi } from 'postboost';

const api = new FreeToolsApi();
const { body } = await api.listAwarenessDays('2026-12-01', '2026-12-31', 'US');
console.log(body);

PHP

use PostBoostClient\Api\FreeToolsApi;

$api = new FreeToolsApi(new GuzzleHttp\Client());
$result = $api->listAwarenessDays("2026-12-01", "2026-12-31", "US");
echo $result;

Go

import (
    "context"
    "fmt"

    postboost "github.com/postboost-co/postboost-go"
)

client := postboost.NewAPIClient(postboost.NewConfiguration())
result, _, err := client.FreeToolsAPI.ListAwarenessDays(context.Background()).From("2026-12-01").To("2026-12-31").Country("US").Execute()
fmt.Println(result, err)

Ruby

require 'postboost'

api = PostBoost::FreeToolsApi.new
result = api.list_awareness_days(from: '2026-12-01', to: '2026-12-31', country: 'US')
puts result.to_hash

Java

import com.postboost.ApiClient;
import com.postboost.api.FreeToolsApi;
import com.postboost.model.FreeToolListAwarenessDaysResponse;

FreeToolsApi api = new FreeToolsApi(new ApiClient());
FreeToolListAwarenessDaysResponse result = api.listAwarenessDays("2026-12-01", "2026-12-31", "US");
System.out.println(result.toJson());

C#

using PostBoost.Client.Api;
using PostBoost.Client.Client;

var api = new FreeToolsApi(new Configuration());
var result = await api.ListAwarenessDaysAsync("2026-12-01", "2026-12-31", "US");
Console.WriteLine(result.ToJson());

Rust

use postboost::apis::configuration::Configuration;
use postboost::apis::free_tools_api;

let config = Configuration::new();
let result = free_tools_api::list_awareness_days(&config, Some("2026-12-01"), Some("2026-12-31"), Some("US"), None, None).await?;
println!("{:?}", result);

CLI

./postboost-cli listAwarenessDays from='2026-12-01' to='2026-12-31' country='US'

With a token, send Authorization: Bearer YOUR_API_TOKEN as a default header (how, per SDK).

Response

{
    "covers": {
        "from": "2026-11-01",
        "to": "2027-12-31"
    },
    "total": 8,
    "entries": [
        {
            "name": "GivingTuesday",
            "type": "awareness-day",
            "date": "2026-12-01",
            "end": null,
            "countries": [
                "global"
            ],
            "topics": [
                "business"
            ],
            "source": "https://www.givingtuesday.org/",
            "note": null,
            "idea": "Share one practical tip or story that ties the day's theme to your work, with the organiser's hashtag if it has one."
        },
        {
            "name": "World AIDS Day",
            "type": "awareness-day",
            "date": "2026-12-01",
            "end": null,
            "countries": [
                "global"
            ],
            "topics": [
                "health"
            ],
            "source": "https://www.un.org/en/observances/world-aids-day",
            "note": null,
            "idea": "Share one practical tip or story that ties the day's theme to your work, with the organiser's hashtag if it has one."
        },
        {
            "name": "International Day of Persons with Disabilities",
            "type": "awareness-day",
            "date": "2026-12-03",
            "end": null,
            "countries": [
                "global"
            ],
            "topics": [
                "culture",
                "health"
            ],
            "source": "https://www.un.org/en/observances/day-of-persons-with-disabilities",
            "note": null,
            "idea": "Share one practical tip or story that ties the day's theme to your work, with the organiser's hashtag if it has one."
        },
        {
            "name": "International Volunteer Day",
            "type": "awareness-day",
            "date": "2026-12-05",
            "end": null,
            "countries": [
                "global"
            ],
            "topics": [
                "culture"
            ],
            "source": "https://www.un.org/en/observances/volunteer-day",
            "note": null,
            "idea": "Share one practical tip or story that ties the day's theme to your work, with the organiser's hashtag if it has one."
        },
        {
            "name": "Computer Science Education Week",
            "type": "awareness-week",
            "date": "2026-12-07",
            "end": "2026-12-13",
            "countries": [
                "US"
            ],
            "topics": [
                "tech"
            ],
            "source": "https://www.csedweek.org/",
            "note": null,
            "idea": "Plan a short series: one post on the first day, one midweek and a recap at the end."
        },
        {
            "name": "Human Rights Day",
            "type": "awareness-day",
            "date": "2026-12-10",
            "end": null,
            "countries": [
                "global"
            ],
            "topics": [
                "culture"
            ],
            "source": "https://www.un.org/en/observances/human-rights-day",
            "note": null,
            "idea": "Share one practical tip or story that ties the day's theme to your work, with the organiser's hashtag if it has one."
        },
        {
            "name": "World Meditation Day",
            "type": "awareness-day",
            "date": "2026-12-21",
            "end": null,
            "countries": [
                "global"
            ],
            "topics": [
                "health"
            ],
            "source": "https://www.un.org/en/observances/meditation-day",
            "note": null,
            "idea": "Share one practical tip or story that ties the day's theme to your work, with the organiser's hashtag if it has one."
        },
        {
            "name": "Christmas Day",
            "type": "public-holiday",
            "date": "2026-12-25",
            "end": null,
            "countries": [
                "US"
            ],
            "topics": [
                "family"
            ],
            "source": "https://www.opm.gov/policy-data-oversight/pay-leave/federal-holidays/",
            "note": null,
            "idea": "Post your opening hours or a short greeting, and schedule it the day before so it is live in the morning."
        }
    ],
    "last_verified": "2026-10-17",
    "sources": []
}

With MCP

Connect https://postboost.co/mcp/tools (setup) and ask, for example: List public holidays, awareness days and social media days by date, country, type and topic, with sources with the PostBoost list-awareness-days tool.

Errors

Status	When
401	The Authorization header holds an invalid token. Leave it out to call as a guest.
413	The JSON body is larger than 128 KB.
422	A field is invalid; the body lists the errors per field.
429	A limit is reached; see limits.