Zernio
APIFor you
Zernio
APIFor you
Platforms

LinkedIn

Overview

Publish

PostsPlatform Fields & TargetingMedia Requirements

Engage

AnalyticsInbox

Reference

Limits & Errors
Dashboard
OverviewPlatformsAPI ReferenceResources
LinkedIn

Platform Fields & Targeting

Every platformSpecificData field for LinkedIn, and audience targeting on organization pages.


Audience targeting (organization pages)

audience applies LinkedIn organization-page audience targeting (Ads Manager's "Targeted audience"). It is rejected on personal profiles, and LinkedIn rejects the post when the targeted audience is under 300 members.

Targeting is OR within a facet (e.g., any of the listed industries) and AND across facets (e.g., industry AND seniority).

Note: audience.countries is merged with geoRestriction.countries (same ISO code list). Use audience.geoLocations for countries/regions/cities not covered by the built-in country mapping.

curl -X POST https://zernio.com/api/v1/posts \
  -H "Authorization: Bearer $ZERNIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "We are hiring across EMEA.",
    "platforms": [
      {
        "platform": "linkedin",
        "accountId": "66b2e19d8c3f5a7e9d0b1c2d",
        "platformSpecificData": {
          "organizationUrn": "urn:li:organization:111111111",
          "audience": {
            "countries": ["ES", "DE"],
            "industries": ["urn:li:industry:4"],
            "seniorities": ["urn:li:seniority:6"],
            "staffCountRanges": ["SIZE_51_TO_200", "SIZE_201_TO_500"],
            "interfaceLocales": [{"language": "es", "country": "ES"}]
          }
        }
      }
    ],
    "publishNow": true
  }'

To find targeting ids, use GET /v1/ads/targeting/search?platform=linkedin (types: country, region, industry, jobFunction, seniority, companySize). URN facets accept either a full urn:li:<type>:<id> or the bare numeric id.

Platform fields

All fields go in platformSpecificData on the LinkedIn entry.

FieldTypeDefaultDescription
documentTitlestringmedia item title, then filenameTitle shown on document (PDF/carousel) posts. LinkedIn requires one for document posts.
organizationUrnstring(default organization or personal profile)Post to a specific organization page, urn:li:organization:123456. List the options with GET /v1/accounts/{accountId}/linkedin-organizations.
firstCommentstringPosted as the first comment after publishing.
disableLinkPreviewbooleanfalsetrue suppresses the automatic URL preview card.
audienceobjectOrganization pages only. Audience targeting (OR within a facet, AND across facets). LinkedIn rejects targeting under 300 members.
audience.countriesArray<string>Up to 25 ISO 3166-1 alpha-2 codes with a built-in LinkedIn geo URN (merged with geoRestriction.countries).
audience.geoLocationsArray<string>LinkedIn geo URNs or ids (urn:li:geo:<id> or <id>): countries, states, regions, cities.
audience.interfaceLocalesArray<{language, country}>Members' LinkedIn interface locale, e.g. { language: "es", country: "ES" }.
audience.industriesArray<string>urn:li:industry:<id> or id.
audience.jobFunctionsArray<string>urn:li:function:<id> or id.
audience.senioritiesArray<string>urn:li:seniority:<id> or id.
audience.staffCountRangesArray<"SIZE_1" | "SIZE_2_TO_10" | "SIZE_11_TO_50" | "SIZE_51_TO_200" | "SIZE_201_TO_500" | "SIZE_501_TO_1000" | "SIZE_1001_TO_5000" | "SIZE_5001_TO_10000" | "SIZE_10001_OR_MORE">Company size of the member's current employer.
audience.degreesArray<string>urn:li:degree:<id> or id.
audience.fieldsOfStudyArray<string>urn:li:fieldOfStudy:<id> or id.
audience.organizationsArray<string>Schools, as urn:li:organization:<id> or id.
reshareUrlstringPost link or urn:li:share / urn:li:ugcPost / urn:li:groupPost URN to repost. Mutually exclusive with mediaItems. See Repost.
poll{question, options, duration?}Create a poll. Cannot be combined with mediaItems or reshareUrl. See Poll.
poll.questionstring1 to 140 characters.
poll.optionsArray<string>2 to 4 choices, 1 to 30 characters each.
poll.duration"ONE_DAY" | "THREE_DAYS" | "SEVEN_DAYS" | "FOURTEEN_DAYS""SEVEN_DAYS"How long the poll accepts votes.
geoRestriction{countries}Restrict visibility to up to 25 countries. Organization pages only, 300+ targeted followers. See Geo-restriction.
Was this page helpful?

Posts

Publish text, image, video, document, poll and repost posts to LinkedIn, post to several organizations, restrict by country and edit a published post.

Media Requirements

Image, video and document requirements for LinkedIn posts, and the rules for media URLs.

On this page

Audience targeting (organization pages)Platform fields