Fetch attribution metrics for a conversion destination
LinkedIn-only today. Returns conversion-attribution metrics (`externalWebsiteConversions`, `externalWebsitePostClickConversions`, `externalWebsitePostViewConversions`, `conversionValueInLocalCurrency`, `qualifiedLeads`, `costInLocalCurrency`) bucketed by date. Date-range constraints (passed through from LinkedIn): - `granularity=DAILY` is retained for ~6 months only - `granularity=ALL` with a range > 6 months auto-rounds to month boundaries - `granularity=MONTHLY`/`YEARLY` retains 24 months Throttle: LinkedIn caps adAnalytics at 45M metric values per 5-minute window across the calling token. Single-rule queries are well within that limit; surfaces as 429 if hit.
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
Query Parameters
^\\d{4}-\\d{2}-\\d{2}$^\\d{4}-\\d{2}-\\d{2}$"DAILY""ALL" | "DAILY" | "MONTHLY" | "YEARLY"Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.ads.getConversionMetrics({ path: { accountId: 'account_abc123', destinationId: 'destination_abc123', }, query: { adAccountId: 'adaccount_abc123', startDate: 'string', },});console.log(data);{
"platform": "linkedinads",
"granularity": "ALL",
"rows": [
{
"start": "string",
"end": "string",
"metrics": {
"property1": 0,
"property2": 0
}
}
]
}{
"error": "Unauthorized"
}Fetch a single conversion destination GET
LinkedIn-only today. Returns the full destination record for one conversion rule. The `adAccountId` query parameter is required because LinkedIn rules are scoped to a sponsored ad account.
Update ad PUT
Patch one or more fields on an ad. Status, budget, targeting, and creative changes are propagated to the platform. Per-platform support: - **Meta** (Facebook + Instagram): all fields supported. - **TikTok**: status, budget, targeting (via `/v2/adgroup/update/`), and creative (via `/v2/ad/update/` patch-style — `headline` is ignored, `body` becomes `ad_text`). - **Pinterest / X / LinkedIn / Google**: status + budget only. Sending `targeting` or `creative` returns 501 with code `unsupported_platform_operation`.