REST API for accessing ZenABM data. Generate an API token at https://app.zenabm.com/api-keys. Endpoints that return weekly breakdowns use Monday–Sunday weeks (weekStart/weekEnd dates).
\nPOST /abm-stages/manage applies one change to an ABM stage per call — create, rename, recolor, reorder or delete a stage, set how its blocks combine, or add, replace or remove a condition block or a single condition. Stages, CRM stages, properties and LinkedIn assets are addressed by name instead of id, and the response returns the updated stage with the same condition model as GET /abm-stages/{id} plus non-blocking warnings. This is the first write endpoint in v1; it is gated by the same API access plan feature as the read endpoints. The body may also be { \"operations\": [...] } with up to 10 operations applied in order (not atomic: earlier steps stay applied when a later one fails), a new set_stage_conditions op replaces a stage’s whole rule in one step, and data now carries applied and total next to stage and warnings.hideExcludedCompanies (boolean, default false) hides companies that have a COMPANY exclusion in this organization, matching the \"Excluded\" badge in the UI. Accepted on GET /companies, GET /campaigns/{id}/companies, GET /campaign-groups/{id}/companies, GET /abm-campaigns/{id}/companies and GET /abm-stages/{id}/companies. On the Ad Set and Campaign endpoints, only exclusions that apply to that Ad Set/Campaign are hidden (team-wide, or scoped specifically to it) — an exclusion scoped elsewhere is left alone.GET /deals returns costBeforeDeal and costAfterDeal next to the existing impressionsBeforeDeal/clicksBeforeDeal/engagementsBeforeDeal. Both are LinkedIn ad spend in USD, unlike amount which follows the team’s display currency.GET /abm-stages and GET /abm-stages/{id} return each stage’s full condition model. blockOperator (AND/OR) joins the stage’s conditionBlocks, and each block joins its own conditions with its operator. Every condition carries a type and only the fields that type uses; null fields are omitted. Base fields and currentCompaniesCount are unchanged, so this is additive.CONTACT_PROPERTY conditions test a HubSpot contact property instead of a company property. The condition’s propertyMapping carries propertyObjectType: \"CONTACT\" and minMatchingContacts; the company matches when at least that many of its associated contacts satisfy the mapping. HubSpot only, and the negative operators (not_equals, not_contains, not_in_list, is_unknown) stay company-only because an unset value would match almost every company.GET /deals no longer accepts dealStatus=disqualified. Deal status is now resolved natively from each CRM as open, won, lost or any; any other value returns 400. Deals previously matched by disqualified are now filtered by their native CRM status instead.GET /deals alongside HubSpot deals and Salesforce opportunities, tagged source: \"attio\" and scoped with source=attio. Company payloads carry attioRecordId, and the company list endpoints accept attioMatchStatus (all, matched, unmatched). crmMatchStatus keeps its generic name but filters HubSpot alone.GET /campaigns/{id}/suggested-bid returns LinkedIn’s suggested bid for an Ad Set — the same number Campaign Manager shows — plus the allowed bid range, daily budget limits, and the current bid and budget. Read live from LinkedIn on every call. Returns 422 when the Ad Set cannot be priced and 502 when LinkedIn has no pricing for the targeting.GET /linkedin-metrics accepts timeGranularity (ALL, DAILY, MONTHLY, YEARLY) and metrics. Either one switches the response from the flat totals object to the timeseries shape { startDate, endDate, timeGranularity, fields, rows, totals, truncated }. It also accepts linkedInCampaignGroupId for campaign-level metrics; linkedInCampaignId stays ad-set level and the two cannot be combined.GET /abm-stages/{id}/companies-entering and GET /abm-stages/{id}/companies-progressing accept campaignType (current_abm_stage, lifetime_abm_stage, specific_campaign) with campaignId. The older all_abm_campaigns and linkedin_influenced values still work as aliases, and an unknown value falls back to current_abm_stage instead of returning an error.GET /abm-campaigns/{id}/companies, abmStage and the abmStages filter report the company’s stage inside that campaign (a manual override wins), while lifetimeAbmStage stays company-wide. GET /companies follows the same rule when abmCampaigns holds exactly one ID.Returns a paginated list of companies with engagement metrics. Filter by campaigns, ABM stages, engagement scores, or CRM match status.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["companies"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"Comma-separated Ad Sets IDs
\n","type":"text/plain"},"key":"campaigns","value":"cm1abc,cm2def"},{"description":{"content":"Comma-separated Campaigns IDs
\n","type":"text/plain"},"key":"campaignGroups","value":"string"},{"description":{"content":"Comma-separated ABM campaign IDs. With exactly one ID, abmStage and the abmStages filter are scoped to that campaign (same semantics as GET /abm-campaigns/{id}/companies); with several IDs they use the company's overall stage.
Comma-separated ABM stage IDs. Matches the same stage abmStage reports: campaign-scoped when abmCampaigns holds exactly one ID, otherwise the overall stage.
Only return companies that show this intent signal. Takes a single intent ID — see GET /intents.
Set to all_abm_campaigns to scope the list to companies targeted by any ABM campaign. Ignored when campaigns, campaignGroups, or abmCampaigns is supplied, because those filters are more specific.
Comma-separated scores (1–5)
\n","type":"text/plain"},"key":"engagementScores","value":"3,4,5"},{"description":{"content":"Only return rows where impressions is greater than or equal to this value.
\n","type":"text/plain"},"key":"minImpressions","value":"192.19441793910886"},{"description":{"content":"Only return rows where impressions is less than or equal to this value.
\n","type":"text/plain"},"key":"maxImpressions","value":"192.19441793910886"},{"description":{"content":"Only return rows where clicks is greater than or equal to this value.
\n","type":"text/plain"},"key":"minClicks","value":"192.19441793910886"},{"description":{"content":"Only return rows where clicks is less than or equal to this value.
\n","type":"text/plain"},"key":"maxClicks","value":"192.19441793910886"},{"description":{"content":"Only return rows where engagements is greater than or equal to this value.
\n","type":"text/plain"},"key":"minEngagements","value":"192.19441793910886"},{"description":{"content":"Only return rows where engagements is less than or equal to this value.
\n","type":"text/plain"},"key":"maxEngagements","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost in USD is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCostInUsd","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost in USD is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCostInUsd","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per click (CPC) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCostPerClick","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per click (CPC) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCostPerClick","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per 1,000 impressions (CPM) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCpm","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per 1,000 impressions (CPM) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCpm","value":"192.19441793910886"},{"description":{"content":"Only return rows where click-through rate (CTR, as a percentage) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minClickThroughRate","value":"192.19441793910886"},{"description":{"content":"Only return rows where click-through rate (CTR, as a percentage) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxClickThroughRate","value":"192.19441793910886"},{"description":{"content":"Only return rows where the number of intent signals is greater than or equal to this value.
\n","type":"text/plain"},"key":"minIntents","value":"192.19441793910886"},{"description":{"content":"Only return rows where the number of intent signals is less than or equal to this value.
\n","type":"text/plain"},"key":"maxIntents","value":"192.19441793910886"},{"description":{"content":"Filters on the link to HubSpot. matched returns only companies that have a HubSpot company record, unmatched only companies that have none. The name is generic for historic reasons, but this parameter covers HubSpot alone — use salesforceMatchStatus or attioMatchStatus for the other CRMs.
Salesforce match filter
\n","type":"text/plain"},"key":"salesforceMatchStatus","value":"all"},{"description":{"content":"Attio match filter
\n","type":"text/plain"},"key":"attioMatchStatus","value":"all"},{"description":{"content":"When true, hides companies that have a COMPANY exclusion in this organization (matches the \"Excluded\" badge in the UI).
When true, each company in the response is augmented with a weeklyData[] array — one entry per Sunday-anchored bucket in the date range (impressions, clicks, engagements, costInUsd). pageSize is automatically capped at 20 on this path to keep responses small.
Retrieve a single company by its ID, including full profile and current metrics.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["companies",":id"],"host":["https://app.zenabm.com/api/v1"],"query":[],"variable":[{"description":{"content":"Company ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"37d86951-e5e7-4c73-a1c1-cbe32a3e6aa1","name":"Company details","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns aggregated and weekly metrics for a company over a given time period.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["companies",":id","overview"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"}],"variable":[{"description":{"content":"Company ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"db0afe73-ec4a-4c03-9cca-266c78caa616","name":"Company overview with weekly metrics (weekStart, weekEnd)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns campaigns that a specific company has been exposed to, with per-company metrics.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["companies",":id","campaigns"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"}],"variable":[{"description":{"content":"Company ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"affeaff9-c95e-4542-af02-b177fb63362a","name":"Paginated Ad Sets for company","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerOptional filters: sortBy, sortOrder, search
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["companies",":id","campaign-groups"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"}],"variable":[{"description":{"content":"Company ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"5593823c-bc9d-4b45-a996-dd920b2237f5","name":"Paginated Campaigns for company","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerOptional filters: sortBy, sortOrder
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["companies",":id","abm-campaigns"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"}],"variable":[{"description":{"content":"Company ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"fa6a463b-fe61-4e6d-9628-2b0239b1eb4d","name":"Paginated ABM campaigns for company","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns a chronological list of engagement events for a company within a date range.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["companies",":id","timeline"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Start date (ISO format, default: 30 days ago)
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (ISO format, default: today)
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"}],"variable":[{"description":{"content":"Company ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"1831e6c9-7844-415d-b263-4f45ea309a71","name":"Company timeline events","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerMerged chronological feed of stage changes, deals, intents, and exclusions. Paginated via page/pageSize. Note: totalCount/totalPages are not returned because the feed is merged from multiple sources. Pass startDate/endDate (YYYY-MM-DD) to scope the feed to a window — when a date range is supplied, weekly LinkedIn ad-activity entries (type: \"linkedin_activity_week\", carrying a metrics object with impressions/clicks/engagements/costInUsd) are merged into the feed.
Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"}],"variable":[{"description":{"content":"Company ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"26217de1-dc71-40fe-bf81-35a0bac1fe1a","name":"Company activity log entries","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerOptional filters: sortBy, sortOrder
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["companies",":id","deals"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Field to sort by (default: createdAt)
\n","type":"text/plain"},"key":"sortBy","value":"createdAt"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"}],"variable":[{"description":{"content":"Company ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"964bb6df-2617-47a1-8719-4d69a6f9d49d","name":"Deals for company","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns the ABM stage history for a company, showing progression through your funnel.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["companies",":id","abm-stages"],"host":["https://app.zenabm.com/api/v1"],"query":[],"variable":[{"description":{"content":"Company ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"d812a831-6b69-440e-b72b-c6269ddc73df","name":"ABM stage history for company","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns a paginated list of LinkedIn Ad Sets with aggregated performance metrics for the requested date range. Filter by status (default: ACTIVE,PAUSED) or search by name. Each item includes both ZenABM's internal id (when the ad set has been imported) and the LinkedIn-native linkedInId. To list ad sets within a specific ABM campaign use /abm-campaigns/{id} instead.
Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"Comma-separated statuses: ACTIVE,PAUSED,ARCHIVED,DRAFT,COMPLETED. Default: ACTIVE,PAUSED.
\n","type":"text/plain"},"key":"status","value":"ACTIVE,PAUSED"}],"variable":[]}},"response":[{"id":"cf9725a1-3c37-4126-b815-12a6748055b1","name":"Paginated list of Ad Sets","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerIdentity and relations only. Delivery settings (budgets, bid, objective, cost type, optimization target, pacing, Audience Expansion, LinkedIn Audience Network), audience size and targeting come from /campaigns/{id}/settings, which reads them live from LinkedIn Campaign Manager.
Ad Set ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"49232919-a38c-4019-908e-5d7227e1480f","name":"Ad Set details","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerRead LIVE from LinkedIn Campaign Manager on every call, not from ZenABM's sync, so it reflects an edit made minutes ago. Fields listed in unknownSettings were not returned by LinkedIn — treat them as unknown, never as \"off\". audienceSize is the estimated ADDRESSABLE audience, not reach: impressions / audienceSize is only a lower bound on frequency, and exclusions are left out of it (see audienceSizeExcludesApplied). Each targeting facet reports count (values targeted), values (readable names only) and unnamed (values with no name available, most often specific geographic locations). Returns 502 if LinkedIn is unreachable rather than falling back to synced values.
Ad Set ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"5ffd5066-8a02-4147-abdb-13f26d06178e","name":"Live Ad Set settings","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerLinkedIn's suggested bid for the Ad Set — the same number Campaign Manager shows — plus the allowed bid range and daily budget limits. Read LIVE on every call: the Ad Set's current targeting, objective and cost type are echoed into LinkedIn's pricing finder, so the answer reflects edits made minutes ago. Also returns the current bid and daily budget for context. Not available for Dynamic Ads. Returns 422 when the Ad Set cannot be priced (Dynamic Ads, unsupported cost/campaign type, missing or oversized targeting), 502 when LinkedIn is unreachable or has no pricing for the targeting.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["campaigns",":id","suggested-bid"],"host":["https://app.zenabm.com/api/v1"],"query":[],"variable":[{"description":{"content":"Ad Set ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"cf2b2cae-b6ee-4914-80f1-81afd10fa0dc","name":"Suggested bid and limits","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerPerformance totals for a single Ad Set over the requested date range (no weekly breakdown).
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["campaigns",":id","overview"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"}],"variable":[{"description":{"content":"Ad Set ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"f92bc011-9651-4f1e-95d9-7017aea98864","name":"Ad Set performance summary for the date range","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerOptional filters: sortBy, sortOrder, search
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["campaigns",":id","companies"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"When true, hides companies with a COMPANY exclusion that applies to this Ad Set — a team-wide exclusion, or one scoped specifically to this Ad Set (matches the \"Excluded\" badge in the UI). An exclusion scoped to a different Ad Set or Campaign does not apply here.
Ad Set ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"bf84e143-255b-495c-aa78-9b06866e99ee","name":"Paginated companies for Ad Set","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns job title engagement breakdown for a specific campaign.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["campaigns",":id","job-titles"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"Only return rows where impressions is greater than or equal to this value.
\n","type":"text/plain"},"key":"minImpressions","value":"192.19441793910886"},{"description":{"content":"Only return rows where impressions is less than or equal to this value.
\n","type":"text/plain"},"key":"maxImpressions","value":"192.19441793910886"},{"description":{"content":"Only return rows where clicks is greater than or equal to this value.
\n","type":"text/plain"},"key":"minClicks","value":"192.19441793910886"},{"description":{"content":"Only return rows where clicks is less than or equal to this value.
\n","type":"text/plain"},"key":"maxClicks","value":"192.19441793910886"},{"description":{"content":"Only return rows where engagements is greater than or equal to this value.
\n","type":"text/plain"},"key":"minEngagements","value":"192.19441793910886"},{"description":{"content":"Only return rows where engagements is less than or equal to this value.
\n","type":"text/plain"},"key":"maxEngagements","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost in USD is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCostInUsd","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost in USD is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCostInUsd","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per click (CPC) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCostPerClick","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per click (CPC) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCostPerClick","value":"192.19441793910886"},{"description":{"content":"Only return rows where click-through rate (CTR, as a percentage) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minClickThroughRate","value":"192.19441793910886"},{"description":{"content":"Only return rows where click-through rate (CTR, as a percentage) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxClickThroughRate","value":"192.19441793910886"}],"variable":[{"description":{"content":"Ad Set ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"f6468a80-141e-495c-bd4a-814765df2fa7","name":"Job title insights for Ad Set","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns ad spend for LinkedIn Ad Sets within the requested date range. Response includes a summary of totals across the whole range and a byAdSet array — one entry per ad set, each carrying its own totals plus monthly buckets (year, month, period like \"2026-05\"). Pagination scopes byAdSet (summary always reflects the full range). Each ad set includes both ZenABM's internal id (when imported) and the LinkedIn-native linkedInId. Filter to a single ad set with the linkedInId query param.
Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Filter to a single Ad Set by its LinkedIn numeric ID.
\n","type":"text/plain"},"key":"linkedInId","value":"123456"}],"variable":[]}},"response":[{"id":"89a8c480-0448-419a-b6fd-e74cf32a9de6","name":"Ad spend summary + per-ad-set monthly breakdown","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns aggregated impressions, clicks, engagements, conversions, and cost for the specified date range, read live from LinkedIn. Optionally filter by a single LinkedIn ad set or campaign ID. Set includeReach=true to also get unique member reach and frequency.
Two response shapes. With timeGranularity=ALL (the default) and no metrics parameter, the response is the flat totals object shown below. Setting timeGranularity to DAILY/MONTHLY/YEARLY or passing metrics switches the response to the timeseries shape: { startDate, endDate, timeGranularity, fields, rows, totals, truncated }, where rows holds one { periodStart, periodEnd, <metric>: number } object per period and totals sums each requested metric over the whole range. includeReach only works with the flat shape.
Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"How to split the range. ALL returns one total (flat response shape). DAILY/MONTHLY/YEARLY return one row per period (timeseries response shape). LinkedIn keeps DAILY data for 6 months only; older ranges fall back to month boundaries.
\n","type":"text/plain"},"key":"timeGranularity","value":"ALL"},{"description":{"content":"Comma-separated metric fields to fetch (e.g. impressions,clicks,oneClickLeads), max 19 per request. Passing this switches the response to the timeseries shape even with timeGranularity=ALL. Defaults to impressions, clicks, costInUsd, totalEngagements.
Start of date range (inclusive). Format: YYYY-MM-DD. Supply with endDate to override period. When neither is supplied, the range falls back to period (last 30 days by default).
End of date range (inclusive). Format: YYYY-MM-DD. Supply with startDate to override period.
LinkedIn's own ad set ID (numeric, from urn:li:sponsoredCampaign). When provided, metrics are returned for this ad set only. Cannot be combined with linkedInCampaignGroupId.
\n","type":"text/plain"},"key":"linkedInCampaignId","value":"123456"},{"description":{"content":"LinkedIn's own campaign ID (numeric, from urn:li:sponsoredCampaignGroup). When provided, metrics are returned for this campaign only. Cannot be combined with linkedInCampaignId.
\n","type":"text/plain"},"key":"linkedInCampaignGroupId","value":"654321"},{"description":{"content":"Set to true to also return reach (unique members who saw an ad) and frequency (impressions / reach). Off by default because it costs one extra LinkedIn request; without it both fields come back null. Reach is deduplicated within one response and can NEVER be added up: reach for two ranges, or for several campaigns, does not sum to the reach of the whole, because a member seen twice is still one person. Whenever reach is null, reachUnavailableReason says why — the other totals are always returned.
Returns a cursor-paginated catalog of the individual ad creatives (the actual ads) in the LinkedIn ad account. Each item includes the LinkedIn-native linkedInId, the full creativeUrn, name, ad format, status, serving state, and the parent ad set + campaign (with both ZenABM id — when imported — and linkedInId). Each response carries a nextCursor: pass it back as the cursor query parameter to fetch the next page (hasMore is false on the last page). Optionally scope to one ad set (adSetId) or campaign (campaignId).
Pagination cursor from a previous response's nextCursor. Omit to fetch the first page.
Creatives per page (1–100, default: 20).
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Filter to a single ad set. Accepts the ZenABM ad set ID or the LinkedIn numeric ID.
\n","type":"text/plain"},"key":"adSetId","value":"string"},{"description":{"content":"Filter to a single campaign. Accepts the ZenABM campaign ID or the LinkedIn numeric ID.
\n","type":"text/plain"},"key":"campaignId","value":"string"}],"variable":[]}},"response":[{"id":"01c2c841-0d77-463f-8f12-67169406c3c7","name":"Cursor-paginated catalog of ad creatives","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns a paginated list of LinkedIn Campaigns with aggregated performance metrics for the requested date range. Filter by status (default: ACTIVE,PAUSED) or search by name. Each item includes both ZenABM's internal id (when the campaign has been imported) and the LinkedIn-native linkedInId. To list campaigns within a specific ABM campaign use /abm-campaigns/{id} instead.
Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"Comma-separated statuses: ACTIVE,PAUSED,ARCHIVED,DRAFT,COMPLETED. Default: ACTIVE,PAUSED.
\n","type":"text/plain"},"key":"status","value":"ACTIVE,PAUSED"}],"variable":[]}},"response":[{"id":"a723b1ef-d3eb-45f1-a486-8668927ba2f7","name":"Paginated list of Campaigns","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns a single Campaign with its child Ad Sets in the adSets array (id, linkedInId, name, status, human-readable format).
Campaign ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"d369116c-3cb5-4a5b-bdb4-95bef8e37487","name":"Campaign details","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerPerformance totals for a single Campaign over the requested date range — aggregated to a single summary (no weekly breakdown).
Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"}],"variable":[{"description":{"content":"Campaign ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"2db265f1-1af3-42e6-bcfc-2e6c378c0373","name":"Campaign performance summary for the date range","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerOptional filters: sortBy, sortOrder, search
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["campaign-groups",":id","companies"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"When true, hides companies with a COMPANY exclusion that applies to this Campaign — a team-wide exclusion, or one scoped specifically to this Campaign (matches the \"Excluded\" badge in the UI). An exclusion scoped to a different Campaign or Ad Set does not apply here.
Campaign ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"9b11f421-780a-4846-a1a5-df4cd3a15638","name":"Paginated companies for Campaign","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerOptional filters: sortBy, sortOrder
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["campaign-groups",":id","job-titles"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"Only return rows where impressions is greater than or equal to this value.
\n","type":"text/plain"},"key":"minImpressions","value":"192.19441793910886"},{"description":{"content":"Only return rows where impressions is less than or equal to this value.
\n","type":"text/plain"},"key":"maxImpressions","value":"192.19441793910886"},{"description":{"content":"Only return rows where clicks is greater than or equal to this value.
\n","type":"text/plain"},"key":"minClicks","value":"192.19441793910886"},{"description":{"content":"Only return rows where clicks is less than or equal to this value.
\n","type":"text/plain"},"key":"maxClicks","value":"192.19441793910886"},{"description":{"content":"Only return rows where engagements is greater than or equal to this value.
\n","type":"text/plain"},"key":"minEngagements","value":"192.19441793910886"},{"description":{"content":"Only return rows where engagements is less than or equal to this value.
\n","type":"text/plain"},"key":"maxEngagements","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost in USD is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCostInUsd","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost in USD is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCostInUsd","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per click (CPC) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCostPerClick","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per click (CPC) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCostPerClick","value":"192.19441793910886"},{"description":{"content":"Only return rows where click-through rate (CTR, as a percentage) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minClickThroughRate","value":"192.19441793910886"},{"description":{"content":"Only return rows where click-through rate (CTR, as a percentage) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxClickThroughRate","value":"192.19441793910886"}],"variable":[{"description":{"content":"Campaign ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"cc323530-c981-4fc3-994f-b355661b3f02","name":"Job title insights for campaign group","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns a paginated list of CRM deals with influence attribution data. Deals from every connected CRM come back in one list: HubSpot deals, Salesforce opportunities and Attio deals. Each deal carries source, externalId (its record ID in that CRM) and externalUrl (a link straight to the record), so you can match a deal back to the CRM it came from. costBeforeDeal/costAfterDeal are LinkedIn ad spend in USD, always — unlike amount, they do not follow the team's display currency.
Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Field to sort by (default: createdAt)
\n","type":"text/plain"},"key":"sortBy","value":"createdAt"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"Filter deals by CRM source (default: all). HubSpot deals, Salesforce opportunities and Attio deals are returned in one list.
\n","type":"text/plain"},"key":"source","value":"all"},{"description":{"content":"Start date filter (YYYY-MM-DD). Supply with endDate; a partial range is ignored. Preferred over dateFrom, which is kept for backward compatibility.
End date filter (YYYY-MM-DD). Supply with startDate; a partial range is ignored. Preferred over dateTo, which is kept for backward compatibility.
Deprecated alias for startDate. Used only when startDate is absent.
Deprecated alias for endDate. Used only when endDate is absent.
Filter by a single ABM campaign. When set, it overrides abmCampaigns.
Comma-separated ABM campaign IDs. Ignored when abmCampaignId is set.
Only return rows where the deal amount is greater than or equal to this value.
\n","type":"text/plain"},"key":"minAmount","value":"192.19441793910886"},{"description":{"content":"Only return rows where the deal amount is less than or equal to this value.
\n","type":"text/plain"},"key":"maxAmount","value":"192.19441793910886"},{"description":{"content":"Comma-separated deal statuses: open, won, lost or any. Resolved from each CRM natively — HubSpot stage isClosed + probability, Salesforce IsClosed/IsWon, Attio status title. Any other value returns 400.
Attribution type filter
\n","type":"text/plain"},"key":"influenceFilter","value":"LINKEDIN,ABM"},{"description":{"content":"Hide $0 deals (default: true)
\n","type":"text/plain"},"key":"hideZeroAmount","value":"true"}],"variable":[]}},"response":[{"id":"0fa55f95-6237-4cc2-b9a8-192dd55a5d6d","name":"Paginated list of deals","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerOptional filters: Ad Sets (comma-separated IDs), Campaigns (comma-separated IDs)
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["job-titles"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"Filter by Ad Sets IDs
\n","type":"text/plain"},"key":"campaigns","value":"string"},{"description":{"content":"Filter by Campaigns IDs
\n","type":"text/plain"},"key":"campaignGroups","value":"string"},{"description":{"content":"Only return rows where impressions is greater than or equal to this value.
\n","type":"text/plain"},"key":"minImpressions","value":"192.19441793910886"},{"description":{"content":"Only return rows where impressions is less than or equal to this value.
\n","type":"text/plain"},"key":"maxImpressions","value":"192.19441793910886"},{"description":{"content":"Only return rows where clicks is greater than or equal to this value.
\n","type":"text/plain"},"key":"minClicks","value":"192.19441793910886"},{"description":{"content":"Only return rows where clicks is less than or equal to this value.
\n","type":"text/plain"},"key":"maxClicks","value":"192.19441793910886"},{"description":{"content":"Only return rows where engagements is greater than or equal to this value.
\n","type":"text/plain"},"key":"minEngagements","value":"192.19441793910886"},{"description":{"content":"Only return rows where engagements is less than or equal to this value.
\n","type":"text/plain"},"key":"maxEngagements","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost in USD is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCostInUsd","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost in USD is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCostInUsd","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per click (CPC) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCostPerClick","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per click (CPC) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCostPerClick","value":"192.19441793910886"},{"description":{"content":"Only return rows where click-through rate (CTR, as a percentage) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minClickThroughRate","value":"192.19441793910886"},{"description":{"content":"Only return rows where click-through rate (CTR, as a percentage) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxClickThroughRate","value":"192.19441793910886"},{"description":{"content":"When true, each job title in the response is augmented with a weeklyData[] array — one entry per Sunday-anchored bucket in the date range (impressions, clicks, engagements, costInUsd). pageSize is automatically capped at 20 on this path to keep responses small.
Performance totals for a single job title over the date range — aggregated across the whole ad account (impressions, clicks, engagements, cost, conversions, CTR, CPC). The path id is the job title URN. Returns zeroes if the job title had no activity in the window.
Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"}],"variable":[{"description":{"content":"Job title URN
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"9cb899fe-f7fb-4ab4-9335-2b86930eee5d","name":"Job title performance summary for the date range","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerAd sets this job title was exposed to, with per-job-title delivery metrics. The path id is the job title URN. Optional filters: sortBy, sortOrder, search. Job title interactions are stored as weekly totals anchored on the Sunday that ends each Monday–Sunday week, so a date range selects whole weeks rather than exact days. meta.dateRange reports what was actually summed: the range you asked for, the range covered, and how many weeks that was. When weeksCovered is 0 no week ended inside your range, so the totals are empty by definition — widen the range rather than reading it as no activity.
Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). Must be sent together with endDate; a half-supplied range is ignored and the period preset applies instead. Job title interactions are stored as weekly totals, so a week is included when the day it ends on falls inside the range. Totals are never split across a partial week, and a range shorter than a week can return nothing.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). Must be sent together with startDate. Selects whole weeks, exactly like startDate.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"}],"variable":[{"description":{"content":"Job title URN
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"17a39ee0-4f68-4eaf-8fa0-14c45b4660c6","name":"Ad Set insights for job title","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerOptional filters: sortBy, sortOrder, search. Job title interactions are stored as weekly totals anchored on the Sunday that ends each Monday–Sunday week, so a date range selects whole weeks rather than exact days. meta.dateRange reports what was actually summed: the range you asked for, the range covered, and how many weeks that was. When weeksCovered is 0 no week ended inside your range, so the totals are empty by definition — widen the range rather than reading it as no activity.
Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). Must be sent together with endDate; a half-supplied range is ignored and the period preset applies instead. Job title interactions are stored as weekly totals, so a week is included when the day it ends on falls inside the range. Totals are never split across a partial week, and a range shorter than a week can return nothing.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). Must be sent together with startDate. Selects whole weeks, exactly like startDate.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"}],"variable":[{"description":{"content":"Job title ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"b94c46e6-f10a-45a2-a7c1-720415005d7d","name":"Campaign insights for job title","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerOptional filters: status (ACTIVE,PAUSED,COMPLETED)
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["abm-campaigns"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"Comma-separated statuses: ACTIVE,PAUSED,COMPLETED
\n","type":"text/plain"},"key":"status","value":"ACTIVE"},{"description":{"content":"Only return rows where the number of Ad Sets (response field numberOfAdSets) is greater than or equal to this value.
Only return rows where the number of Ad Sets (response field numberOfAdSets) is less than or equal to this value.
Only return rows where the number of Campaigns (response field numberOfCampaigns) is greater than or equal to this value.
Only return rows where the number of Campaigns (response field numberOfCampaigns) is less than or equal to this value.
Only return rows where the number of companies targeted is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCompaniesTargeted","value":"192.19441793910886"},{"description":{"content":"Only return rows where the number of companies targeted is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCompaniesTargeted","value":"192.19441793910886"},{"description":{"content":"Only return rows where total pipeline value is greater than or equal to this value.
\n","type":"text/plain"},"key":"minTotalPipeline","value":"192.19441793910886"},{"description":{"content":"Only return rows where total pipeline value is less than or equal to this value.
\n","type":"text/plain"},"key":"maxTotalPipeline","value":"192.19441793910886"},{"description":{"content":"Only return rows where total closed-won revenue is greater than or equal to this value.
\n","type":"text/plain"},"key":"minTotalRevenue","value":"192.19441793910886"},{"description":{"content":"Only return rows where total closed-won revenue is less than or equal to this value.
\n","type":"text/plain"},"key":"maxTotalRevenue","value":"192.19441793910886"},{"description":{"content":"Only return rows where total ad spend is greater than or equal to this value.
\n","type":"text/plain"},"key":"minTotalAdSpend","value":"192.19441793910886"},{"description":{"content":"Only return rows where total ad spend is less than or equal to this value.
\n","type":"text/plain"},"key":"maxTotalAdSpend","value":"192.19441793910886"},{"description":{"content":"Only return rows where return on ad spend (ROAS) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minRoas","value":"192.19441793910886"},{"description":{"content":"Only return rows where return on ad spend (ROAS) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxRoas","value":"192.19441793910886"}],"variable":[]}},"response":[{"id":"81bfe620-b3fe-4fd4-8430-a4b8ffb08dcc","name":"Paginated list of ABM campaigns","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns the ABM campaign plus the LinkedIn entities the user assigned to it. An ABM campaign can be backed by campaigns (linkedinCampaigns), ad sets (linkedinAdSets), or both — each array is a direct membership, not a parent/child hierarchy. Either can be empty.
ABM campaign ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"088f54cb-4840-44b5-8923-c9585ca0633f","name":"ABM campaign details","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerPerformance for the date range: metrics (LinkedIn delivery — impressions, clicks, engagements, cost, conversions, CTR, CPC across the ad sets + campaigns assigned to this ABM campaign) and effectiveness (business outcomes — companiesTargeted, totalPipeline, totalRevenue, totalAdSpend, pipePerSpent, averageAcv, roas). Currency note: metrics.costInUsd and effectiveness.totalAdSpend are always USD; effectiveness.totalPipeline, totalRevenue, and averageAcv are in the team displayCurrency (HubSpot deal amounts converted at sync time). pipePerSpent and roas are therefore ratios across the two currencies — treat as approximate unless displayCurrency is USD.
Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"}],"variable":[{"description":{"content":"ABM campaign ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"aa8533e1-cd55-4c33-9bba-88ebe154323a","name":"ABM campaign performance for the date range","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns a breakdown of companies across each ABM funnel stage.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["abm-campaigns",":id","stages-breakdown"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"}],"variable":[{"description":{"content":"ABM campaign ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"ed406580-8ce5-42e4-b22d-3eb264dbe5e3","name":"Stages breakdown for ABM campaign","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns a paginated list of companies with engagement metrics and intent data for a specific ABM campaign. Aggregates data from all linked LinkedIn campaigns and campaign groups. abmStage is the company's stage within this campaign — null until the company has one here — and a manual stage override on the company takes precedence; lifetimeAbmStage stays company-wide.
Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"Comma-separated scores (1–5)
\n","type":"text/plain"},"key":"engagementScores","value":"3,4,5"},{"description":{"content":"Comma-separated ABM stage IDs. Filters on the company's stage within this campaign (manual overrides take precedence), matching the abmStage field in the response.
Only return companies that show this intent signal. Takes a single intent ID — see GET /intents.
Only return rows where impressions is greater than or equal to this value.
\n","type":"text/plain"},"key":"minImpressions","value":"192.19441793910886"},{"description":{"content":"Only return rows where impressions is less than or equal to this value.
\n","type":"text/plain"},"key":"maxImpressions","value":"192.19441793910886"},{"description":{"content":"Only return rows where clicks is greater than or equal to this value.
\n","type":"text/plain"},"key":"minClicks","value":"192.19441793910886"},{"description":{"content":"Only return rows where clicks is less than or equal to this value.
\n","type":"text/plain"},"key":"maxClicks","value":"192.19441793910886"},{"description":{"content":"Only return rows where engagements is greater than or equal to this value.
\n","type":"text/plain"},"key":"minEngagements","value":"192.19441793910886"},{"description":{"content":"Only return rows where engagements is less than or equal to this value.
\n","type":"text/plain"},"key":"maxEngagements","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost in USD is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCostInUsd","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost in USD is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCostInUsd","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per click (CPC) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCostPerClick","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per click (CPC) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCostPerClick","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per 1,000 impressions (CPM) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCpm","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per 1,000 impressions (CPM) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCpm","value":"192.19441793910886"},{"description":{"content":"Only return rows where click-through rate (CTR, as a percentage) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minClickThroughRate","value":"192.19441793910886"},{"description":{"content":"Only return rows where click-through rate (CTR, as a percentage) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxClickThroughRate","value":"192.19441793910886"},{"description":{"content":"Only return rows where the number of intent signals is greater than or equal to this value.
\n","type":"text/plain"},"key":"minIntents","value":"192.19441793910886"},{"description":{"content":"Only return rows where the number of intent signals is less than or equal to this value.
\n","type":"text/plain"},"key":"maxIntents","value":"192.19441793910886"},{"description":{"content":"Filters on the link to HubSpot. matched returns only companies that have a HubSpot company record, unmatched only companies that have none. The name is generic for historic reasons, but this parameter covers HubSpot alone — use salesforceMatchStatus or attioMatchStatus for the other CRMs.
Salesforce match filter
\n","type":"text/plain"},"key":"salesforceMatchStatus","value":"all"},{"description":{"content":"Attio match filter
\n","type":"text/plain"},"key":"attioMatchStatus","value":"all"},{"description":{"content":"When true, hides companies that have a COMPANY exclusion in this organization (matches the \"Excluded\" badge in the UI).
ABM campaign ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"ed774c92-e18a-48f2-a019-ac186cf92575","name":"Paginated companies for this ABM campaign","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns a paginated list of job titles with engagement metrics for a specific ABM campaign. Aggregates data from all linked LinkedIn campaigns and campaign groups.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["abm-campaigns",":id","job-titles"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"Only return rows where impressions is greater than or equal to this value.
\n","type":"text/plain"},"key":"minImpressions","value":"192.19441793910886"},{"description":{"content":"Only return rows where impressions is less than or equal to this value.
\n","type":"text/plain"},"key":"maxImpressions","value":"192.19441793910886"},{"description":{"content":"Only return rows where clicks is greater than or equal to this value.
\n","type":"text/plain"},"key":"minClicks","value":"192.19441793910886"},{"description":{"content":"Only return rows where clicks is less than or equal to this value.
\n","type":"text/plain"},"key":"maxClicks","value":"192.19441793910886"},{"description":{"content":"Only return rows where engagements is greater than or equal to this value.
\n","type":"text/plain"},"key":"minEngagements","value":"192.19441793910886"},{"description":{"content":"Only return rows where engagements is less than or equal to this value.
\n","type":"text/plain"},"key":"maxEngagements","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost in USD is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCostInUsd","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost in USD is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCostInUsd","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per click (CPC) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minCostPerClick","value":"192.19441793910886"},{"description":{"content":"Only return rows where cost per click (CPC) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxCostPerClick","value":"192.19441793910886"},{"description":{"content":"Only return rows where click-through rate (CTR, as a percentage) is greater than or equal to this value.
\n","type":"text/plain"},"key":"minClickThroughRate","value":"192.19441793910886"},{"description":{"content":"Only return rows where click-through rate (CTR, as a percentage) is less than or equal to this value.
\n","type":"text/plain"},"key":"maxClickThroughRate","value":"192.19441793910886"}],"variable":[{"description":{"content":"ABM campaign ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"dbddc341-77d4-4497-8216-f65b76dbf96a","name":"Paginated job titles for this ABM campaign","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns every ABM stage for the team, each with its full condition model. blockOperator (AND/OR) joins the stage's conditionBlocks; each block joins its own conditions with its operator (AND/OR). Each condition carries a type plus only the fields relevant to that type (null fields are omitted). Condition types: LINKEDIN_METRICS, LIFECYCLE_STAGE, DEAL_STAGE, CUSTOM_PROPERTY (HubSpot company property), CONTACT_PROPERTY (HubSpot contact property, matches when at least minMatchingContacts of the company's contacts satisfy the mapping), ATTIO_COMPANY_PROPERTY, ATTIO_DEAL_STAGE. Property-mapping operator values include equals, not_equals, contains, not_contains, greater_than, greater_than_or_equal, less_than, less_than_or_equal, between, in_list, not_in_list, is_known, is_unknown. All ids returned (scopeIds, dealStageIds, pipelineIds, lifecycleStageIds, mapping ids) are this team's own ids.
Returns the ABM stage with currentCompaniesCount (companies currently in this stage) and its full condition model. blockOperator (AND/OR) joins the conditionBlocks; each block joins its conditions with its operator (AND/OR). Each condition carries a type plus only the fields relevant to that type (null fields are omitted):
LINKEDIN_METRICS: metric, comparison, minValue, maxValue, windowDays (rolling window; omitted = since campaign start), scope (INHERIT_CAMPAIGN | LINKEDIN_CAMPAIGN_GROUPS | LINKEDIN_AD_SETS | ABM_CAMPAIGNS), scopeIds.LIFECYCLE_STAGE: lifecycleStageIds.DEAL_STAGE: dealStageIds, pipelineIds (pipelines that scope a matchAnyOpenDeal condition; omitted means any tracked pipeline), matchAnyOpenDeal.ATTIO_DEAL_STAGE: attioDealStatusIds, attioMatchAnyOpenDeal.CUSTOM_PROPERTY (HubSpot company) / CONTACT_PROPERTY (HubSpot contact): a propertyMapping with hubspotPropertyName, operator, propertyObjectType (COMPANY | CONTACT), minMatchingContacts (contact-property match threshold), and any of expectedValue, expectedValues, numericThreshold, numericThresholdMax.ATTIO_COMPANY_PROPERTY: an attioPropertyMapping with attributeSlug, attributeTitle, operator, and value fields.\nProperty-mapping operator values include equals, not_equals, contains, not_contains, greater_than, greater_than_or_equal, less_than, less_than_or_equal, between, in_list, not_in_list, is_known, is_unknown.ABM stage ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"1484e382-f353-4329-80aa-20dffbda3867","name":"ABM stage details with its condition model","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns a paginated list of companies whose current ABM stage matches the given stage ID. Supports search and sorting.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["abm-stages",":id","companies"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Field to sort by (e.g. impressions, clicks, engagements)
\n","type":"text/plain"},"key":"sortBy","value":"string"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"When true, hides companies that have a COMPANY exclusion in this organization (matches the \"Excluded\" badge in the UI).
ABM stage ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"d1a837aa-ef3b-4b1e-af46-399d6b027b68","name":"Paginated companies in this ABM stage","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerStart date (ISO format, default: 30 days ago)
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (ISO format, default: today)
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Which stage to read (default: current_abm_stage).
current_abm_stage — the stage the company is in now.lifetime_abm_stage — the furthest stage the company has ever reached.specific_campaign — the stage the company holds inside one ABM campaign. Send campaignId with it; without a campaign id it falls back to current_abm_stage.Two older values still work. all_abm_campaigns now means the same as current_abm_stage. linkedin_influenced now means the same as lifetime_abm_stage, and no longer restricts the result to companies with a LinkedIn page. An unknown value falls back to current_abm_stage instead of returning an error.
ABM campaign ID. Used only with campaignType=specific_campaign.
Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"}],"variable":[{"description":{"content":"ABM stage ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"a226836b-8cd2-437b-8ebd-bf54599e4fb5","name":"Companies entering stage","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerStart date (ISO format, default: 30 days ago)
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (ISO format, default: today)
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Which stage to read (default: current_abm_stage).
current_abm_stage — the stage the company is in now.lifetime_abm_stage — the furthest stage the company has ever reached.specific_campaign — the stage the company holds inside one ABM campaign. Send campaignId with it; without a campaign id it falls back to current_abm_stage.Two older values still work. all_abm_campaigns now means the same as current_abm_stage. linkedin_influenced now means the same as lifetime_abm_stage, and no longer restricts the result to companies with a LinkedIn page. An unknown value falls back to current_abm_stage instead of returning an error.
ABM campaign ID. Used only with campaignType=specific_campaign.
Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"}],"variable":[{"description":{"content":"ABM stage ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"53694dc1-3b92-490c-b545-75d7e1184b3e","name":"Companies progressing from stage","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerStart date (ISO format, default: 30 days ago)
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (ISO format, default: today)
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"}],"variable":[{"description":{"content":"ABM stage ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"3c0c279e-00b4-4621-a3de-18d323b5cf92","name":"Stage transition events — each entry is one company moving from `previousStage` to `abmStage`. `previousStage` is null for the company’s first stage entry.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerApplies one or more changes to the ABM stage funnel. The body is either a single operation object (not wrapped) or { \"operations\": [...] } with 1–10 of them. Each operation is discriminated on op: create_stage, rename_stage, recolor_stage, delete_stage, reorder_stage, set_stage_block_operator, set_stage_conditions, add_condition_block, remove_condition_block, set_block_operator, add_condition, replace_condition, remove_condition. This is the first write endpoint in v1. It is gated by the same API access plan feature as the read endpoints.
Batches. Operations in operations apply in order, and each one sees the result of the one before it — so after a remove_condition_block the later block indexes shift, and a stage created earlier in the batch can be addressed by name later in it. A batch is not atomic: when a step fails, the earlier steps stay applied and the error reports which step failed. Read the stage back before you retry. To rewrite a whole rule, prefer one set_stage_conditions over a batch of remove + add operations.
Names, not ids. Stages, lifecycle stages, deal stages, pipelines, properties, Attio attributes, Ad Sets, Campaigns and ABM campaigns are all addressed by name. Stage names match case-insensitively; a unique prefix or substring also resolves. A stageRef may carry an id instead when you already have one. An unknown or ambiguous name returns 422 UNRESOLVED_REFERENCE and the message lists the available candidates.
Fixed stages. Identified is always first and Customer, Lost and Disqualified are always last. They cannot be moved, renamed or deleted, and a position that would displace them returns 422 INVALID_OPERATION.
Indexes. blockIndex and conditionIndex are 0-based positions in conditionBlocks and in a block’s conditions, exactly as GET /abm-stages/{id} returns them. Read the stage first, then address the block or condition by position. An out-of-range index returns 422 INVALID_OPERATION. replace_condition swaps one condition in place: send the full new condition, or the existing one with a single field changed. set_stage_conditions replaces every block on the stage with the blocks you send (and optionally sets blockOperator), so no index is needed.
Conditions. A contact_property condition matches when at least minMatchingContacts (default 1) of the company’s contacts satisfy it. A deal_stage condition needs pipelineNames when the same stage name repeats across pipelines. A linkedin_metric condition with a scope other than INHERIT_CAMPAIGN needs at least one entry in scopeNames.
Response. data.applied and data.total count the operations that ran and the operations in the request (both 1 for a single operation). data.stage is the stage re-read after the last operation, with the same condition model as GET /abm-stages/{id} (null only when the last operation was delete_stage). data.warnings is non-blocking: it names what a delete_stage removed, and it flags a condition that points at something that no longer exists (a deleted lifecycle stage, deal stage, property or LinkedIn asset) so you can fix it with replace_condition or set_stage_conditions.
Errors. A failed step uses the same status codes as a single operation: 400 INVALID_INPUT, 422 UNRESOLVED_REFERENCE / INVALID_OPERATION, 403 FEATURE_NOT_AVAILABLE / PLAN_NOT_ALLOWED, 404 NOT_FOUND, 502 CRM_UNAVAILABLE. When the request holds more than one operation, the message starts with Step N of M (<op>): .
Returns the intent with the ad sets and campaigns it is assigned to, plus companyCount — the number of companies tagged with this intent.
Intent ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"bc72f4eb-3c25-4883-85db-bab0928fb7f9","name":"Intent details","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns a paginated list of HubSpot contacts with source touchpoint totals, company context, ABM stage context, and related deals.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["contacts"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Items per page (default: 20, max: 100)
\n","type":"text/plain"},"key":"pageSize","value":"20"},{"description":{"content":"Search filter
\n","type":"text/plain"},"key":"search","value":"string"},{"description":{"content":"Start of the source event window (inclusive). ISO-8601 string.
\n","type":"text/plain"},"key":"startDate","value":"2026-04-01T00:00:00.000Z"},{"description":{"content":"End of the source event window (inclusive). ISO-8601 string.
\n","type":"text/plain"},"key":"endDate","value":"2026-05-01T00:00:00.000Z"},{"key":"sortBy","value":"totalClicks"},{"description":{"content":"Sort direction
\n","type":"text/plain"},"key":"sortOrder","value":"desc"},{"description":{"content":"Comma-separated touchpoint keys. Examples: PAID_SEARCH, PAID_SOCIAL|LinkedIn Ads, AI_REFERRALS|AI: ChatGPT.
\n","type":"text/plain"},"key":"touchpoints","value":"PAID_SEARCH,AI_REFERRALS|AI: ChatGPT"},{"description":{"content":"Comma-separated current ABM stage IDs.
\n","type":"text/plain"},"key":"currentAbmStages","value":"string"},{"description":{"content":"Comma-separated lifetime ABM stage IDs.
\n","type":"text/plain"},"key":"lifetimeAbmStages","value":"string"},{"description":{"content":"Filter contacts by their company's deal status. *_in_period variants use the page's startDate/endDate window — created_in_period matches hubspotCreatedAt, won_in_period/lost_in_period match hubspotClosedAt on won / lost deals. Won and lost are resolved from each CRM natively — HubSpot stage isClosed + probability, Salesforce IsClosed/IsWon, Attio status title.
Returns a single contact with company context, source events, related deals, and a weekly source-event timeline.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["contacts",":id"],"host":["https://app.zenabm.com/api/v1"],"query":[],"variable":[{"description":{"content":"Contact ID
\n","type":"text/plain"},"type":"any","value":"string","key":"id"}]}},"response":[{"id":"dafad9c6-147b-460a-8507-74b0d6b552ff","name":"Contact journey detail","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns aggregated contact source events grouped by source type. Each row reports total clicks, distinct contacts, and distinct companies. Filter by an optional date range.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["sources"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Start of the event window (inclusive). ISO-8601 string.
\n","type":"text/plain"},"key":"startDate","value":"2026-04-01T00:00:00.000Z"},{"description":{"content":"End of the event window (inclusive). ISO-8601 string.
\n","type":"text/plain"},"key":"endDate","value":"2026-05-01T00:00:00.000Z"}],"variable":[]}},"response":[{"id":"6878601b-372e-4d26-92b7-4b781572bc34","name":"Aggregated source totals","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns the contacts, companies, and weekly timeline for a single source type within an optional date range. Capped at the most recent 500 events.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["sources",":sourceType"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Optional label filter. Use for split source rows such as PAID_SOCIAL|LinkedIn Ads or AI_REFERRALS|AI: ChatGPT.
\n","type":"text/plain"},"key":"label","value":"AI: ChatGPT"},{"description":{"content":"Time period preset. Ignored when startDate/endDate are provided.
\n","type":"text/plain"},"key":"period","value":"last30Days"},{"description":{"content":"Start of the event window (inclusive). ISO-8601 string. Supply with endDate to override period.
End of the event window (inclusive). ISO-8601 string.
\n","type":"text/plain"},"key":"endDate","value":"2026-05-01T00:00:00.000Z"}],"variable":[{"description":{"content":"Source type identifier (e.g. PAID_SEARCH, PAID_SOCIAL, ORGANIC_SEARCH, AI_REFERRALS, REFERRALS, DIRECT_TRAFFIC, EMAIL_MARKETING, SOCIAL_MEDIA, OFFLINE, OTHER_CAMPAIGNS).
\n","type":"text/plain"},"type":"any","value":"PAID_SEARCH","key":"sourceType"}]}},"response":[{"id":"55906843-6393-4cad-a0b0-78d54dba8e10","name":"Source detail with contact and company breakdowns","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerProfile a competitor's ads. Searches LinkedIn's public Ad Library by advertiser name (fuzzy match) and returns normalized ad metadata (format, EU/EEA impression ranges + per-country split, first/last impression dates, and which targeting facets were used). LinkedIn's advertiser search is fuzzy, so responses include an advertisers list — pick the right companyId from it and pass it back to filter to the exact advertiser. Country and date filters are applied over the returned ads. Impression/targeting data is EU/EEA-only (DSA); US-only advertisers return null statistics (treat as unknown, not zero).
Advertiser name, vanity slug, or a linkedin.com/company/... URL to search for.
\n","type":"text/plain"},"key":"company","value":"string"},{"description":{"content":"Canonical LinkedIn company ID to filter results to the exact advertiser (guards against fuzzy-name collisions). Auto-derived when company is a /company/ URL.
Comma-separated ISO 3166-1 alpha-2 codes (e.g. \"DE,FR\"). Keeps ads with EU/EEA impressions in any listed country.
\n","type":"text/plain"},"key":"countries","value":"string"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Max ads to return after filtering (default: 25, max: 100).
\n","type":"text/plain"},"key":"limit","value":"25"}],"variable":[]}},"response":[{"id":"6f3a7109-c375-4a5e-92fe-1da7122b32f9","name":"Ad Library search results","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerDiscover who advertises on a topic. Full-text searches LinkedIn's public Ad Library ad copy and returns the same normalized ad metadata as /ad-library/by-advertiser. Optionally narrow to a single advertiser. Country and date filters are applied over the returned ads. Impression/targeting data is EU/EEA-only (DSA).
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["ad-library","by-keyword"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Full-text phrase to match in ad copy.
\n","type":"text/plain"},"key":"keyword","value":"string"},{"description":{"content":"Optional advertiser name to narrow keyword results (ANDed with the keyword).
\n","type":"text/plain"},"key":"advertiser","value":"string"},{"description":{"content":"Comma-separated ISO 3166-1 alpha-2 codes (e.g. \"DE,FR\"). Keeps ads with EU/EEA impressions in any listed country.
\n","type":"text/plain"},"key":"countries","value":"string"},{"description":{"content":"Start date (YYYY-MM-DD). When provided with endDate, overrides the period parameter.
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (YYYY-MM-DD). When provided with startDate, overrides the period parameter.
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"},{"description":{"content":"Max ads to return after filtering (default: 25, max: 100).
\n","type":"text/plain"},"key":"limit","value":"25"}],"variable":[]}},"response":[{"id":"a1de72be-8508-4f3d-b95c-2bbb56be797f","name":"Ad Library search results","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerReturns a high-level overview with top companies, total metrics, and ad spend for the given date range.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","id":"3ec71edb-85df-42f3-86ed-ff1e36e2ba3f","name":"ZenABM API (from spec)","type":"collection"}},"urlObject":{"path":["dashboard"],"host":["https://app.zenabm.com/api/v1"],"query":[{"description":{"content":"Start date (default: 30 days ago)
\n","type":"text/plain"},"key":"startDate","value":"2018-09-03"},{"description":{"content":"End date (default: today)
\n","type":"text/plain"},"key":"endDate","value":"2018-09-03"}],"variable":[]}},"response":[{"id":"89814d8b-ecf7-4367-bd01-c481714d9967","name":"Dashboard overview with top companies, metrics, and ad spend","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer