curl --request POST \
--url https://api.airscale.io/v1/company-posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"company_url": "https://www.linkedin.com/company/example-company"
}
'
{
"items": [
{
"post_url": "https://www.linkedin.com/posts/example-company_launch-activity-7511035039397339137-abcd",
"post_id": "7511035039397339137",
"content": "Launch day",
"posted_at": "2026-09-30T11:00:00.000Z",
"author": {
"type": "company",
"name": "Example Company",
"linkedin_url": "https://www.linkedin.com/company/example-company",
"headline": "1,117 followers",
"picture_url": "https://www.example.org/images/example-company.png"
},
"likes": 12,
"comments": 3,
"shares": 1,
"feed_context": null,
"image_urls": [
"https://www.example.org/images/example-post.png"
]
}
],
"pagination": {
"has_more": true,
"next_cursor": "eyJ2IjoxLCJyIjoiZXhhbXBsZSJ9",
"total": 500
},
"billing": {
"credits_consumed": 1
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Company posts
Retrieve a LinkedIn company page’s feed, newest first. Rate limit: 180 requests per fixed minute per workspace, counted separately for each LinkedIn content endpoint; pagination requests and retries count.
POST
/
v1
/
company-posts
curl --request POST \
--url https://api.airscale.io/v1/company-posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"company_url": "https://www.linkedin.com/company/example-company"
}
'
{
"items": [
{
"post_url": "https://www.linkedin.com/posts/example-company_launch-activity-7511035039397339137-abcd",
"post_id": "7511035039397339137",
"content": "Launch day",
"posted_at": "2026-09-30T11:00:00.000Z",
"author": {
"type": "company",
"name": "Example Company",
"linkedin_url": "https://www.linkedin.com/company/example-company",
"headline": "1,117 followers",
"picture_url": "https://www.example.org/images/example-company.png"
},
"likes": 12,
"comments": 3,
"shares": 1,
"feed_context": null,
"image_urls": [
"https://www.example.org/images/example-post.png"
]
}
],
"pagination": {
"has_more": true,
"next_cursor": "eyJ2IjoxLCJyIjoiZXhhbXBsZSJ9",
"total": 500
},
"billing": {
"credits_consumed": 1
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Retrieve one synchronous page of up to 50 posts from a LinkedIn company page’s feed, newest first. Each post carries its author, content, publication date, engagement counts, and image URLs. Rows are returned as found on LinkedIn, without profile enrichment.
Each successful request costs 1 credit, whatever the number of posts returned. A successful empty page is also charged. Invalid input and failed requests are not charged. The workspace needs at least 1 credit to start a request.
Authentication
Send your Airscale workspace API key as a Bearer token. Both V1 and V2 workspace API keys are accepted.Request fields
Sendcompany_url as a LinkedIn company URL (linkedin.com/company/...) or a numeric LinkedIn company ID. Optionally set posted_within to 1h, 24h, week, month, 3months, 6months, or year to return only recent posts. Unknown fields are rejected with 400.
The period is applied to each fetched page, so a page can hold fewer than 50 posts. Pagination stops at the first page with no post inside the period.
Rows use the same post fields as Post search. When a row is not a plain post by the company, feed_context holds LinkedIn’s feed label, such as "Example Company collaborated on this"; otherwise it is null.
Rate limit
The limit is 180 requests per minute per workspace for Company posts, including requests made with different API keys for the same workspace. Profile posts, Post search, Profile comments, and Comment likers each have their own separate 180-request allowance. Pagination requests and retries count toward the limit. The counter uses a fixed minute window and resets at the next minute boundary. Requests above the limit receive HTTP429 and are not charged. When LinkedIn content capacity is busy for all workspaces, the response is a free 503 with Retry-After: 5.
Pagination
Omitcursor on the first request. When pagination.next_cursor is not null, send it unchanged together with the same company_url and posted_within to fetch the next page. A cursor sent with different fields, or to another endpoint, returns 400. pagination.total is the number of posts reported by LinkedIn for the company page, or null when unavailable.
Retries
This endpoint does not accept an idempotency key. Retrying a request fetches the page again and is charged again. Retry only responses that were not charged:| Response | Next action |
|---|---|
400 Bad Request | Correct the body or cursor. The message field names the problem. |
403 Forbidden | Add credits to the workspace before retrying. |
413 Payload Too Large | Keep the JSON body under 16 KiB. |
429 Too Many Requests | Wait for the next minute boundary, then retry with bounded exponential backoff. |
502 Bad Gateway or 504 Gateway Timeout | Retry with increasing delays and a fixed retry limit. |
503 Service Unavailable | Wait for Retry-After when present, then retry with bounded backoff. |
Next step
Use Post likers or Post commenters to retrieve enriched people who engaged with one of the returned posts.Authorizations
Use an Airscale workspace API key. Never expose the key in client-side code.
Body
application/json
A LinkedIn company URL or numeric company ID, an optional period, and an optional cursor. The JSON body must not exceed 16 KiB.
LinkedIn company URL (linkedin.com/company/...) or numeric company ID.
Only return posts from this period. The period is applied to each fetched page, so pages can hold fewer than 50 posts, and pagination stops at the first page with no post inside the period.
Available options:
1h, 24h, week, month, 3months, 6months, year, null The opaque pagination.next_cursor from the previous page. Send it unchanged with the same filters as the first page.
Required string length:
1 - 2048