Get Person Posts

GET

https://data.api.aviato.co/social/person/posts

GET

/social/person/posts

curl https://data.api.aviato.co/social/person/posts \
     -H "Authorization: Bearer <token>"

{
  "results": [
    {
      "urn": "urn",
      "actor": {
        "linkedinURL": "linkedinURL",
        "name": "name",
        "entityType": "entityType",
        "image": "image",
        "linkedinID": "linkedinID"
      },
      "postRange": {
        "earliest": "2024-01-15T09:30:00Z",
        "latest": "2024-01-15T09:30:00Z"
      },
      "postAge": "postAge",
      "socialActivityCounts": {
        "commentsCount": 1,
        "sharesCount": 1,
        "reactionsCount": 1,
        "reactionTypeCounts": [
          {
            "count": 1,
            "reactionType": "reactionType"
          },
          {
            "count": 1,
            "reactionType": "reactionType"
          }
        ]
      },
      "images": [
        "images",
        "images"
      ],
      "url": "url",
      "video": {
        "url": "url",
        "thumbnail": "thumbnail"
      },
      "resharedPost": {
        "urn": "urn",
        "actor": {
          "linkedinURL": "linkedinURL",
          "name": "name",
          "entityType": "entityType",
          "image": "image",
          "linkedinID": "linkedinID"
        },
        "postRange": {
          "earliest": "2024-01-15T09:30:00Z",
          "latest": "2024-01-15T09:30:00Z"
        },
        "postAge": "postAge",
        "socialActivityCounts": {
          "commentsCount": 1,
          "sharesCount": 1,
          "reactionsCount": 1,
          "reactionTypeCounts": [
            {
              "count": 1,
              "reactionType": "reactionType"
            },
            {
              "count": 1,
              "reactionType": "reactionType"
            }
          ]
        },
        "images": [
          "images",
          "images"
        ],
        "url": "url",
        "video": {
          "url": "url",
          "thumbnail": "thumbnail"
        },
        "resharedPost": {
          "urn": "urn",
          "actor": {
            "linkedinURL": "linkedinURL",
            "name": "name",
            "entityType": "entityType",
            "image": "image",
            "linkedinID": "linkedinID"
          },
          "postRange": {
            "earliest": "2024-01-15T09:30:00Z",
            "latest": "2024-01-15T09:30:00Z"
          },
          "postAge": "postAge",
          "socialActivityCounts": {
            "commentsCount": 1,
            "sharesCount": 1,
            "reactionsCount": 1,
            "reactionTypeCounts": []
          },
          "images": [
            "images",
            "images"
          ],
          "url": "url",
          "video": {
            "url": "url",
            "thumbnail": "thumbnail"
          },
          "resharedPost": {
            "urn": "urn",
            "actor": {
              "linkedinURL": "linkedinURL",
              "name": "name",
              "entityType": "entityType"
            },
            "postRange": {
              "earliest": "2024-01-15T09:30:00Z",
              "latest": "2024-01-15T09:30:00Z"
            },
            "postAge": "postAge",
            "socialActivityCounts": {},
            "images": [
              "images",
              "images"
            ],
            "url": "url",
            "video": {},
            "commentary": "commentary",
            "header": "header"
          },
          "commentary": "commentary",
          "header": "header",
          "headerEntity": {
            "entityType": "entityType",
            "image": "image",
            "linkedinURL": "linkedinURL",
            "linkedinID": "linkedinID",
            "name": "name"
          }
        },
        "commentary": "commentary",
        "header": "header",
        "headerEntity": {
          "entityType": "entityType",
          "image": "image",
          "linkedinURL": "linkedinURL",
          "linkedinID": "linkedinID",
          "name": "name"
        }
      },
      "commentary": "commentary",
      "header": "header",
      "headerEntity": {
        "entityType": "entityType",
        "image": "image",
        "linkedinURL": "linkedinURL",
        "linkedinID": "linkedinID",
        "name": "name"
      }
    },
    {
      "urn": "urn",
      "actor": {
        "linkedinURL": "linkedinURL",
        "name": "name",
        "entityType": "entityType",
        "image": "image",
        "linkedinID": "linkedinID"
      },
      "postRange": {
        "earliest": "2024-01-15T09:30:00Z",
        "latest": "2024-01-15T09:30:00Z"
      },
      "postAge": "postAge",
      "socialActivityCounts": {
        "commentsCount": 1,
        "sharesCount": 1,
        "reactionsCount": 1,
        "reactionTypeCounts": [
          {
            "count": 1,
            "reactionType": "reactionType"
          },
          {
            "count": 1,
            "reactionType": "reactionType"
          }
        ]
      },
      "images": [
        "images",
        "images"
      ],
      "url": "url",
      "video": {
        "url": "url",
        "thumbnail": "thumbnail"
      },
      "resharedPost": {
        "urn": "urn",
        "actor": {
          "linkedinURL": "linkedinURL",
          "name": "name",
          "entityType": "entityType",
          "image": "image",
          "linkedinID": "linkedinID"
        },
        "postRange": {
          "earliest": "2024-01-15T09:30:00Z",
          "latest": "2024-01-15T09:30:00Z"
        },
        "postAge": "postAge",
        "socialActivityCounts": {
          "commentsCount": 1,
          "sharesCount": 1,
          "reactionsCount": 1,
          "reactionTypeCounts": [
            {
              "count": 1,
              "reactionType": "reactionType"
            },
            {
              "count": 1,
              "reactionType": "reactionType"
            }
          ]
        },
        "images": [
          "images",
          "images"
        ],
        "url": "url",
        "video": {
          "url": "url",
          "thumbnail": "thumbnail"
        },
        "resharedPost": {
          "urn": "urn",
          "actor": {
            "linkedinURL": "linkedinURL",
            "name": "name",
            "entityType": "entityType",
            "image": "image",
            "linkedinID": "linkedinID"
          },
          "postRange": {
            "earliest": "2024-01-15T09:30:00Z",
            "latest": "2024-01-15T09:30:00Z"
          },
          "postAge": "postAge",
          "socialActivityCounts": {
            "commentsCount": 1,
            "sharesCount": 1,
            "reactionsCount": 1,
            "reactionTypeCounts": []
          },
          "images": [
            "images",
            "images"
          ],
          "url": "url",
          "video": {
            "url": "url",
            "thumbnail": "thumbnail"
          },
          "resharedPost": {
            "urn": "urn",
            "actor": {
              "linkedinURL": "linkedinURL",
              "name": "name",
              "entityType": "entityType"
            },
            "postRange": {
              "earliest": "2024-01-15T09:30:00Z",
              "latest": "2024-01-15T09:30:00Z"
            },
            "postAge": "postAge",
            "socialActivityCounts": {},
            "images": [
              "images",
              "images"
            ],
            "url": "url",
            "video": {},
            "commentary": "commentary",
            "header": "header"
          },
          "commentary": "commentary",
          "header": "header",
          "headerEntity": {
            "entityType": "entityType",
            "image": "image",
            "linkedinURL": "linkedinURL",
            "linkedinID": "linkedinID",
            "name": "name"
          }
        },
        "commentary": "commentary",
        "header": "header",
        "headerEntity": {
          "entityType": "entityType",
          "image": "image",
          "linkedinURL": "linkedinURL",
          "linkedinID": "linkedinID",
          "name": "name"
        }
      },
      "commentary": "commentary",
      "header": "header",
      "headerEntity": {
        "entityType": "entityType",
        "image": "image",
        "linkedinURL": "linkedinURL",
        "linkedinID": "linkedinID",
        "name": "name"
      }
    }
  ],
  "hasMoreResults": true,
  "paginationToken": "paginationToken"
}

Get posts from a person’s LinkedIn profile. Must pass either linkedinEntityID or linkedinID. Valid empty results return HTTP 200 and are not charged. An unavailable LinkedIn resource returns 404; upstream failures, including timeouts and invalid responses, return 502; temporary service unavailability returns 503.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

linkedinEntityIDstringOptional

LinkedIn entity ID for the person, this is the preferred and faster identifier for posts.

linkedinIDstringOptional

LinkedIn ID for the person, this is the slower and less preferred identifer for posts.

perPageintegerOptional0-100Defaults to 10

Number of items per page

paginationTokenstringOptional

Token for pagination, required to return results beyond the first page.

Response

This endpoint returns an object.

resultslist of objects

hasMoreResultsboolean

paginationTokenstringOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Linked IN Resource Not Found Error

410

Linked IN Pagination Session Expired Error

429

Rate Limit Error

502

Linked IN Upstream Error

503

Linked IN Unavailable Error