Instance performance summary

Returns aggregated performance metrics across all content for the given instances and date range.

What is included:

Organic engagement metrics (engagements, impressions, reach, views)
Paid media metrics (paid engagements, impressions, ad spend, ROAS)
Cost and ROI estimates
Tracking link and affiliate link conversion data

Metric naming

Organic metrics use their plain name (e.g. engagements, impressions, cpm)
Paid metrics are prefixed with paid (e.g. paidEngagements, paidImpressions, paidCpm)
Tracking link metrics are prefixed with trackingLinks (e.g. trackingLinksClicks, trackingLinksConversions)
Affiliate link metrics are prefixed with affiliateLinks (e.g. affiliateLinksClicks, affiliateLinksSales, affiliateLinksRoi)
All metric fields are nullable — null indicates the metric is not available for the given data

Query Parameters

startDate
Type: stringFormat: date-time
required

Start of the reporting period (inclusive). Format: YYYY-MM-DD.
endDate
Type: stringFormat: date-time
required

End of the reporting period (inclusive). Format: YYYY-MM-DD.
instanceIds
Type: array string[]

One or more instance IDs to limit the query scope. If not provided, the query includes all instances accessible with the API credentials.

Supported array formats: param=a,b,c (comma-separated), param=a&param=b (repeated key), or param[]=a&param[]=b (bracket syntax).
campaignIds
Type: array number[] …50

Filter results to specific campaigns. When omitted, all campaigns are included.

Supported array formats: param=a,b,c (comma-separated), param=a&param=b (repeated key), or param[]=a&param[]=b (bracket syntax).
platform
Type: array string[]enum

Filter by top-level platform. Selecting a platform includes all its content types (e.g. instagram includes instagram_post, instagram_reel, instagram_story).

Cannot be combined with contentType — provide only one of the two.

When omitted (and contentType is also omitted), all platforms are included.

Supported array formats: param=a,b,c (comma-separated), param=a&param=b (repeated key), or param[]=a&param[]=b (bracket syntax).
values
- instagram
- tiktok
- facebook
- youtube
- twitter
contentType
Type: array string[]enum
Filter by specific content type for granular filtering beyond top-level platforms.

instagram_post, instagram_reel, instagram_story — specific Instagram content formats

facebook_post, facebook_live, facebook_group, facebook_reel — specific Facebook content formats

tiktok, youtube_video, youtube_shorts — platform-specific types

Cannot be combined with platform — provide only one of the two.

When omitted (and platform is also omitted), all content types are included.

Supported array formats: param=a,b,c (comma-separated), param=a&param=b (repeated key), or param[]=a&param[]=b (bracket syntax).
values
- instagram_post
- instagram_reel
- instagram_story
- facebook_post
- facebook_live
dateBasis
Type: stringenum
Controls which date dimension is used for filtering.

post_date (default): filters by the date the content was originally published. Best for analyzing content output and creator activity over time.

performance_date: returns metrics recorded within the requested date range, regardless of when the content was originally published. Best for understanding how campaigns performed during a specific reporting window.

Example: a post published on Jan 5 that receives engagement on Feb 10 will appear in a Feb 1–28 query with performance_date, but in a Jan 1–31 query with post_date.
values
- post_date
- performance_date

Responses

application/json
application/json
application/json

get/v2/instances/performance

curl 'https://reporting.api.later.com/v2/instances/performance?startDate=2024-01-01&endDate=2024-12-31&instanceIds=instance_abc&instanceIds=instance_def&campaignIds=49761&campaignIds=49802&platform=instagram&platform=tiktok&contentType=instagram_reel&contentType=tiktok&dateBasis=post_date' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": {
    "affiliateLinksClicks": 3400,
    "affiliateLinksConversions": 210,
    "affiliateLinksSales": 18500,
    "campaignsCost": 15000,
    "cpe": 0.33,
    "cpm": 48.08,
    "engagementRate": 14.49,
    "engagements": 45200,
    "estimatedContentCost": 15000,
    "estimatedValueGenerated": 125000,
    "impressions": 312000,
    "paidAdSpend": 8500,
    "paidCpe": 0.66,
    "paidCpm": 45.95,
    "paidEngagementRate": 6.92,
    "paidEngagements": 12800,
    "paidImpressions": 185000,
    "paidPostsCount": 18,
    "paidReturnOnAdSpend": 3.8,
    "paidViews": 42000,
    "postsCount": 142,
    "reach": 280000,
    "returnOnInvestment": 8.33,
    "trackingLinksClicks": 1200,
    "trackingLinksConversionValue": 42000,
    "trackingLinksConversions": 85,
    "views": 95000
  },
  "pagination": null
}

Aggregated performance summary