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
| Name | Type | Required | Description |
|---|---|---|---|
socialProfileId | string | required | Social profile ID. |
month | integer | required | Month number (1-12). |
Headers
| Name | Type | Required | Description |
|---|---|---|---|
Synup-Version | string | required | API 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'const res = await fetch('https://api.synup.com/api/v4/social-post-ideas/observances-with-ideas?socialProfileId=&month=', {
method: 'GET',
headers: {
Authorization: 'API YOUR_API_KEY',
'Content-Type': 'application/json',
},
});
const data = await res.json();import requests
res = requests.get(
"https://api.synup.com/api/v4/social-post-ideas/observances-with-ideas?socialProfileId=&month=",
headers={
"Authorization": "API YOUR_API_KEY",
"Content-Type": "application/json",
},
)
data = res.json()req, _ := http.NewRequest("GET", "https://api.synup.com/api/v4/social-post-ideas/observances-with-ideas?socialProfileId=&month=", nil)
req.Header.Set("Authorization", "API YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)Responses
| Status | Description |
|---|---|
200 | Successful response |
401 | Unauthorized - 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
| Name | Type | Required | Description |
|---|---|---|---|
data | object | optional | |
data.observancesWithIdeas | array of object | optional | |
data.observancesWithIdeas[].id | integer | optional | |
data.observancesWithIdeas[].title | string | optional | |
data.observancesWithIdeas[].description | string | optional | |
data.observancesWithIdeas[].date | string | optional | |
data.observancesWithIdeas[].imageUrl | string | optional | |
data.observancesWithIdeas[].isMonthLong | boolean | optional | |
data.observancesWithIdeas[].ideasReady | boolean | optional | |
data.observancesWithIdeas[].postIdeaId | string | optional | |
data.observancesWithIdeas[].postImageUrl | string | optional | |
data.observancesWithIdeas[].postTitle | string | optional | |
data.observancesWithIdeas[].postType | string | optional | |
data.observancesWithIdeas[].postContent | string | optional | |
data.observancesWithIdeas[].postImagePrompt | string | optional |