Skip to content
warmupDocs

Get content insights

GET
/analytics/content
curl --request GET \
  --url 'https://api.warmup.social/analytics/content?role=own&from=2026-09-01&to=2026-09-30&tz=UTC' \
  --header 'Authorization: Bearer <token>'

Content types, the best weekdays and hours to post (in tz) and top hashtags.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
role
string
Allowed values: own competitor

Whose accounts to analyze — your own or competitors.

from
string format: date

Example 

2026-09-01

Period start, YYYY-MM-DD, inclusive. Defaults to 30 days before to. Periods longer than 365 days are cut from the start.

to
string format: date

Example 

2026-09-30

Period end, YYYY-MM-DD, inclusive. Defaults to today in tz.

tz
string
default: UTC

Example 

Europe/Berlin

IANA time zone used to split days.

platform
Array<string>
Allowed values: instagram tiktok facebook

Only these networks. Comma-separated or repeated.

group
Array<string>

Only accounts from these collections (names from “List analytics filters”).

accountId
Array<string>

Only these accounts (ids from “List analytics filters”).

Responses

Section titled “Responses”

200

Section titled “200”

Content insights for the period.

Media typeapplication/json
object
period
required
object
from
required
string format: date
to
required
string format: date
days
required
integer
mediaTypes
required
Array<object>
object
mediaType
required
string
posts
required
integer
avgViews
required
number
nullable
er
required
number
nullable
postingTimes
required
Array<object>
object
weekday
required

ISO weekday in tz, 1 — Monday … 7 — Sunday.

integer
>= 1 <= 7
hour
required
integer
<= 23
posts
required
integer
avgViews
required
number
nullable
topHashtags
required
Array<object>
<= 20 items
object
tag
required
string
posts
required
integer
avgViews
required
number
nullable

Example 

{
  "period": {
    "days": 30
  }
}

401

Section titled “401”

The Bearer token is missing or invalid.

Media typeapplication/json
object
statusCode
required
integer
message
required
One of:
string
error
string
key
additional properties
any

Example 

{
  "statusCode": 400,
  "message": "Invalid request",
  "error": "Bad Request"
}