Skip to main content
GET
/
analytics
/
twitter
/
{profileId}
/
posts
Twitter post analytics
curl --request GET \
  --url https://app.tryordinal.com/api/v1/analytics/twitter/{profileId}/posts \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440700",
    "url": "https://twitter.com/acme/status/1234567890123456789",
    "text": "Excited to share our latest product update! ๐Ÿš€\n\nAfter months of development, we're launching three new features that will transform how you work.\n\nThread ๐Ÿงต๐Ÿ‘‡",
    "publishedAt": "2024-12-10T14:00:00.000Z",
    "likeCount": 342,
    "replyCount": 28,
    "retweetCount": 89,
    "quoteCount": 15,
    "bookmarkCount": 67,
    "impressionCount": 45200,
    "engagement": 1.2
  },
  {
    "id": "550e8400-e29b-41d4-a716-446655440701",
    "url": "https://twitter.com/acme/status/1234567890123456790",
    "text": "5 lessons learned from scaling our startup from 0 to 10k users ๐Ÿ“ˆ\n\nA thread:",
    "publishedAt": "2024-12-05T09:30:00.000Z",
    "likeCount": 1256,
    "replyCount": 94,
    "retweetCount": 312,
    "quoteCount": 48,
    "bookmarkCount": 234,
    "impressionCount": 89300,
    "engagement": 2.17
  }
]

Authorizations

Authorization
string
header
required

API key authentication. Generate an API key from your workspace settings.

Path Parameters

profileId
string<uuid>
required

Twitter profile ID (UUID)

Query Parameters

startDate
string<date>

Start date for analytics (defaults to 30 days ago)

endDate
string<date>

End date for analytics (defaults to today)

Response

Twitter post analytics

id
string<uuid>
required
url
string<uri>
required

Twitter post URL

text
string | null

Tweet text content

publishedAt
string<date-time> | null
likeCount
integer | null
replyCount
integer | null
retweetCount
integer | null
quoteCount
integer | null
bookmarkCount
integer | null
impressionCount
integer | null
engagement
number | null

Engagement rate as a percentage