Analytics · Analytics

Get a post's authenticity score

Fetches a post's authenticity score.

GEThttps://api.pozy.ai/v1/posts/{postId}/authenticity
Instagram, Facebook, TikTok, YouTube, X and Threads and 5 moregetPostAuthenticity

Guides: Tracking and authenticity, Platform insights

Request

Send your API key as Authorization: Bearer pz_live_.... Read-only keys can call it. Keys with the analytics resource group disabled get 403 resource_group_disabled. Authentication

Path parameters

NameTypeNotes
postIdrequiredstring

Example

curl -X GET "https://api.pozy.ai/v1/posts/6108a2cc742cb4e991051e0c/authenticity" \
  -H "Authorization: Bearer $POZY_API_KEY"

Response

200 on success

  • postIdstringrequired
  • scoreintegerrequired

    0 to 100.

  • confidencenumberrequired

    0 to 1.

  • reasonsarray of objectrequired
    • codestringrequired

      One of late_block, flat_engagement, view_follower_gap, cap_seeking, prior_flags, no_watch_signal.

    • weightnumberrequired
  • versionstringrequired
  • computedAtstring (date-time)required
  • sampleCountintegerrequired
200 response
{
  "postId": "6108a2cc742cb4e991051e0c",
  "score": 1,
  "confidence": 12.5,
  "reasons": [
    {
      "code": "late_block",
      "weight": 12.5
    }
  ],
  "version": "string",
  "computedAt": "2026-10-02T09:00:00.000Z",
  "sampleCount": 42
}

Errors

Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:

400invalid_request_errorA parameter or body field is missing or invalid. param names it.
401authentication_errorThe API key is missing, revoked or expired.
403permission_errorThe key is scoped to other profiles or has this resource group disabled.
404not_foundNothing with that id exists in your workspace.
429rate_limit_errorToo many requests this minute. Wait for Retry-After seconds.

Every code is listed in Errors.

More in Analytics