Skip to content

Document how post analytics likes and unlikes are counted - #523

Draft
tcaldwell-x wants to merge 1 commit into
mainfrom
tcaldwell/post-analytics-likes-semantics
Draft

tcaldwell-x wants to merge 1 commit into
mainfrom
tcaldwell/post-analytics-likes-semantics

Conversation

@tcaldwell-x

Copy link
Copy Markdown
Collaborator

Summary

Explains how GET /2/tweets/analytics metrics are counted on the post analytics page (x-api/posts/get-post-analytics.mdx):

  • Event totals in the window, not a snapshot of the Post.
  • Organic only: promoted activity is excluded.
  • Hour-snapped: start_time is rounded down to the hour and end_time up to the next hour. The page includes examples.
  • end_time is exclusive after rounding.
  • Window limits: at most 30 days; end_time at most 1 year in the past and no later than the end of the current hour.
  • Do not subtract unlikes from likes. The difference can be negative. There's a table pointing to public_metrics.like_count / organic_metrics.like_count for current like counts.
  • API version 2.174: likes and unlikes count only user like and unlike events. Earlier versions also count internal corrections that hide or restore a like. Callers opt in with x-api-minor-version: 174.

DEVREL-994.

Merge only after 2.174 ships

The 2.174 section describes behavior that isn't deployed yet. It needs:

Open questions for reviewers

  • This page would be the first public mention of the x-api-minor-version header that I could find. If version pinning shouldn't be documented yet, I'll drop the last sentence.
  • No changelog entry yet. I'll add one when 2.174 is released, if that's the convention.
GET /2/tweets/analytics metrics are organic event totals inside an hour-snapped, end-exclusive window. likes - unlikes is not a like count and can be negative. Documents API 2.174, where likes and unlikes count only user like and unlike events.
@mintlify

mintlify Bot commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
x-corp 🟢 Ready View Preview Oct 29, 2026, 1:31 AM

This branch was successfully deployed

1 active deployment
staging — 5dadbf4b Deployed Oct 29, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant