v3

latestOpenAPI 3.1.02026-08-016689273.4 KB
Analytics

X post analytics

Retrieve post analytics for an X profile within a date range. When a post was published from Ordinal, the response includes an ordinalPost object with the linked post's id, title, labels, and campaign.

get/analytics/x/{profileId}/posts

Path parameters

profileIdstring uuid required

X profile ID (UUID)

Query parameters

startDatestring date

Start date for analytics (defaults to 30 days ago)

endDatestring date

End date for analytics (defaults to today)

Response

X post analytics

idstring uuid required
urlstring uri required

Twitter post URL

textstring nullable

Tweet text content

publishedAtstring date-time nullable
likeCountinteger nullable
replyCountinteger nullable
retweetCountinteger nullable
quoteCountinteger nullable
bookmarkCountinteger nullable
impressionCountinteger nullable
engagementnumber nullable

Engagement rate (total engagements / impressions), typically between 0 and 1

emvnumber nullable

Earned Media Value calculated as (impressionCount / 1000) * CPM