---
title: "Get company posts"
method: GET
path: "/api/v1/enrichment/company-posts"
tags: ["Enrichment"]
---

# Get company posts

`GET /api/v1/enrichment/company-posts`

## Request

- Base URL: `https://api.rodz.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rodz.io/api/v1/enrichment/company-posts`
- Auth: HTTP bearer

Monitor a company's public LinkedIn posts — their content strategy, product announcements, and hiring signals, plus audience engagement (reactions, comments, shares, reaction types).

**Input:** the company's LinkedIn page URL (`company`), or its LinkedIn company ID (`companyId`), or company universal name / handle (`companyUniversalName` — the last segment of the company URL, fastest). Filter posts to a time window with `scrapePostedLimit` (`1h`, `24h`, `week`, `month`, `3months`, `6months`, or `year`). Paginate with `paginationToken` (or `page` for numeric pagination).

**Output:** each page returns an array of posts from the company's feed, newest first, with full content, media (images, links, articles), author metadata (company name, logo, website), and engagement stats (reaction counts by type, comment count, share count). Pagination metadata (token, page size, and totals when available) lets you fetch all posts. 0.5 credits per page; pages are returned even if empty (and not billed).

## Query parameters

- `company` string, nullable: LinkedIn company URL
- `companyId` string, nullable: LinkedIn company ID (faster)
- `companyUniversalName` string, nullable: Company universal name (last part of URL)
- `scrapePostedLimit` string, nullable: Time filter: 1h, 24h, week, month, 3months, 6months, year
- `page` integer, nullable: Page number
- `paginationToken` string, nullable: Pagination token from previous page

## Response `200`

Recent posts for the company page.

- object: Typed response for the posts endpoints (profile & company).
  - `data` object, nullable: Posts payload, or null if none found
    - `elements` object[], nullable
      - `id` string, nullable
      - `linkedinUrl` string, nullable
      - `content` string, nullable
      - `author` object, nullable
        - `id` string, nullable
        - `universalName` string, nullable
        - `publicIdentifier` string, nullable
        - `type` string, nullable: "profile" or "company"
        - `name` string, nullable
        - `linkedinUrl` string, nullable
        - `info` string, nullable
        - `website` string, nullable
        - `websiteLabel` string, nullable
        - `avatar` object, nullable
          - `url` string, nullable
          - `width` integer, nullable
          - `height` integer, nullable
        - `urn` string, nullable
      - `postedAt` object, nullable
        - `timestamp` integer, nullable
        - `date` string, nullable
        - `postedAgoShort` string, nullable
        - `postedAgoText` string, nullable
      - `postImages` object[], nullable
        - `url` string, nullable
        - `width` integer, nullable
        - `height` integer, nullable
      - `shareUrn` string, nullable
      - `shareLinkedinUrl` string, nullable
      - `entityId` string, nullable
      - `engagement` object, nullable
        - `id` string, nullable
        - `likes` integer, nullable
        - `comments` integer, nullable
        - `shares` integer, nullable
        - `reactions` object[], nullable
          - `type` string, nullable
          - `count` integer, nullable
      - `contentAttributes` object[], nullable: Rich-text spans inside `content` (mentions, links)
        - `start` integer, nullable
        - `length` integer, nullable
        - `type` string, nullable: Entity kind, e.g. "COMPANY_NAME" or "PROFILE_MENTION"
        - `hyperlink` string, nullable
        - `textLink` string, nullable
        - `company` object, nullable: Company referenced by a COMPANY_NAME entity in ``contentAttributes``.
          - `id` string, nullable
          - `name` string, nullable
          - `linkedinUrl` string, nullable
          - `publicIdentifier` string, nullable
          - `universalName` string, nullable
        - `profile` object, nullable: Person referenced by a PROFILE_MENTION entity in ``contentAttributes``.
          - `id` string, nullable
          - `firstName` string, nullable
          - `lastName` string, nullable
          - `linkedinUrl` string, nullable
          - `publicIdentifier` string, nullable
      - `article` object, nullable: Link preview when the post shares an external article.
        - `title` string, nullable
        - `subtitle` string, nullable
        - `link` string, nullable
        - `linkLabel` string, nullable
        - `description` string, nullable
        - `image` object, nullable
          - `url` string, nullable
          - `width` integer, nullable
          - `height` integer, nullable
      - `socialContent` object, nullable: Display flags LinkedIn attaches to the post.
        - `hideCommentsCount` boolean, nullable
        - `hideReactionsCount` boolean, nullable
        - `hideSocialActivityCounts` boolean, nullable
        - `hideShareAction` boolean, nullable
        - `hideSendAction` boolean, nullable
        - `hideRepostsCount` boolean, nullable
        - `hideViewsCount` boolean, nullable
        - `showContributionExperience` boolean, nullable
        - `showSocialDetail` boolean, nullable
        - `shareUrl` string, nullable
        - `trustInterventionBanner` string, nullable
      - `header` object, nullable
        - `text` string, nullable
      - `postVideo` object, nullable: Present when the post carries a native video.
        - `thumbnailUrl` string, nullable
        - `videoUrl` string, nullable
      - `document` object, nullable: Present when the post carries a document/carousel. Profile posts only.
        - `title` string, nullable
        - `transcribedDocumentUrl` string, nullable
        - `coverPages` object[], nullable
          - `width` integer, nullable
          - `imageUrls` string[], nullable
      - `repostedBy` object, nullable: Original author when this element is a repost. Profile posts only.
        - `name` string, nullable
        - `publicIdentifier` string, nullable
        - `universalName` string, nullable
        - `linkedinUrl` string, nullable
      - `repostedAt` object, nullable: When the repost happened. Profile posts only.
        - `timestamp` integer, nullable
        - `date` string, nullable
        - `postedAgoShort` string, nullable
        - `postedAgoText` string, nullable
      - `comments` object[], nullable: Always an empty array on the post-list endpoints — a post list does not expand comments, regardless of `engagement.comments`. Use GET /enrichment/post-comments to fetch them.
    - `pagination` object, nullable
      - `totalElements` integer, nullable
      - `totalPages` integer, nullable
      - `pageNumber` integer, nullable
      - `previousElements` integer, nullable
      - `pageSize` integer, nullable
      - `paginationToken` string, nullable
  - `requestId` string, nullable: Unique request identifier
  - `reason` string, nullable: Why no posts were returned, when `data` is null. Otherwise null.

## Other responses

- `400`: No search parameter supplied — provide at least one.
- `422`: Validation Error
- `429`: Rate limit exceeded. Retry after the number of seconds in the `Retry-After` response header.

---

[API](https://skmtc.dev/rodz/apis/rodz-api.md) · [All operations](https://skmtc.dev/rodz/apis/rodz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rodz/apis/rodz-api/revisions/3003505ff896?raw)