Instance performance summary

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

Response shape: Metrics are nested under data.metrics so the envelope matches the other reporting endpoints (campaigns, creators, posts, networks) and leaves room to add non-metric top-level fields later without breaking existing clients.

What is included:

Metrics requested via the metrics query parameter (returned inside data.metrics)

Supported metric groups:

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

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.
metrics
Type: array string[]
required

Specify one or more metric names to include in the response. Only the selected metrics will be returned within the metrics object for each result item.

Supported values: engagements, impressions, engagementRate, postsCount, reach, views, estimatedValueGenerated, estimatedContentCost, campaignsCost, returnOnInvestment, cpe, cpm, paidEngagements, paidImpressions, paidEngagementRate, paidPostsCount, paidViews, paidAdSpend, paidReturnOnAdSpend, paidCpe, paidCpm, trackingLinksClicks, trackingLinksConversions, trackingLinksConversionValue, affiliateLinksClicks, affiliateLinksConversions, affiliateLinksSales

Metric availability depends on the applied platform or contentType filters. Some metrics are restricted to specific content types (for example, crosspostedFacebookOnlyViews is only available for Instagram Reels). Requesting unsupported metrics will result in a 400 error, along with a list of valid metrics for the current filters.

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

Filter results to specific instances. When omitted, the request is evaluated against every instance associated with your OAuth client; supply one or more values to narrow the response to a subset. Values must be drawn from the set bound to your client credentials — requesting an instance outside that set returns 403 with type: ANL_00403.

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/problem+json
application/problem+json
application/problem+json
application/problem+json

get/v2/instances/performance

curl 'https://reporting.api.later.com/v2/instances/performance?startDate=2025-01-01&endDate=2025-12-31&metrics=&instanceIds=&campaignIds=1&platform=instagram&contentType=instagram_post&dateBasis=post_date' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

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

Aggregated performance summary