Share via

LinkedIn Marketing API Additional Info Fields

  • Article

Warning

Deprecation Notice
The Marketing Version 202311 (Marketing November 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details. 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 is 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 are instead going to enhance the API schemas with the fields that are commonly queried in decoration requests.

Important

You can refer to this video to understand how to handle the deprecation of API decoration.

We are 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 will not support API decorations and will have enhanced schemas.