> ## Documentation Index
> Fetch the complete documentation index at: https://docs.theswarm.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Company Posts
> Pulls posts from a company's social media accounts. Returns the latest 10 posts by default — use the perPage parameter to request up to 100. The response includes a postUrn for each post, which is used as the input for the Get Comments, Get Reactions, and Get Reshares endpoints.
This endpoint is in beta. Please report any issues to [support@theswarm.com](mailto:support@theswarm.com)
## Endpoint
```text theme={null}
GET https://bee.theswarm.com/social/company/posts
```
## Parameters
Choose one:
| Parameter | Type | Required | Description |
| :------------- | :------ | :------- | :------------------------------------------------------------- |
| `linkedinName` | string | One of | LinkedIn company URL slugs |
| `linkedinId` | string | One of | LinkedIn numeric company ID |
| `perPage` | integer | No | Number of posts to return. Defaults to `10`. Maximum is `100`. |
| `page` | integer | No | |
## Request Example
```text theme={null}
GET https://bee.theswarm.com/social/company/posts?linkedinName=wearetheswarm
```
```text theme={null}
# Request up to 100 posts
GET https://bee.theswarm.com/social/company/posts?linkedinName=wearetheswarm&perPage=100
```
```text GET theme={null}
https://bee.theswarm.com/social/company/posts?linkedinName=wearetheswarm
```
```json Get Posts theme={null}
{
"posts": [
{
"urn": "urn:li:activity:7452038923167625216",
"actor": {
"linkedin_url": "https://www.linkedin.com/company/elg-insider",
"name": "ELG Insider",
"entity_type": "company",
"image": "https://media.licdn.com/dms/image/v2/D4E0BAQEgp770eYWqpg/company-logo_400_400/company-logo_400_400/0/1726836604740/elg_insider_logo?e=1778716800&v=beta&t=wWp_QkUykY87cOhMePoRFA7uZqgbEXzbFXv6B22Fdi8",
"linkedin_id": "elg-insider"
},
"post_range": {
"earliest": "2026-04-14T13:24:33.243Z",
"latest": "2026-04-21T13:24:33.242Z"
},
"post_age": "1 week ago",
"social_activity_counts": {
"comments_count": 1,
"shares_count": 1,
"reactions_count": 3,
"reaction_type_counts": [
{
"count": 1,
"reaction_type": "PRAISE"
},
{
"count": 1,
"reaction_type": "LIKE"
},
{
"count": 1,
"reaction_type": "INTEREST"
}
]
},
"images": [
"https://media.licdn.com/dms/image/v2/D4E22AQFp8M48vq-_ig/feedshare-shrink_1280/B4EZ2rjH9BJEAQ-/0/1776699605094?e=1778716800&v=beta&t=nplkWOf7HMzuVre963tL7f8BPys6K7aLqER3jh3CXVc"
],
"url": "https://www.linkedin.com/posts/elg-insider_most-gtm-teams-are-still-operating-on-sales-activity-7452023305273999361-vzaK?utm_source=social_share_send&utm_medium=member_desktop_web&rcm=ACoAAGCS_cUBfaU1vrehfDQoB5pmxCJXJ7QU_Y8",
"video": {
"url": "",
"thumbnail": ""
},
"reshared_post": null,
"commentary": "Most GTM teams are still operating on sales data 1.0.\n\nName. Title. Company. Email. Phone.\n\nIntent data helped close part of the gap, but there’s still a critical layer missing: relationship data.\n\nWho in your network already knows this prospect?\nWho can make the warm intro?\nWho has the credibility to turn a cold account into an open door?\n\nDavid Connors, Co-Founder and CEO at The Swarm 🔆, calls this sales data 2.0 — and it’s quietly reshaping how the best revenue teams prospect, prioritize, and close.\n\nThe modern GTM playbook looks less like “emails sent” and more like:\n\n→ Executives as first-touch points via introductions and referrals\n→ Hyper-targeted prospecting based on fit, intent, and relationships\n→ Partner ecosystems driving influence at the account level\n→ New KPIs: intros made, referred customers, shared commissions\n\nSound familiar? It should.\n\nThis is exactly what Ecosystem-Led Growth is built for. Your partner network is relationship data at scale and teams using Crossbeam to surface warm paths into accounts are already operating on this 2.0 playbook.\n\nThe question isn’t whether relationships matter.\nIt’s whether you have a system to activate them.\n\nThanks for sharing this perspective, David. Follow him for more insights on relationship intelligence and the future of GTM.",
"header": "The Swarm 🔆 reposted this",
"header_entity": {
"entity_type": "company",
"image": "https://media.licdn.com/dms/image/v2/C560BAQFBgx84WuOyHQ/company-logo_400_400/company-logo_400_400/0/1669856178475/wearetheswarm_logo?e=1778716800&v=beta&t=EU6tRPl0HrDEMd7Uy5Wvedmmj4FIeimzeL3paRHl_J8",
"linkedin_url": "https://www.linkedin.com/company/wearetheswarm/",
"linkedin_id": "wearetheswarm",
"name": "The Swarm 🔆"
}
}
],
"page": 1,
"pages": 6,
"totalResults": 57
}
```
## OpenAPI
````yaml openapi.json GET /social/company/posts
openapi: 3.1.0
info:
title: Swarm API
version: 1.0.0
contact:
name: The Swarm
url: https://theswarm.com
email: hello@theswarm.com
servers:
- url: https://bee.theswarm.com
security:
- ApiKeyAuth: []
tags:
- name: profiles
description: Operations related to profiles
- name: companies
description: Operations related to companies
- name: teams
description: Operations for managing teams and connectors
- name: social
description: Operations related to social media posts and interactions
- name: mcp
description: Model Context Protocol endpoint for AI assistant integrations
- name: credits
description: Operations related to credit usage
- name: network-mapper
description: Operations for mapping connections and relationships across your network
paths:
/social/company/posts:
get:
tags:
- social
summary: Get company posts
description: Fetch LinkedIn posts published by a company
operationId: getCompanyPosts
parameters:
- name: linkedinID
in: query
description: LinkedIn company URL slug
schema:
type: string
- name: linkedinName
in: query
description: LinkedIn company URL slug
schema:
type: string
- name: perPage
in: query
description: Number of posts per page
schema:
type: integer
- name: page
in: query
description: Page number (1-based)
schema:
type: integer
responses:
'200':
description: List of company posts
content:
application/json:
schema:
type: object
properties:
posts:
type: array
items:
$ref: '#/components/schemas/SocialPost'
page:
type: integer
pages:
type: integer
totalResults:
type: integer
required:
- posts
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
5XX:
$ref: '#/components/responses/5XX'
security:
- ApiKeyAuth: []
components:
schemas:
SocialPost:
type: object
properties:
urn:
type: string
description: LinkedIn post URN
actor:
$ref: '#/components/schemas/SocialActor'
post_range:
$ref: '#/components/schemas/SocialPostRange'
post_age:
type: string
social_activity_counts:
$ref: '#/components/schemas/SocialActivityCounts'
images:
type: array
items:
type: string
url:
type: string
video:
$ref: '#/components/schemas/SocialVideo'
reshared_post:
$ref: '#/components/schemas/SocialPost'
commentary:
type: string
header:
type: string
header_entity:
$ref: '#/components/schemas/SocialHeaderEntity'
SocialActor:
type: object
properties:
entity_type:
type: string
image:
type: string
linkedin_url:
type: string
linkedin_id:
type: string
name:
type: string
SocialPostRange:
type: object
properties:
earliest:
type: string
latest:
type: string
SocialActivityCounts:
type: object
properties:
comments_count:
type: integer
shares_count:
type: integer
reactions_count:
type: integer
reaction_type_counts:
type: array
items:
$ref: '#/components/schemas/SocialReactionTypeCount'
SocialVideo:
type: object
properties:
url:
type: string
thumbnail:
type: string
SocialHeaderEntity:
type: object
properties:
entity_type:
type: string
image:
type: string
linkedin_url:
type: string
linkedin_id:
type: string
name:
type: string
ErrorResponse:
type: object
properties:
code:
description: Error status code
type: integer
errors:
type: array
items:
type:
- string
- object
required:
- code
SocialReactionTypeCount:
type: object
properties:
count:
type: integer
reaction_type:
type: string
responses:
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
'403':
description: Forbidden
5XX:
description: Unexpected error
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
````