Docs
Reddit

Insights

Score, upvote ratio, and comment count for Reddit posts.

Fetch lightweight metrics for a published Reddit destination. Reddit does not expose impressions or reach; Onepostly returns score, comment count, and upvote ratio.

Request

curl "https://api.onepostly.com/v1/posts/POST_ID/insights?destinationId=DEST_ID" \
  -H "x-api-key: op_YOUR_KEY"

Requires read.

Normalized fields

FieldMeaning
likesNet score (ups − downs, fuzzed by Reddit)
commentsComment count
engagementlikes + comments (null if both missing)
impressions / reach / shares / saves / playsAlways null

Raw fields

When present, raw includes:

FieldMeaning
scoreSame as metrics.likes
upvote_ratio0–1 ratio of upvotes
num_commentsSame as metrics.comments
subreddit / titleSubmission context
{
  "status": "ready",
  "metrics": {
    "impressions": null,
    "reach": null,
    "likes": 42,
    "comments": 7,
    "shares": null,
    "saves": null,
    "plays": null,
    "engagement": 49
  },
  "raw": {
    "id": "abc123",
    "score": 42,
    "upvote_ratio": 0.95,
    "num_comments": 7,
    "subreddit": "test",
    "title": "Hello from Onepostly"
  }
}

Errors

CodeMeaning
MISSING_EXTERNAL_IDDestination not published
INSIGHTS_PERMISSIONMissing read or unauthorized
INSIGHTS_FAILEDSubmission not found or other hard failure

See also