Analytics API

Retrieve post performance metrics across all platforms. Analytics is bundled with every paid account.

Get Analytics

Returns performance metrics for published posts within a date range.

Query Parameters

• platform — string (required) — Platform name (e.g. instagram, twitter)
• fromDate — string (required) — ISO 8601 date (inclusive, e.g. 2026-01-01)
• toDate — string (required) — ISO 8601 date (inclusive, e.g. 2026-01-31)
• accountId — string (optional) — Filter by specific account ID

Examples

Python

import httpx

resp = httpx.get(
    "https://api.socialsyncerapi.com/v1/analytics",
    headers={"Authorization": "Bearer sk_your_api_key"},
    params={
        "platform": "instagram",
        "fromDate": "2026-01-01",
        "toDate": "2026-01-31"
    }
)
data = resp.json()
for post in data["posts"]:
    print(f"{post['content'][:50]}... - {post['impressions']} impressions")

curl

curl "https://api.socialsyncerapi.com/v1/analytics?platform=instagram&fromDate=2026-01-01&toDate=2026-01-31" \
  -H "Authorization: Bearer sk_your_api_key"

Node.js

const resp = await fetch(
  "https://api.socialsyncerapi.com/v1/analytics?platform=instagram&fromDate=2026-01-01&toDate=2026-01-31",
  { headers: { "Authorization": "Bearer sk_your_api_key" } }
);
const data = await resp.json();
data.posts.forEach(p => console.log(p.content.slice(0, 50) + "...", p.impressions));

Response

{
  "platform": "instagram",
  "fromDate": "2026-01-01",
  "toDate": "2026-01-31",
  "posts": [
    {
      "postId": "post_abc123",
      "platformPostId": "17841400123456789",
      "content": "Beautiful sunset today",
      "publishedAt": "2026-01-15T10:00:00Z",
      "impressions": 12500,
      "reach": 8900,
      "likes": 342,
      "comments": 28,
      "shares": 15,
      "saves": 67,
      "views": 0
    }
  ]
}

Available Metrics by Platform

Instagram

• Impressions: ✅
• Reach: ✅
• Likes: ✅
• Comments: ✅
• Shares: ✅
• Saves: ✅
• Views: ✅

Facebook

• Impressions: ✅
• Likes: ✅
• Comments: ✅
• Shares: ✅
• Clicks: ✅
• Views: ✅

Threads

• Impressions: ✅
• Likes: ✅
• Comments: ✅
• Shares: ✅
• Views: ✅

TikTok

• Likes: ✅
• Comments: ✅
• Shares: ✅
• Views: ✅

Twitter / X

• Impressions: ✅
• Likes: ✅
• Comments: ✅
• Shares: ✅
• Clicks: ✅
• Views: ✅

Error Responses

// 400 - Missing required parameter
{
  "error": "platform is required",
  "type": "invalid_request_error",
  "code": "missing_required_field",
  "param": "platform"
}

// 401 - Unauthorized
{
  "error": "Invalid API key",
  "type": "authentication_error",
  "code": "invalid_credentials"
}