---
name: calendar-holidays
description: Look up public holidays, awareness days, cultural events, commerce dates, and sensitive/no-post dates for 2026 across the world's 20 largest economies. Use when the user wants to plan social media content around holidays, find upcoming events for a country or market, check sensitive dates to avoid posting, or create seasonal content calendars.
version: 1.0.0
allowed-tools: Bash
---

# Calendar Holidays Skill

Query the public social media event calendar for 2026. Covers public holidays, awareness days, cultural events, commerce dates, sporting events, and sensitive/no-post dates across the world's 20 largest economies.

## Base URL

```
https://api.postproxy.dev
```

No authentication required — this is a public endpoint.

## Endpoint

### List calendar events

```bash
curl -X GET "https://api.postproxy.dev/api/calendar"
```

### Query parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `category` | string | Filter by category. Comma-separated. Values: `post_trigger`, `sensitive`, `no_post` |
| `type` | string | Filter by event type. Comma-separated. Values: `public_holiday`, `fun_holiday`, `awareness_day`, `cultural_event`, `sporting_event`, `commerce_event`, `religious_event`, `seasonal`, `remembrance` |
| `country` | string | Filter by ISO 3166-1 alpha-2 country code. Comma-separated. Also includes global events |
| `tag` | string | Filter by tag. Comma-separated. Examples: `sports`, `food`, `pets`, `commerce`, `environment` |
| `month` | integer | Filter by month (1-12) |
| `q` | string | Search event names (case-insensitive) |
| `from` | string | Start of date range (YYYY-MM-DD) |
| `to` | string | End of date range (YYYY-MM-DD) |
| `page` | integer | Page number, zero-indexed (default: 0) |
| `per_page` | integer | Results per page, 1-100 (default: 50) |

### Examples

**Get all events for a country:**
```bash
curl -X GET "https://api.postproxy.dev/api/calendar?country=US"
```

**Get no-post / sensitive dates:**
```bash
curl -X GET "https://api.postproxy.dev/api/calendar?category=no_post,sensitive"
```

**Get Black Friday week events for US:**
```bash
curl -X GET "https://api.postproxy.dev/api/calendar?country=US&from=2026-11-25&to=2026-12-01"
```

**Get all sporting events:**
```bash
curl -X GET "https://api.postproxy.dev/api/calendar?type=sporting_event"
```

**Search by name:**
```bash
curl -X GET "https://api.postproxy.dev/api/calendar?q=coffee"
```

**Combine filters - fun holidays in December with food tag:**
```bash
curl -X GET "https://api.postproxy.dev/api/calendar?type=fun_holiday&month=12&tag=food"
```

**Get upcoming events for a date range:**
```bash
curl -X GET "https://api.postproxy.dev/api/calendar?from=2026-03-01&to=2026-03-31&country=GB"
```

### Response

```json
{
  "total": 284,
  "page": 0,
  "per_page": 50,
  "filters": {},
  "data": [
    {
      "date": "2026-01-01",
      "name": "New Year's Day",
      "type": "public_holiday",
      "category": "post_trigger",
      "countries": ["US", "CN", "DE", "JP", "FR", "IT", "CA", "BR", "KR", "AU", "MX", "ES", "ID", "NL", "TR", "CH"],
      "tags": [],
      "posting_tip": null
    }
  ]
}
```

### Response fields

| Field | Type | Description |
|-------|------|-------------|
| `date` | string | Event date (YYYY-MM-DD) |
| `name` | string | Event name |
| `type` | string | `public_holiday`, `fun_holiday`, `awareness_day`, `cultural_event`, `sporting_event`, `commerce_event`, `religious_event`, `seasonal`, `remembrance` |
| `category` | string | `post_trigger` (good to post), `sensitive` (post with care), `no_post` (stay silent) |
| `countries` | array or null | ISO country codes where applicable, or null for global events |
| `tags` | array | Descriptive tags for filtering |
| `posting_tip` | string or null | Optional social media posting guidance |

## Categories explained

- **post_trigger** - Good opportunity to post. Plan content around these dates.
- **sensitive** - Post with care. Be respectful, avoid commercial tie-ins.
- **no_post** - Brands should stay silent or share only respectful acknowledgment.

## Available countries

`US`, `CN`, `DE`, `JP`, `GB`, `FR`, `IT`, `CA`, `BR`, `KR`, `AU`, `MX`, `ES`, `ID`, `NL`, `TR`, `CH`

## User Request

$ARGUMENTS