POpostproxy
Calendar

List calendar events

Retrieves a filtered, paginated list of social media calendar events for 2026 — public holidays, awareness days, cultural events, commerce dates, and sensitive/no-post dates. This is a public endpoint; no authentication required.

get/api/calendar

Request

  • Base URL
    https://api.postproxy.dev
  • URL
    https://api.postproxy.dev/api/calendar
  • Auth
    HTTP bearer

Query parameters

categorystring

Filter by category. Comma-separated. Values: post_trigger, sensitive, no_post

typestring

Filter by event type. Comma-separated. Values: public_holiday, fun_holiday, awareness_day, cultural_event, sporting_event, commerce_event, religious_event, seasonal, remembrance

countrystring

Filter by country code (ISO 3166-1 alpha-2). Comma-separated. Also includes global events

tagstring

Filter by tag. Comma-separated. Examples: sports, food, pets, commerce, environment

monthinteger

Filter by month (1-12)

qstring

Search event names (case-insensitive)

fromstring date

Start of date range (YYYY-MM-DD)

tostring date

End of date range (YYYY-MM-DD)

pageinteger

Page number (1-based). Passing 0 returns page 1.

per_pageinteger

Results per page (1-100)

Response

Paginated list of calendar events

totalinteger

Total number of events matching the filters

pageinteger

Current page number

per_pageinteger

Number of results per page

filtersobject

Echo of active filters applied to the request

Changes

No recorded changes to this operation across all 1 revision of this API.