openapi: 3.2.0
info:
title: Later Influence™ Campaign Level API
description: "\n# Description\nThe Reporting API enables deep analysis and reporting of marketing campaigns, social media performance, and influencer effectiveness.\nIt provides comprehensive performance insights at multiple levels:\n- Instance Level: Get instance details, overall performance, and performance over time\n- Campaign Level: Retrieve detailed campaign performance metrics\n- Social Network Level: Analyze performance across different social networks and calculate return on investment\n- Influencer Level: Evaluate individual influencer performance\n- Post Level: Access granular performance data for individual posts\n\n# Authentication\nIn order to use the Reporting API, OAuth2 authentication is required. The API uses the client credentials flow for authentication. To obtain an access token:\n\n1. Request the client credentials (client ID and client secret) from the support team.\n2. Make a POST request to the token endpoint: `https://api.mavrck.co/oauth/token`, including your client credentials in the request body.\n\nCurl Example: \n```\ncurl --request POST \\\n --url 'https://api.mavrck.co/oauth/token' \\\n --header 'Content-Type: application/json' \\\n --header 'accept: application/json' \\\n --data '{\n \"clientId\": \"<client_id>\",\n \"clientSecret\": \"<client_secret>\"\n }'\n```\n\n3. Include the obtained access token in the Authorization header of your API requests:\n\nCurl Example: \n```\ncurl --request GET \\\n --url 'https://api.mavrck.co/v1/reporting/instance/details' \\\n --header 'Content-Type: application/json' \\\n --header 'accept: application/json' \\\n --header 'Authorization: Bearer **<your_access_token>**' \\\n```\n\nFor security reasons, access tokens have a limited lifespan of 12 hours. You should implement a mechanism to refresh the token when it expires.\n\n# Data Availability\n- Most endpoints return analytics that are current up to the previous day, as several social media platforms apply a 24-hour reporting delay.\n- Data access is limited to the specific account or instances associated with the provided API credentials.\n- Analytics are recorded on a daily basis and appear only when they fall within the selected date-range filters. For example, if a post was published a week ago but receives its first interaction today, that interaction will only be included when today’s date is part of the chosen range.\n\n# Base Filters\nAll endpoints support the following filters:\n- `startDate` (ISO 8601 format, e.g. 2024-01-01)\n- `endDate` (ISO 8601 format, e.g. 2024-01-01). There is a limit of up to 2 years for the selected date range.\n- `instanceIds` array of instance ids. If not provided, all instances associated with the API credentials will be considered.\n- `campaignIds` array of campaign ids, if no campaign ids are provided, all campaigns for the instance will be used\n- `reportingGroupIds` array of reporting group ids, if no reporting group ids are provided, all reporting groups for the instance will be used\n\n# Pagination\n- The pagination is available for endpoints returning large datasets.\n- Use `pageSize` and `pageNumber` query parameters to control the results. For the `pageSize` parameter, the default is 50 and the maximum is 100.\n\n# Versioning\n- API versioning supported through URI path\n\n# Changelog\n\n---\n\n## 2025-11-25 Introduce Multi-instance support\n### Added\n- `GET /instances` API - Retrieve the list of instances accessible by the provided API credentials.\n- `GET /instances/details` API - Get detailed information about the instances associated with the provided API credentials such as `influencersCount`, `campaignsCount`, and other relevant metrics. It is similar to the existing `GET /instance/details` endpoint but supports multiple instances.\n\n### Changed\n- All endpoints now support an `instanceIds` query parameter, allowing you to filter results by specific instance IDs when your credentials have access to multiple instances.\n- `GET /campaigns/performance` response includes a new string field `instanceId`.\n- `GET /post/performance` response includes a new string field `instanceId`.\n\n"
version: 1.2.1
contact:
name: Developer
url: https://help-influence.later.com/hc/en-us
email: urvash.chheda@later.com
termsOfService: https://later.com/terms/
servers:
- url: https://api.mavrck.co
security:
- JWT: []
tags:
- name: Campaign Level
paths:
/v1/reporting/campaign/performance:
get:
description: Get campaign performance details.
operationId: getCampaignPerformance
parameters:
- name: startDate
required: true
in: query
description: Start date for the report, YYYY-MM-dd format
schema:
format: date-time
type: string
- name: endDate
required: true
in: query
description: End date for the report, YYYY-MM-dd format
schema:
format: date-time
type: string
- name: instanceIds
required: false
in: query
description: A list of instance ids. If not provided, all instances associated with the API credentials will be considered.
schema:
type: array
items:
type: string
- name: campaignIds
required: false
in: query
description: A list of campaign ids (max 50 items)
schema:
type: array
items:
type: number
- name: reportingGroupIds
required: false
in: query
description: A list of reporting group ids
schema:
type: array
items:
type: string
- name: pageSize
required: false
in: query
description: Number of items per page
schema:
default: 50
type: number
- name: pageNumber
required: false
in: query
description: The page you would like to get data for
schema:
default: 1
type: number
- name: sortProperty
required: false
in: query
description: 'sortProperty must be one of the following values: engagements, impressions, engagementRate, impressionsPerPost, estimatedValueGenerated, estimatedRoi, reach, cpe, cpm, firstPostDate, lastPostDate, estimatedContentCost, campaignTitle, postsCount, influencersCount, clicks, trackingLinksClicks, trackingLinksConversions, trackingLinksConversionValue, affiliateLinksClicks, affiliateLinksConversions, affiliateLinksConversionRate, affiliateLinksSales, affiliateLinksComissionEarned, affiliateLinksRoi'
schema:
type: string
- name: sortDirection
required: false
in: query
description: ASC or DESC
schema:
default: DESC
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ReportingApiResponseDto'
- properties:
data:
type: array
items:
$ref: '#/components/schemas/CampaignPerformanceResponseDto'
summary: ''
tags:
- Campaign Level
components:
schemas:
ReportingApiResponseDto:
type: object
properties:
data:
type: object
additionalProperties: false
meta:
type:
- object
- 'null'
description: Metadata containing page information
properties:
page:
type: number
example: 1
totalPages:
type: number
example: 10
required:
- data
- meta
CampaignPerformanceResponseDto:
type: object
properties:
campaignId:
type: number
example: 1
description: Unique identifier for the campaign
campaignTitle:
type:
- string
- 'null'
example: Campaign Title
description: Title of the campaign
instanceId:
type: string
example: instance_123
description: Identifier of the instance
description:
type:
- string
- 'null'
example: Description of the campaign
description: Detailed description of the campaign
postsCount:
type:
- number
- 'null'
example: 10
description: Total number of posts in the campaign
influencersCount:
type:
- number
- 'null'
example: 5
description: Number of influencers participating in the campaign
reach:
type:
- number
- 'null'
example: 1000
description: Total reach of the campaign. Usually it represents the number of followers/subscribers/audience reached, but for Pinterest it is the number of Monthly Viewers
engagements:
type:
- number
- 'null'
example: 100
description: Total number of engagements for the campaign
impressions:
type:
- number
- 'null'
example: 500
description: Total number of impressions for the campaign
clicks:
type:
- number
- 'null'
example: 50
description: Total number of clicks for the campaign
engagementRate:
type:
- number
- 'null'
example: 0.1
description: Engagement rate of the campaign
uniqueNetworks:
type:
- string
- 'null'
example: Facebook, Instagram
description: Comma-separated list of unique social networks used in the campaign
cpe:
type:
- number
- 'null'
example: 0.05
description: Cost per engagement for the campaign
cpm:
type:
- number
- 'null'
example: 10
description: Cost per thousand impressions for the campaign
firstPostDate:
format: date-time
type:
- string
- 'null'
example: '2025-11-26T14:12:56.038Z'
description: Date of the first post in the campaign
lastPostDate:
format: date-time
type:
- string
- 'null'
example: '2025-11-26T14:12:56.038Z'
description: Date of the last post in the campaign
impressionsPerPost:
type:
- number
- 'null'
example: 50
description: Average number of impressions per post in the campaign
estimatedContentCost:
type:
- number
- 'null'
example: 1000
description: Is calculated based on how many posts within the campaign received metrics in the selected time range vs the amount of money paid to the author(influencer)
estimatedValueGenerated:
type:
- number
- 'null'
example: 2000
description: Estimated value generated by the campaign
estimatedRoi:
type:
- number
- 'null'
example: 2
description: Estimated return on investment for the campaign
trackingLinksClicks:
type:
- number
- 'null'
example: 100
description: Total number of clicks on tracking links
trackingLinksConversions:
type:
- number
- 'null'
example: 10
description: Total number of conversions from tracking links
trackingLinksConversionValue:
type:
- number
- 'null'
example: 500
description: Total conversion value from tracking links
affiliateLinksClicks:
type:
- number
- 'null'
example: 50
description: Total number of clicks on affiliate links
affiliateLinksConversions:
type:
- number
- 'null'
example: 5
description: Total number of conversions from affiliate links
affiliateLinksConversionRate:
type:
- number
- 'null'
example: 0.1
description: Conversion rate for affiliate links
affiliateLinksSales:
type:
- number
- 'null'
example: 1000
description: Total sales value from affiliate links
affiliateLinksComissionEarned:
type:
- number
- 'null'
example: 100
description: Total commission earned from affiliate links
affiliateLinksRoi:
type:
- number
- 'null'
example: 2
description: Return on investment for affiliate links
required:
- campaignId
- campaignTitle
- instanceId
- description
- postsCount
- influencersCount
- reach
- engagements
- impressions
- clicks
- engagementRate
- uniqueNetworks
- cpe
- cpm
- firstPostDate
- lastPostDate
- impressionsPerPost
- estimatedContentCost
- estimatedValueGenerated
- estimatedRoi
- trackingLinksClicks
- trackingLinksConversions
- trackingLinksConversionValue
- affiliateLinksClicks
- affiliateLinksConversions
- affiliateLinksConversionRate
- affiliateLinksSales
- affiliateLinksComissionEarned
- affiliateLinksRoi
securitySchemes:
JWT:
type: http
scheme: bearer
bearerFormat: JWT
description: JWT obtained from the OAuth2 token endpoint