API reference

Best times

Suggested slots to schedule into, from the workspace's own publish history.

Base URL https://api.overads.io/public/v1. Every route needs a key with the scope shown, sent as Authorization: Bearer sk_live_YOUR_KEY. The machine-readable contract is at https://api.overads.io/public/v1/openapi.json, no key needed. Scope for this family: posts:read.

GET/best-times#

Scope posts:read. Suggested upcoming times to schedule, from this workspace's own publish history.

When history is thin the slots come from per-platform priors and fromHistory is false. Say which they are when you show them.

Response: { data: { slots: { at, label, score, reason }[], fromHistory: boolean } }. score is a relative strength from 0 to 100.

{
  "data": {
    "slots": [
      { "at": "2026-09-15T17:00:00.000Z", "label": "Tue 6:00 PM", "score": 84, "reason": "Your LinkedIn posts at this hour earned the most engagement over the last 90 days." }
    ],
    "fromHistory": true
  }
}

curl "https://api.overads.io/public/v1/best-times?platform=linkedin" -H "Authorization: Bearer sk_live_YOUR_KEY"