API resource
Dashboard and verified tracking
One call for a whole analytics dashboard (totals, follower growth, a per-day series, top and recent posts, the previous period to compare), plus verified tracking: open a window on any post, even one you did not publish, and every reading comes from the network itself. Authenticity scores flag posts whose numbers look inflated. Facebook visitor and tagged posts are what other people posted on or about your Page.
Get an analytics dashboard
/v1/analytics/dashboardWorks on: Every network
Query parameters
platformstringPlatform to cover (e.g. "instagram"), or "all".
fromDatestringrequiredFirst day of the window (YYYY-MM-DD, inclusive).
toDatestringrequiredLast day of the window (YYYY-MM-DD, inclusive). May equal fromDate. The window covers at most 366 days.
comparestringSet to "previous_period" to also return previousTotals and previousFollowers for the window of the same length that ends the day before fromDate. One of: previous_period.
topPostsintegerHow many top posts to return, ranked by engagement (likes, comments, shares and saves, the same sum as daily engagement).
recentPostsintegerHow many of the most recently published posts to return.
curl "https://creatoros-production-5658.up.railway.app/v1/analytics/dashboard?fromDate=%3CfromDate%3E&toDate=%3CtoDate%3E" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"dateRange": {
"fromDate": "2026-10-10T00:00:00.000Z",
"toDate": "2026-10-10T00:00:00.000Z"
},
"totals": {
"impressions": 0,
"reach": 0,
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"clicks": 0,
"views": 0,
"engagementRate": 0
},
"previousTotals": {
"impressions": 0,
"reach": 0,
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"clicks": 0,
"views": 0,
"engagementRate": 0
},
"followers": {
"current": 0,
"gained": 0,
"byAccount": [
{
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"platform": "social",
"current": 0,
"gained": 0
}
]
},
"previousFollowers": {
"current": 0,
"gained": 0,
"byAccount": [
{
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"platform": "social",
"current": 0,
"gained": 0
}
]
},
"daily": [
{
"date": "2026-10-10T00:00:00.000Z",
"impressions": 0,
"reach": 0,
"engagement": 0,
"views": 0,
"followersGained": 0
}
],
"topPosts": [
{
"postId": "post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9",
"platform": "social",
"publishedAt": "2026-10-10T00:00:00.000Z",
"metrics": {
"impressions": 0,
"reach": 0,
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"clicks": 0,
"views": 0,
"engagementRate": 0
}
}
],
"recentPosts": [
{
"postId": "post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9",
"platform": "social",
"publishedAt": "2026-10-10T00:00:00.000Z",
"metrics": {
"impressions": 0,
"reach": 0,
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"clicks": 0,
"views": 0,
"engagementRate": 0
}
}
],
"dataAsOf": "2026-10-10T00:00:00.000Z"
}List tracking windows
/v1/analytics/trackingWorks on: Every network
Query parameters
accountIdstringOnly windows for this connected account.
statusstringOnly windows in this status. One of: open, completing, completed, cancelled.
limitintegerPage size.
skipintegerNumber of windows to skip.
curl "https://creatoros-production-5658.up.railway.app/v1/analytics/tracking" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"windows": [
{
"id": "string",
"postId": "post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9",
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"platform": "tiktok",
"platformPostId": "string",
"startsAt": "2026-10-10T00:00:00.000Z",
"endsAt": "2026-10-10T00:00:00.000Z",
"status": "open",
"finalReadAt": "2026-10-10T00:00:00.000Z",
"completionReason": "final_read",
"requestedBy": "string",
"latest": {
"views": 0,
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"syncedAt": "2026-10-10T00:00:00.000Z"
}
}
]
}Open a tracking window
/v1/analytics/trackingWorks on: Every network
Body
postIdstringId of an external post. Required unless accountId and url are both sent.
accountIdstringConnected account the post belongs to. Send together with url.
urlstringPublic URL of the post on the platform. Send together with accountId.
trackingDaysintegerHow many days the window stays open.
requestedBystringFree-form label for who asked for the window. It is stored and returned as given.
curl -X POST "https://creatoros-production-5658.up.railway.app/v1/analytics/tracking" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"postId": "post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9"
}'{
"window": {
"id": "string",
"postId": "post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9",
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"platform": "tiktok",
"platformPostId": "string",
"startsAt": "2026-10-10T00:00:00.000Z",
"endsAt": "2026-10-10T00:00:00.000Z",
"status": "open",
"finalReadAt": "2026-10-10T00:00:00.000Z",
"completionReason": "final_read",
"requestedBy": "string",
"latest": {
"views": 0,
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"syncedAt": "2026-10-10T00:00:00.000Z"
}
}
}Get a tracking window
/v1/analytics/tracking/{windowId}Works on: Every network
Path parameters
windowIdstringrequiredcurl "https://creatoros-production-5658.up.railway.app/v1/analytics/tracking/obj_Tw3Kq8Vw1Nx6Ty3Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"window": {
"id": "string",
"postId": "post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9",
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"platform": "tiktok",
"platformPostId": "string",
"startsAt": "2026-10-10T00:00:00.000Z",
"endsAt": "2026-10-10T00:00:00.000Z",
"status": "open",
"finalReadAt": "2026-10-10T00:00:00.000Z",
"completionReason": "final_read",
"requestedBy": "string",
"latest": {
"views": 0,
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"syncedAt": "2026-10-10T00:00:00.000Z"
}
}
}Cancel a tracking window
/v1/analytics/tracking/{windowId}Works on: Every network
Path parameters
windowIdstringrequiredcurl -X DELETE "https://creatoros-production-5658.up.railway.app/v1/analytics/tracking/obj_Tw3Kq8Vw1Nx6Ty3Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"window": {
"id": "string",
"postId": "post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9",
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"platform": "tiktok",
"platformPostId": "string",
"startsAt": "2026-10-10T00:00:00.000Z",
"endsAt": "2026-10-10T00:00:00.000Z",
"status": "open",
"finalReadAt": "2026-10-10T00:00:00.000Z",
"completionReason": "final_read",
"requestedBy": "string",
"latest": {
"views": 0,
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"syncedAt": "2026-10-10T00:00:00.000Z"
}
}
}Get post samples
/v1/analytics/samplesWorks on: Every network
Query parameters
postIdstringrequiredThe post to read samples for. Accepts an external post id, a platform post id or a Creator OS post id.
fromDatestringEarliest sample to return (ISO 8601).
toDatestringLatest sample to return (ISO 8601).
limitintegerMaximum number of samples.
curl "https://creatoros-production-5658.up.railway.app/v1/analytics/samples?postId=post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"postId": "post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9",
"samples": [
{
"syncedAt": "2026-10-10T00:00:00.000Z",
"views": 0,
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"watchSeconds": 0,
"completionRate": 0
}
]
}List authenticity scores
/v1/analytics/authenticityWorks on: Every network
Query parameters
accountIdstringrequiredThe connected account to list scores for.
minScoreintegerOnly scores at or above this value.
maxScoreintegerOnly scores at or below this value.
fromstringOnly scores computed at or after this time (ISO 8601).
tostringOnly scores computed at or before this time (ISO 8601).
limitintegerPage size.
skipintegerNumber of scores to skip.
curl "https://creatoros-production-5658.up.railway.app/v1/analytics/authenticity?accountId=acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"scores": [
{
"postId": "post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9",
"score": 0,
"confidence": 0,
"reasons": [
{}
],
"version": "string",
"computedAt": "2026-10-10T00:00:00.000Z",
"sampleCount": 0
}
]
}Get a post's authenticity score
/v1/posts/{postId}/authenticityWorks on: Every network
Path parameters
postIdstringrequiredAn external post id, a platform post id or a Creator OS post id.
curl "https://creatoros-production-5658.up.railway.app/v1/posts/post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9/authenticity" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"postId": "post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9",
"score": 0,
"confidence": 0,
"reasons": [
{
"code": "late_block",
"weight": 0
}
],
"version": "string",
"computedAt": "2026-10-10T00:00:00.000Z",
"sampleCount": 0
}Sync an external post
/v1/posts/sync-externalWorks on: Every network
Body
accountIdstringrequiredaccount id whose posts to sync. Must be connected to Creator OS.
urlstringThe post URL to locate. Optional. Provide url or postId to return a specific post; omit both to refresh and return the account's recent posts.
postIdstringThe platform post/media/video id to locate, as an alternative to url. Optional.
curl -X POST "https://creatoros-production-5658.up.railway.app/v1/posts/sync-external" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r"
}'{
"synced": {
"postsFound": 0,
"postsSynced": 0,
"skipped": true
},
"found": true,
"post": {
"platform": "social",
"platformPostId": "string",
"platformPostUrl": "string",
"content": "string",
"publishedAt": "2026-10-10T00:00:00.000Z",
"mediaType": "string",
"thumbnailUrl": "string",
"mediaItems": [
{}
],
"mediaProductType": "string",
"isAiGenerated": true,
"isSharedToFeed": true,
"mediaAudioType": "string",
"upcomingStartAt": "2026-10-10T00:00:00.000Z",
"isOwner": true,
"analytics": {
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"sends": 0,
"clicks": 0,
"views": 0,
"reach": 0,
"impressions": 0,
"engagementRate": 0,
"lastUpdated": "2026-10-10T00:00:00.000Z"
}
},
"posts": [
{
"platform": "social",
"platformPostId": "string",
"platformPostUrl": "string",
"content": "string",
"publishedAt": "2026-10-10T00:00:00.000Z",
"mediaType": "string",
"thumbnailUrl": "string",
"mediaItems": [
{}
],
"mediaProductType": "string",
"isAiGenerated": true,
"isSharedToFeed": true,
"mediaAudioType": "string",
"upcomingStartAt": "2026-10-10T00:00:00.000Z",
"isOwner": true,
"analytics": {
"likes": 0,
"comments": 0,
"shares": 0,
"saves": 0,
"sends": 0,
"clicks": 0,
"views": 0,
"reach": 0,
"impressions": 0,
"engagementRate": 0,
"lastUpdated": "2026-10-10T00:00:00.000Z"
}
}
]
}List visitor posts on a Facebook Page
/v1/accounts/{accountId}/facebook-visitor-postsWorks on: Every network
Path parameters
accountIdstringrequiredThe ID of a connected Facebook Page account.
Query parameters
limitintegerNumber of Page feed entries to scan. The Page's own posts are dropped from them.
cursorstringThe nextCursor of the previous page.
curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r/facebook-visitor-posts" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"data": [
{
"id": "string",
"message": "string",
"createdTime": "2026-10-10T00:00:00.000Z",
"from": {
"id": "string",
"name": "string"
},
"permalinkUrl": "string",
"media": {
"mediaType": "image",
"thumbnailUrl": "string",
"mediaItems": []
}
}
],
"nextCursor": "string"
}List the posts a Facebook Page is tagged in
/v1/accounts/{accountId}/facebook-tagged-postsWorks on: Every network
Path parameters
accountIdstringrequiredThe ID of a connected Facebook account.
Query parameters
limitintegerPage size.
cursorstringThe nextCursor of the previous page.
curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r/facebook-tagged-posts" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"data": [
{
"id": "string",
"message": "string",
"createdTime": "2026-10-10T00:00:00.000Z",
"taggedTime": "2026-10-10T00:00:00.000Z",
"permalinkUrl": "string",
"pictureUrl": "string",
"from": {
"id": "string",
"name": "string"
}
}
],
"nextCursor": "string"
}