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

Observances with ideas

Returns the observances for a month for a brand, each joined with its generated post idea (if any) — including whether ideas are ready and the idea's title/content/image.

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

Parameters

Query

NameTypeRequiredDescription
socialProfileIdstringrequiredSocial profile ID.
monthintegerrequiredMonth number (1-12).

Headers

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

Request

Request
curl -X GET 'https://api.synup.com/api/v4/social-post-ideas/observances-with-ideas?socialProfileId=&month=' \
  -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": {
    "observancesWithIdeas": [
      {
        "id": 0,
        "title": "string",
        "description": "string",
        "date": "string",
        "imageUrl": "string",
        "isMonthLong": true,
        "ideasReady": true,
        "postIdeaId": "string",
        "postImageUrl": "string",
        "postTitle": "string",
        "postType": "string",
        "postContent": "string",
        "postImagePrompt": "string"
      }
    ]
  }
}

Response body

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