Get optimal posting times

Analyse historical performance of the workspace's connected accounts and return the best times to publish, both pooled across accounts (global) and per account (individual). A slot is one recommended posting time — a weekday and an hour, in the workspace timezone. Each account is scored across the week and slots come back ranked best-first, so slots: 3 means the three best hours to post. The slot fields only control how much of that ranking is returned: they never change the analysis, and they do not affect heatmap_matrix, which always carries every hour that had signal. Omit entities to analyse every account connected to the workspace. Times are always expressed in the workspace timezone (echoed under meta.timezone); there is no timezone parameter.

post/api/v1/workspaces/{workspace_id}/scheduling/optimal-times

Path parameters

workspace_idstring required

Example:610a1e660cb41530ca40d372

Request body

global_slotsinteger

How many recommended times to return in the pooled global view, best-first.

per_account_slotsinteger

How many recommended times to return for each account that does not set its own slots.

Example request

{
  "entities": [
    {
      "id": "350830594784444"
    }
  ]
}

Response

Recommendations generated. A workspace with too little history still returns 200 — the accounts are listed under meta.missing_entities.

statusboolean

individualobject

Per-account breakdown keyed by account id.

Example response

{
  "status": true,
  "meta": {
    "timezone": "America/New_York"
  },
  "global": {
    "top_recommendations": [
      {
        "rank": 1,
        "day": "Wednesday",
        "date": "2026-08-12",
        "time": "14",
        "score": 100,
        "platform_breakdown": {
          "facebook": 60,
          "instagram": 40
        }
      }
    ]
  },
  "individual": {
    "350830594784444": {
      "platform": "facebook",
      "source": "data_driven",
      "top_recommendations": [],
      "heatmap_matrix": {
        "data": []
      },
      "dates_key": []
    }
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.