Plans & Pillars
List Bob content plans
Lists Bob's weekly content plans for one LinkedIn profile: every item's topic/angle/format/status/target day/pillar, plus a pillar-distribution aggregate.
GET
/api/public/content-planscURLGET /api/public/content-plans
curl "https://postiv.ai/api/public/content-plans?integrationId=123" \
-H "Authorization: Bearer pk_postiv_..."200Response
{
"success": true,
"integrationId": 1234,
"weekStart": "2026-07-13",
"weeksRequested": 1,
"plans": [
{
"id": "p1...",
"profileId": 1234,
"weekStart": "2026-07-13",
"status": "active",
"items": [
{
"id": "i1...",
"position": 0,
"topic": "Why most B2B content fails",
"angle": "contrarian",
"goal": "engagement",
"hookPattern": "myth-vs-fact",
"targetDay": "2026-07-14",
"status": "planned",
"postId": null,
"carouselId": null,
"contentFormat": "text",
"pillar": "Content Strategy"
}
]
}
],
"pillarDistribution": [
{
"pillar": "Content Strategy",
"count": 1,
"percentage": 100
}
],
"hasPreviousWeek": true,
"hasNextWeek": false
}Authorization
Requires an organization API key with the plans:read scope, sent as Authorization: Bearer or x-api-key.
Query parameters
integrationIdintrequiredLinkedIn profile id.
weekStartstringYYYY-MM-DD, normally a Monday. Defaults to the current week (computed server-side).
weeksAheadintdefault: 11-4 consecutive weeks.
Response
Plans for the requested week range.
integrationIdintweekStartstringResolved first week (YYYY-MM-DD).
weeksRequestedintplans[].iduuidplans[].profileIdintplans[].weekStartstringplans[].statusstringplans[].items[].iduuidplans[].items[].positionintplans[].items[].topicstringplans[].items[].anglestring|nullplans[].items[].goalstring|nullplans[].items[].hookPatternstring|nullplans[].items[].targetDaystring|nullYYYY-MM-DD.
plans[].items[].statusstringplans[].items[].postIduuid|nullplans[].items[].carouselIduuid|nullplans[].items[].contentFormatstring|nullplans[].items[].pillarstring|nullpillarDistribution[].pillarstringpillarDistribution[].countintpillarDistribution[].percentagefloatAcross all items in the returned weeks.
hasPreviousWeekbooleanhasNextWeekbooleanErrors
| 400 | invalid_integration_id / invalid_week_start / invalid_weeks_ahead: malformed params |
| 404 | linkedin_profile_not_found: profile not in this workspace |
Good to know
- Call get_content_plan_item / GET /api/public/content-plan-items/:id before drafting a selected item to get its exact hook and saved source material.