API referenceAnalytics

GET /api/v1/analytics/best-time

Best UTC weekday/hour slots from published posts with metrics, falling back to Instagram online followers or defaults

GET
/api/v1/analytics/best-time

Authorization

BearerAuth
headerAuthorizationBearer <token>

API key sk_...

Query Parameters

accountId?string

Only this account

days?integer

Look-back window

Range1 <= value <= 365
Default90

Response Body

BestTime

application/json
  1. response
days?integer
timezone?"UTC"
Value in"UTC"
basedOnPosts?integer
accountId?string
source?string

history needs at least 3 published posts with metrics; then Instagram online followers; then defaults

Value in"history""online_followers""default"
onlineFollowersAccountId?string
slots?array<>

Top 5 slots

Example Request
curl -X GET 'https://example.com/api/v1/analytics/best-time'
Example Response
{  "days": 0,  "timezone": "UTC",  "basedOnPosts": 0,  "accountId": "string",  "source": "history",  "onlineFollowersAccountId": "string",  "slots": [    {      "dayOfWeek": 0,      "hour": 0,      "avgEngagement": 0,      "posts": 0,      "onlineFollowers": 0    }  ]}

POST /api/v1/posts/sync-external POST

Read the account's recent posts from the platform now (including posts published outside Postgale) and store today's metrics for each. With postId or url, returns that post ({found, post})

GET /api/v1/analytics/facebook/page-insights GET

Facebook Page insights in Zernio's envelope (default page_media_view, page_post_engagements, page_follows; also page_views_total, page_video_views, page_video_view_time, content_monetization_earnings, monetization_approximate_earnings). At most 89 days, default the last 30. followers_gained / followers_lost are listed in unavailableMetrics