Social Media Analytics API

Adeli's analytics API has an endpoint per platform under /api/v1/analytics: Instagram account insights, TikTok account analytics, TikTok account insights, TikTok post insights, Facebook Page metrics, YouTube channel insights, YouTube video insights, LinkedIn account insights, and LinkedIn post insights. GET /api/v1/posts adds per-post engagement, such as likes and comments, for the account's own posts, including ones made outside Adeli. It uses the same API key and connected accounts you publish with.

Last updated

What does Adeli's social media analytics API return?

Account and post insights from Instagram, Facebook, TikTok, YouTube, and LinkedIn, each from its own endpoint under /api/v1/analytics, plus likes, comments, and other engagement on every post through GET /api/v1/posts. Numbers stay in each platform's own terms rather than a flattened shape, because the platforms measure different things.

Account and channel insights

Instagram account insights, TikTok account analytics and insights, Facebook Page metrics, YouTube channel insights, and LinkedIn account insights, each from its own /api/v1/analytics endpoint.

Post and video insights

TikTok post insights and YouTube video insights return watch metrics for specific posts, and LinkedIn post insights return lifetime counters. Instagram media-level and Facebook per-post insights aren't in v1.

Engagement on every post

GET /api/v1/posts lists an account's own posts, including ones made outside Adeli, with likes and comments on each, plus views and shares where the platform reports them.

No extra cost

Analytics ships on Starter and Business, and reading it never counts toward a plan's limits. X's API fees are passed through at X's rates.

Which analytics endpoints does Adeli have for each network?

Nine endpoints across five networks. Instagram and Facebook each have an account-level endpoint, TikTok has three, and YouTube and LinkedIn each have an account endpoint and a post endpoint. X has no analytics endpoint, but its posts appear in GET /api/v1/posts with engagement. The table lists what each endpoint returns.

Adeli's analytics endpoints by network, and what each returns.
NetworkEndpointsWhat it returns
InstagramAccount insightsViews, reach, interactions, and accounts engaged over a rolling 28 days
FacebookPage metricsThe Page's audience, engagement across recent posts, and 28-day Page Insights
TikTokAccount analytics, account insights, post insightsProfile and lifetime counters, daily metrics, follower demographics, and per-post watch metrics
YouTubeChannel insights, video insightsDaily channel metrics, top 10 videos, viewer demographics, and per-video watch metrics
LinkedInAccount insights, post insightsFollowers and a daily series for a Page or profile over 1–30 days, and lifetime counters for up to 5 posts
XNone (engagement via GET /api/v1/posts)Engagement on each of the account's posts

How do you read a post's analytics after publishing it?

Publish with this request, then read the post's engagement from GET /api/v1/posts and its insights from the analytics endpoints.

const res = await fetch("https://app.tryadeli.com/api/v1/posts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: "We shipped it.",
    platforms: ["instagram", "tiktok"],
    publishNow: true,
  }),
});

How much does the social media analytics API cost?

Analytics comes with Starter and Business at no extra charge, and reading it never counts toward a plan's limits. You can start free and build the rest of your integration first. Starter is $29 a month for 10 profiles: 10 profiles cost $29 a month and 100 cost $149. X reads pass through at X's own API rates.

Social Media Analytics API FAQ

How do I get access?

Sign in at app.tryadeli.com with your Google account. That creates your Adeli account, and you can create an API key from the dashboard straight away. You can get started for free, with no credit card.

Is there a dedicated analytics API with its own endpoints?

Yes. Each platform has its own endpoint under /api/v1/analytics: Instagram account insights, TikTok account analytics, TikTok account insights, TikTok post insights, Facebook Page metrics, YouTube channel insights, YouTube video insights, LinkedIn account insights, and LinkedIn post insights. They aren't normalized into one shape, because the platforms measure different things.

What analytics data does Adeli return?

Instagram: views, reach, interactions, and accounts engaged over 28 days. TikTok: profile and lifetime counters, daily metrics and follower demographics, and per-post counters and watch metrics. Facebook: a Page's audience, engagement across recent posts, and 28-day Page Insights. YouTube: daily channel metrics, top videos, demographics, and per-video watch metrics. GET /api/v1/posts adds likes and comments on each post, and more for some platforms, such as views and shares on TikTok.

Does analytics cost extra?

No. Analytics is included in Starter and Business at no extra charge, and reading it never counts toward a plan's limits. The free plan doesn't include analytics. The one exception is X, which charges per API request: Adeli passes X's API usage fees through at X's published rates.

Can I get analytics for posts I didn't publish through Adeli?

Yes. GET /api/v1/posts lists the account's own posts, including posts made outside Adeli, with engagement on each. TikTok post insights and YouTube video insights take those post IDs too. Instagram media-level insights and Facebook per-post insights aren't part of v1.

Do I need a separate OAuth connection to read analytics?

No. Analytics reads use the same connected accounts as publishing. Some read a permission that older connections may lack, such as Facebook's read_insights or YouTube Analytics. Reconnecting the account adds it.

Publish first.
Read the analytics with the same key.

Analytics is included on every tier. Sign in and create your API key in a few minutes.

Start for free