Skip to content
SynupAPI
Get an API key
GETapi.synup.com/api/v4/social-post-ideas/observances

Observances

Returns the observances (holidays, awareness days, etc.) for a given month, optionally scoped to a social profile and narrowed to a specific day. Each item includes whether ideas are ready and any generated post idea preview.

Requires an API key. Send it as Authorization: API <your-key> — see Getting started.

Parameters

Query

NameTypeRequiredDescription
monthintegerrequiredMonth number (1-12).
dateintegeroptionalDay of the month to narrow to.
socialProfileIdstringoptionalSocial profile ID to scope relevance/ideas to.

Headers

NameTypeRequiredDescription
Synup-VersionstringrequiredAPI version date (YYYY-MM-DD).

Request

Request
curl -X GET 'https://api.synup.com/api/v4/social-post-ideas/observances?month=&date=&socialProfileId=' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Responses

StatusDescription
200Successful response
401Unauthorized - Invalid or missing API key
Example response (generated from the schema)
{
  "data": {
    "observances": [
      {
        "id": 0,
        "title": "string",
        "description": "string",
        "date": "string",
        "imageUrl": "string",
        "isMonthLong": true,
        "isRelevant": true,
        "ideasReady": true,
        "postIdeaId": "string",
        "postImageUrl": "string",
        "postTitle": "string",
        "postType": "string",
        "postContent": "string",
        "postImagePrompt": "string"
      }
    ]
  }
}

Response body

NameTypeRequiredDescription
dataobjectoptional
data.observancesarray of objectoptional
data.observances[].idintegeroptional
data.observances[].titlestringoptional
data.observances[].descriptionstringoptional
data.observances[].datestringoptional
data.observances[].imageUrlstringoptional
data.observances[].isMonthLongbooleanoptional
data.observances[].isRelevantbooleanoptional
data.observances[].ideasReadybooleanoptional
data.observances[].postIdeaIdstringoptional
data.observances[].postImageUrlstringoptional
data.observances[].postTitlestringoptional
data.observances[].postTypestringoptional
data.observances[].postContentstringoptional
data.observances[].postImagePromptstringoptional