LinkedIn Marketing API Additional Info Fields

Warning

Deprecation Notice: The Marketing Version 202505 (Marketing May 2025) has been sunset. We recommend that you migrate to the latest versioned APIs to avoid disruptions. For information on all the supported versions, refer to the migrations documentation. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

Additional Info Fields are the replacement for API Decoration. These fields provide additional information for a field that's present in a schema. For example, the referenceInfo field in Accounts provides information about the reference field. The field needs to be explicitly specified in projections for it to be returned in the response. For example, to get referenceInfo field in Accounts, you must specify the reference info in the request projection.

GET https://api.linkedin.com/rest/adAccounts/{adAccountID}?fields=id,name,reference,referenceInfo

Sample Response

{
    "reference": "urn:li:person:xdfs902",
    "name": "Account Name",
    "id": 1234,
    "referenceInfo": {
        "person": {
            "vanityName": "john.doe",
            "id": "xdfs902"
        }
    }
}

API Decoration Deprecation

API Decoration is a mechanism in LinkedIn's APIs to fetch data belonging to a URN object without having to make an extra call to that object's API. We have decided to deprecate API Decoration as we have found the syntax to not be user friendly. We're instead going to enhance the API schemas with the fields that are commonly queried in decoration requests.

Important

Refer to this video to understand how to handle the deprecation of API decoration.

We're going to roll out these changes a few APIs at a time every month. Refer to recent changes page to know which APIs will have the new enhanced schemas. These changes are going to be versioned, the old way of API Decoration will be available in the older versions. The newer versions won't support API decorations and will have enhanced schemas.

  • Last updated on