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.

Billing: Read request · Rate limit: 120/min

get/v1/social/calendar

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/social/calendar
  • Auth: HTTP bearer

Query parameters

qstring

Search event names (case-insensitive)

tostring date

End of date range (YYYY-MM-DD)

tagstring

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

fromstring date

Start of date range (YYYY-MM-DD)

pageinteger

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

typestring

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

monthinteger

Filter by month (1-12)

countrystring

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

categorystring

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

per_pageinteger

Results per page (1-100)

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

Response

Completed

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
errorstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.