Facebook Pixel
ApiLinkedin posts

What is queued this week, and whether a boost slot is free

One call that answers both "what is going out this week" and "can I boost, and on which day". Call it before schedule-post so you pick a boost time that has a slot instead of absorbing a 409. A database-only read: no LinkedIn call and no LinkedIn quota spent. It is still paced like every other call on the account (roughly one every 3 seconds), so call it before scheduling rather than polling it in a loop. `scheduledPosts` counts posts by status in the week and buckets them by local day. `boosts.days` gives `used`/`limit`/`hasSlot` for each of the seven days — this is the same per-day view the web calendar uses. `boosts.quota` and `boosts.earliestOpenSlot` describe the window right now: when `canBoostNow` is false, `earliestOpenSlot` is when the next slot frees up. Note that a boost window is NOT a calendar week. Depending on plan it is a local calendar day (multi-boost plans), a window centred on the boost time (Starter/Pro), or a rolling 7 days (free and trial) — so read `quota.limit` as the limit for that window, not for the week.

GET/posts/schedule/week
Authentication requiredPosts

Code Examples

curl -X GET 'https://api.connectsafely.ai/linkedin/posts/schedule/week' \
-H 'Authorization: Bearer <your_api_key>'

One call that answers both "what is going out this week" and "can I boost, and on which day". Call it before schedule-post so you pick a boost time that has a slot instead of absorbing a 409.

A database-only read: no LinkedIn call and no LinkedIn quota spent. It is still paced like every other call on the account (roughly one every 3 seconds), so call it before scheduling rather than polling it in a loop.

scheduledPosts counts posts by status in the week and buckets them by local day. boosts.days gives used/limit/hasSlot for each of the seven days — this is the same per-day view the web calendar uses. boosts.quota and boosts.earliestOpenSlot describe the window right now: when canBoostNow is false, earliestOpenSlot is when the next slot frees up.

Note that a boost window is NOT a calendar week. Depending on plan it is a local calendar day (multi-boost plans), a window centred on the boost time (Starter/Pro), or a rolling 7 days (free and trial) — so read quota.limit as the limit for that window, not for the week.

Parameters

NameInRequiredTypeDescription
accountIdqueryNostringScopes the post list and picks the workspace whose boost quota is reported. Omit to use the default account.
weekStartqueryNostringStart of the 7-day window. Defaults to Monday 00:00 UTC of the current week.
timezonequeryNostringIANA name deciding which local day each post and boost slot falls on. Defaults to UTC.

Request Body

No request body.

Responses

StatusDescription
200Week view
401Unauthorized
500Server error

200 Response Parameters

NameTypeDescription
successboolean
weekStartstring (date-time)
weekEndstring (date-time)
timezonestring
scheduledPostsobject
boostsobject

200 Example

{
  "success": true,
  "weekStart": "2024-01-15T10:30:00.000Z",
  "weekEnd": "2024-01-15T10:30:00.000Z",
  "timezone": "2024-01-15",
  "scheduledPosts": {},
  "boosts": {}
}

401 Response Parameters

NameTypeDescription
errorstring

401 Example

{
  "error": "example_value"
}

500 Response Parameters

NameTypeDescription
errorstring

500 Example

{
  "error": "example_value"
}

On this page