---
title: "Get company posts"
method: GET
path: "/v2/social/company/posts"
tags: ["Social"]
---

# Get company posts

`GET /v2/social/company/posts`

Get posts from a company's LinkedIn page. Provide either `linkedinNumID` or `linkedinID`.

A valid empty result is not charged.

## Query parameters

- `linkedinNumID` string, nullable — LinkedIn numeric company ID (e.g. "35625249"). The preferred, faster identifier.
- `linkedinID` string, nullable — LinkedIn vanity ID (e.g. "google"). Slower and less preferred than linkedinNumID.
- `page` integer — Page number (1-indexed)
- `perPage` integer — Number of items per page
- `apiToken` string, nullable

## Headers

- `x-api-token` string, nullable

## Response `200`

Successful Response

- CompanyPostsResult
  - `results` SocialPost[]
    - `urn` string, nullable
    - `actor` SocialActor
      - `linkedinURL` string, nullable
      - `name` string, nullable
      - `entityType` string, nullable
      - `image` string, nullable
      - `linkedinID` string, nullable
    - `postRange` SocialPostRange
      - `earliest` string, date-time, nullable
      - `latest` string, date-time, nullable
    - `postAge` string, nullable
    - `socialActivityCounts` SocialActivityCounts
      - `commentsCount` integer, nullable
      - `sharesCount` integer, nullable
      - `reactionsCount` integer, nullable
      - `reactionTypeCounts` ReactionTypeCount[]
        - `count` integer, nullable
        - `reactionType` string, nullable
    - `images` string[]
    - `url` string, nullable
    - `video` SocialVideo
      - `url` string, nullable
      - `thumbnail` string, nullable
    - `resharedPost` SocialPost — recursive
    - `commentary` string, nullable
    - `header` string, nullable
    - `headerEntity` SocialActor
      - `linkedinURL` string, nullable
      - `name` string, nullable
      - `entityType` string, nullable
      - `image` string, nullable
      - `linkedinID` string, nullable
  - `page` integer, nullable
  - `pages` integer, nullable
  - `totalResults` integer, nullable
  - `creditsUsed` number — Number of credits charged for this request.

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `403` — Forbidden
- `404` — Not found
- `422` — Validation Error

## Changes

- **2026-09-25** `3ccf293818ca` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ocean/apis/ocean-io-api-documentation/changes/v2/social/company/posts/get.md)

---

[API](https://skmtc.dev/ocean/apis/ocean-io-api-documentation.md) · [All operations](https://skmtc.dev/ocean/apis/ocean-io-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/ocean/apis/ocean-io-api-documentation/revisions/3ccf293818ca?raw)