Analytics API for Developers

Track engagement, reach, and performance across all connected platforms. Unified metrics in one dashboard.

No credit card required · Full API access

Features

Everything you need

Cross-Platform Metrics

Aggregate likes, shares, comments, impressions, and reach across all 21 platforms into a single normalized data model. Compare apples to apples regardless of the source.

Engagement Tracking

Monitor engagement rate, click-through rate, and interaction breakdowns for every post. Identify your highest-performing content and understand what resonates with your audience.

Audience Insights

Access follower growth, demographics, active hours, and geographic distribution for each connected account. Use data-driven insights to optimize your posting schedule and content strategy.

Performance Comparison

Compare performance across platforms, time periods, content types, or campaigns. Spot trends and outliers with built-in statistical summaries and percentage change calculations.

Historical Data Access

Query up to 24 months of historical analytics data. RelayAPI backfills metrics from the moment you connect an account, so you start with a full picture — not a blank slate.

Export & Reporting

Export analytics data as CSV or JSON for use in your own dashboards, BI tools, or client reports. Schedule automated exports to S3, GCS, or webhook endpoints.

Real-Time Updates

Metrics are refreshed every 15 minutes for active posts and hourly for older content. Request an on-demand refresh for any post when you need the latest numbers immediately.

Custom Date Ranges

Query analytics for any date range — last 7 days, last quarter, or a custom window. All responses include granularity options: hourly, daily, weekly, or monthly roll-ups.

Up and running in minutes

1

Get your API key

Sign up and generate your credentials in seconds.

2

Connect social accounts

Link platforms via OAuth with our guided setup flow.

3

Start building

Use the API to publish, manage, and track content everywhere.

Why developers choose RelayAPI

One Dashboard, Every Metric

Every platform exposes metrics differently — different names, different update frequencies, different auth scopes. RelayAPI normalizes it all into a single, consistent analytics interface.

Enterprise-Grade Reliability

Metrics are collected on a resilient pipeline with 99.9% uptime. Automatic retries on failed fetches, data deduplication, and anomaly detection ensure your analytics are always accurate and available.

Developer-First Experience

Clean JSON responses, cursor-based pagination for large datasets, TypeScript types for every metric, and interactive API explorer. Build beautiful dashboards without wrestling with raw platform data.

Quick start

Start building in minutes

cURL — Post Analytics
curl https:"color:#857f73">//api.relayapi.dev/v1/analytics/posts/post_a1b2c3d4e5 \
  -H "Authorization: Bearer rlay_live_xxxxxxxx"

"color:#857f73"># Response:
"color:#857f73"># {
"color:#857f73">#   "post_id": "post_a1b2c3d4e5",
"color:#857f73">#   "platforms": {
"color:#857f73">#     "twitter": { "impressions": 12450, "likes": 342, "retweets": 87, "replies": 23 },
"color:#857f73">#     "linkedin": { "impressions": 8700, "likes": 156, "comments": 42, "shares": 31 },
"color:#857f73">#     "bluesky": { "impressions": 3200, "likes": 98, "reposts": 24, "replies": 11 }
"color:#857f73">#   },
"color:#857f73">#   "totals": { "impressions": 24350, "engagements": 804, "engagement_rate": 0.033 }
"color:#857f73"># }

Frequently asked questions

What metrics are available?

Core metrics include impressions, reach, engagements (likes, comments, shares, saves, clicks), engagement rate, follower growth, and video-specific metrics (views, watch time, completion rate). Each metric is broken down by platform and available as raw counts or computed rates.

How often are metrics updated?

Posts published within the last 48 hours are refreshed every 15 minutes. Older posts are refreshed hourly. You can trigger an on-demand refresh for any post via the API, which returns updated metrics within 60 seconds. Account-level metrics are updated every 6 hours.

How far back does historical data go?

RelayAPI stores up to 24 months of analytics data. When you first connect a social account, we backfill available historical data from each platform — typically 90 days for most platforms, though some provide up to 12 months of history.

Are metrics available for all supported platforms?

Analytics are available for all 17 supported platforms, but the depth of data depends on what each platform's API exposes. Twitter, LinkedIn, and Instagram provide the richest analytics. Platforms like Mastodon and Bluesky provide core engagement counts. The API clearly indicates which metrics are available per platform.

Can I export analytics data?

Yes. Use the /v1/analytics/export endpoint to download data as CSV or JSON. You can filter by date range, platform, and metric type. For automated reporting, set up scheduled exports that deliver data to your S3 bucket, webhook URL, or email on a daily or weekly cadence.

Ready to start building?

Get your API key and publish across 21 platforms in minutes.