Skip to main content
GET
Get Social Selling best publishing times

Authorizations

x-api-key
string
header
required

Query Parameters

dateFrom
string

First publication day (UTC, inclusive). Defaults to 89 days before dateTo.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-09-01"

dateTo
string

Last publication day (UTC, inclusive). Defaults to today. At most 366 days in total.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-09-01"

identityIds
integer[] | null

List of identity ids to analyse (REST also accepts a comma-separated value). Defaults to every identity the caller may see; ids outside that scope are ignored.

Minimum array length: 1
Example:

"12,34"

includeReposts
boolean
default:false

Count reposts made by the identities. Off by default.

timeZone
string
default:UTC

IANA time zone in which weekdays and hours are computed.

Maximum string length: 100
Example:

"Europe/Madrid"

metric
enum<string>
default:engagement

What "best" means: average engagement (reactions + comments), reactions, comments or impressions per post.

Available options:
impressions,
reactions,
comments,
engagement
minPosts
integer
default:2

Minimum measured posts a slot needs to be ranked.

Required range: 1 <= x <= 1000
limit
integer
default:5

How many best slots to return.

Required range: 1 <= x <= 20

Response

Best publishing slots and weekday/hour averages

status
enum<string>
required
Available options:
success
message
string
required
data
object
required