LinkedIn API Capability

Get company posts

Reads the bounded anonymous company feed with max_pages, opaque continuation, deduplication and local text/date/media filters.

Capability ID linkedin.company.posts

Cost From $1.25 per 1,000 requests · 1 credit

Maximum runtime 240 seconds

View raw

# Get company posts

Reads the bounded anonymous company feed with max_pages, opaque continuation, deduplication and local text/date/media filters.

- Platform: [LinkedIn](https://docs.upscrape.com/docs/platforms/linkedin)
- Capability ID: `linkedin.company.posts`
- Cost: 1 credit per request
- Maximum runtime: 240 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

```bash
curl --request POST \
  --url https://data.upscrape.com/execute \
  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {
    "limit": 20,
    "max_pages": 3,
    "url": "https://www.linkedin.com/company/microsoft/"
  },
  "capability": "linkedin.company.posts"
}'
```

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `company_name` | `string` | No | Alternative to url: resolves one exact, case-insensitive COMPANY autocomplete match. Ambiguous or absent matches require a URL; adds one request on a fresh run. |
| `cursor` | `string` | No | Opaque next_cursor from an earlier response. Keep target and filters unchanged; limit/max_pages may change. Expires after one hour; upstream may expire earlier. Cursors are encoded but unsigned: their contents are not cryptographically authenticated. Pass them back unchanged; do not use them as authorization tokens. |
| `include_media` | `boolean` | No | Include media metadata/URLs. Filtering still examines media when false; no media files are downloaded. |
| `keyword` | `string` | No | Case-insensitive substring filter on returned post text, applied locally; does not invoke LinkedIn search. |
| `limit` | `integer` | No | Maximum matching posts returned, after local filters and deduplication. |
| `max_pages` | `integer` | No | Maximum feed-page attempts per call, including the overview when needed. No hidden page retries. The guest chain has at most seven pages including the overview; company-name resolution is separate. This is an upper bound: the host deadline may stop execution earlier. LinkedIn results may change between requests; pagination does not provide a consistent snapshot. |
| `media_types` | `array<string>` | No | Local media filter; text means no recognized media. Empty means all types. |
| `posted_after` | `string` | No | Inclusive source date/time lower bound: YYYY-MM-DD or RFC3339. Posts lacking an exact source date are skipped and counted. |
| `posted_before` | `string` | No | Exclusive source date/time upper bound; must be later than posted_after. Dates without a time are midnight UTC. |
| `url` | `string` | No | Company URL or slug, including an existing company subpage URL; the overview is resolved internally. |

### Example input

```json
{
  "limit": 20,
  "max_pages": 3,
  "url": "https://www.linkedin.com/company/microsoft/"
}
```

## Response

Successful output is returned in `results[0].data`. Raw platform output is intentionally open-ended and may evolve with the upstream source.

### Illustrative sample output

This redacted fixture is an example, not a fixed response schema.

```json
{
  "company_id": "1035",
  "company_url": "https://www.linkedin.com/company/example",
  "count": 1,
  "coverage": {
    "limitations": [
      "Synthetic illustration; not a live scrape result."
    ],
    "missing_fields": [],
    "source": "linkedin_company_guest_feed",
    "status": "partial_public",
    "truncated_fields": []
  },
  "has_more": null,
  "next_cursor": null,
  "pages_attempted": 1,
  "pages_fetched": 1,
  "results": [
    {
      "activity_id": "100",
      "author": {
        "followers": null,
        "name": "Example Company",
        "url": "https://www.linkedin.com/company/example"
      },
      "comment_count": 12,
      "date_precision": "date",
      "media": [],
      "published_at": "2026-09-20",
      "published_text": "1w",
      "reaction_count": 0,
      "share_count": null,
      "text": "Synthetic company announcement.",
      "url": "https://www.linkedin.com/feed/update/urn:li:activity:100"
    }
  ],
  "skipped_missing_date": 0,
  "stop_reason": "continuation_unavailable",
  "truncated": true
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `company_id` | `string` | 1035 |
| `company_url` | `string` | https://www.linkedin.com/company/example |
| `count` | `integer` | 1 |
| `coverage` | `object` | 5 fields |
| `coverage.limitations` | `array` | 1 items |
| `coverage.missing_fields` | `array` | 0 items |
| `coverage.source` | `string` | linkedin_company_guest_feed |
| `coverage.status` | `string` | partial_public |
| `coverage.truncated_fields` | `array` | 0 items |
| `has_more` | `null` | null |
| `next_cursor` | `null` | null |
| `pages_attempted` | `integer` | 1 |
| `pages_fetched` | `integer` | 1 |
| `results` | `array` | 1 items |
| `results` | `array` | 1 items |
| `skipped_missing_date` | `integer` | 0 |
| `stop_reason` | `string` | continuation_unavailable |
| `truncated` | `boolean` | true |

## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)

POST /execute Shared execution endpoint

Input parameters

company_name string optional

Alternative to url: resolves one exact, case-insensitive COMPANY autocomplete match. Ambiguous or absent matches require a URL; adds one request on a fresh run.

Example Microsoft

cursor string optional

Opaque next_cursor from an earlier response. Keep target and filters unchanged; limit/max_pages may change. Expires after one hour; upstream may expire earlier. Cursors are encoded but unsigned: their contents are not cryptographically authenticated. Pass them back unchanged; do not use them as authorization tokens.

include_media boolean optional

Include media metadata/URLs. Filtering still examines media when false; no media files are downloaded.

keyword string optional

Case-insensitive substring filter on returned post text, applied locally; does not invoke LinkedIn search.

limit integer optional

Maximum matching posts returned, after local filters and deduplication.

Example 20

max_pages integer optional

Maximum feed-page attempts per call, including the overview when needed. No hidden page retries. The guest chain has at most seven pages including the overview; company-name resolution is separate. This is an upper bound: the host deadline may stop execution earlier. LinkedIn results may change between requests; pagination does not provide a consistent snapshot.

Example 3

media_types array<string> optional

Local media filter; text means no recognized media. Empty means all types.

posted_after string optional

Inclusive source date/time lower bound: YYYY-MM-DD or RFC3339. Posts lacking an exact source date are skipped and counted.

posted_before string optional

Exclusive source date/time upper bound; must be later than posted_after. Dates without a time are midnight UTC.

url string optional

Company URL or slug, including an existing company subpage URL; the overview is resolved internally.

Example https://www.linkedin.com/company/microsoft/

Response

Successful output is returned in results[0].data. Raw platform output is intentionally open-ended and may evolve with the upstream source.

Illustrative sample The full redacted fixture is shown in the response panel.

Illustrative output fields

Derived from the sample above for orientation only. These observed fields are not a fixed response schema.

Path	Observed type	Example
`company_id`	`string`	1035
`company_url`	`string`	https://www.linkedin.com/company/example
`count`	`integer`	1
`coverage`	`object`	5 fields
`coverage.limitations`	`array`	1 items
`coverage.missing_fields`	`array`	0 items
`coverage.source`	`string`	linkedin_company_guest_feed
`coverage.status`	`string`	partial_public
`coverage.truncated_fields`	`array`	0 items
`has_more`	`null`	null
`next_cursor`	`null`	null
`pages_attempted`	`integer`	1
`pages_fetched`	`integer`	1
`results`	`array`	1 items
`results`	`array`	1 items
`skipped_missing_date`	`integer`	0
`stop_reason`	`string`	continuation_unavailable
`truncated`	`boolean`	true

Execution behavior

A 200 response completed inline. A 202 response was queued; poll GET /jobs/:id until the job reaches completed or failed.

curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "input": { "limit": 20, "max_pages": 3, "url": "https://www.linkedin.com/company/microsoft/" }, "capability": "linkedin.company.posts" }'

import json import os import requests payload = json.loads(r'''{ "input": { "limit": 20, "max_pages": 3, "url": "https://www.linkedin.com/company/microsoft/" }, "capability": "linkedin.company.posts" }''') response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload, ) response.raise_for_status() print(json.dumps(response.json(), indent=2))

{ "company_id": "1035", "company_url": "https://www.linkedin.com/company/example", "count": 1, "coverage": { "limitations": [ "Synthetic illustration; not a live scrape result." ], "missing_fields": [], "source": "linkedin_company_guest_feed", "status": "partial_public", "truncated_fields": [] }, "has_more": null, "next_cursor": null, "pages_attempted": 1, "pages_fetched": 1, "results": [ { "activity_id": "100", "author": { "followers": null, "name": "Example Company", "url": "https://www.linkedin.com/company/example" }, "comment_count": 12, "date_precision": "date", "media": [], "published_at": "2026-09-20", "published_text": "1w", "reaction_count": 0, "share_count": null, "text": "Synthetic company announcement.", "url": "https://www.linkedin.com/feed/update/urn:li:activity:100" } ], "skipped_missing_date": 0, "stop_reason": "continuation_unavailable", "truncated": true }