Best times to post
get_best_timesRetrieve the best hours to publish for a connected account, ranked by audience activity and post history, with source and confidence. Use it to pick posting times per platform and timezone.
Instructions
Best hours to publish for one connected account, from its own audience and post history. Answers best_times (hour, score), by_hour, by_day (0 = Monday), source (audience_activity, account_posts, upload_post_history or none) and confidence; with too little history source is none and best_times is empty. Results are cached for 24 hours (YouTube 7 days). To fill the posting queue with these hours automatically, use update_queue_settings with slots "auto".
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"profile_username": "<profile_username>",
"platform": "<platform>"
},
"name": "get_best_times"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | How many best hours to return. Default 5. | |
| refresh | No | Recompute when the cached answer is at least 24 hours old (YouTube 7 days). | |
| page_urn | No | LinkedIn only: organization Page id or URN managed by the connection. | |
| platform | Yes | ||
| timezone | No | IANA timezone for the hours, e.g. Europe/Madrid. Default: the queue's timezone, else UTC. | |
| facebook_page_id | No | Facebook only: Page id managed by the connection. | |
| profile_username | Yes | Upload-Post profile name. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No |