For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DashboardDocumentationPlaygroundSign Out
  • Intro
    • Introduction & Auth
    • Data Overview
  • API Reference
      • GETGet Company Posts
      • GETGet Person Posts
      • GETGet Post Reactions
      • GETGet Post Reshares
      • GETGet Post Comments
  • Aviato DSL
    • Aviato DSL V1
    • DSL Query Schemas
Logo
DashboardDocumentationPlaygroundSign Out
API ReferenceSocial

Get Company Posts

GET
https://data.api.aviato.co/social/company/posts
GET
/social/company/posts
$curl https://data.api.aviato.co/social/company/posts \
>     -H "Authorization: Bearer <token>"
1{
2  "results": [
3    {
4      "urn": "urn",
5      "actor": {
6        "linkedinURL": "linkedinURL",
7        "name": "name",
8        "entityType": "entityType",
9        "image": "image",
10        "linkedinID": "linkedinID"
11      },
12      "postRange": {
13        "earliest": "2024-01-15T09:30:00Z",
14        "latest": "2024-01-15T09:30:00Z"
15      },
16      "postAge": "postAge",
17      "socialActivityCounts": {
18        "commentsCount": 1,
19        "sharesCount": 1,
20        "reactionsCount": 1,
21        "reactionTypeCounts": [
22          {
23            "count": 1,
24            "reactionType": "reactionType"
25          },
26          {
27            "count": 1,
28            "reactionType": "reactionType"
29          }
30        ]
31      },
32      "images": [
33        "images",
34        "images"
35      ],
36      "url": "url",
37      "video": {
38        "url": "url",
39        "thumbnail": "thumbnail"
40      },
41      "resharedPost": {
42        "urn": "urn",
43        "actor": {
44          "linkedinURL": "linkedinURL",
45          "name": "name",
46          "entityType": "entityType",
47          "image": "image",
48          "linkedinID": "linkedinID"
49        },
50        "postRange": {
51          "earliest": "2024-01-15T09:30:00Z",
52          "latest": "2024-01-15T09:30:00Z"
53        },
54        "postAge": "postAge",
55        "socialActivityCounts": {
56          "commentsCount": 1,
57          "sharesCount": 1,
58          "reactionsCount": 1,
59          "reactionTypeCounts": [
60            {
61              "count": 1,
62              "reactionType": "reactionType"
63            },
64            {
65              "count": 1,
66              "reactionType": "reactionType"
67            }
68          ]
69        },
70        "images": [
71          "images",
72          "images"
73        ],
74        "url": "url",
75        "video": {
76          "url": "url",
77          "thumbnail": "thumbnail"
78        },
79        "resharedPost": {
80          "urn": "urn",
81          "actor": {
82            "linkedinURL": "linkedinURL",
83            "name": "name",
84            "entityType": "entityType",
85            "image": "image",
86            "linkedinID": "linkedinID"
87          },
88          "postRange": {
89            "earliest": "2024-01-15T09:30:00Z",
90            "latest": "2024-01-15T09:30:00Z"
91          },
92          "postAge": "postAge",
93          "socialActivityCounts": {
94            "commentsCount": 1,
95            "sharesCount": 1,
96            "reactionsCount": 1,
97            "reactionTypeCounts": []
98          },
99          "images": [
100            "images",
101            "images"
102          ],
103          "url": "url",
104          "video": {
105            "url": "url",
106            "thumbnail": "thumbnail"
107          },
108          "resharedPost": {
109            "urn": "urn",
110            "actor": {
111              "linkedinURL": "linkedinURL",
112              "name": "name",
113              "entityType": "entityType"
114            },
115            "postRange": {
116              "earliest": "2024-01-15T09:30:00Z",
117              "latest": "2024-01-15T09:30:00Z"
118            },
119            "postAge": "postAge",
120            "socialActivityCounts": {},
121            "images": [
122              "images",
123              "images"
124            ],
125            "url": "url",
126            "video": {},
127            "commentary": "commentary",
128            "header": "header"
129          },
130          "commentary": "commentary",
131          "header": "header",
132          "headerEntity": {
133            "entityType": "entityType",
134            "image": "image",
135            "linkedinURL": "linkedinURL",
136            "linkedinID": "linkedinID",
137            "name": "name"
138          }
139        },
140        "commentary": "commentary",
141        "header": "header",
142        "headerEntity": {
143          "entityType": "entityType",
144          "image": "image",
145          "linkedinURL": "linkedinURL",
146          "linkedinID": "linkedinID",
147          "name": "name"
148        }
149      },
150      "commentary": "commentary",
151      "header": "header",
152      "headerEntity": {
153        "entityType": "entityType",
154        "image": "image",
155        "linkedinURL": "linkedinURL",
156        "linkedinID": "linkedinID",
157        "name": "name"
158      }
159    },
160    {
161      "urn": "urn",
162      "actor": {
163        "linkedinURL": "linkedinURL",
164        "name": "name",
165        "entityType": "entityType",
166        "image": "image",
167        "linkedinID": "linkedinID"
168      },
169      "postRange": {
170        "earliest": "2024-01-15T09:30:00Z",
171        "latest": "2024-01-15T09:30:00Z"
172      },
173      "postAge": "postAge",
174      "socialActivityCounts": {
175        "commentsCount": 1,
176        "sharesCount": 1,
177        "reactionsCount": 1,
178        "reactionTypeCounts": [
179          {
180            "count": 1,
181            "reactionType": "reactionType"
182          },
183          {
184            "count": 1,
185            "reactionType": "reactionType"
186          }
187        ]
188      },
189      "images": [
190        "images",
191        "images"
192      ],
193      "url": "url",
194      "video": {
195        "url": "url",
196        "thumbnail": "thumbnail"
197      },
198      "resharedPost": {
199        "urn": "urn",
200        "actor": {
201          "linkedinURL": "linkedinURL",
202          "name": "name",
203          "entityType": "entityType",
204          "image": "image",
205          "linkedinID": "linkedinID"
206        },
207        "postRange": {
208          "earliest": "2024-01-15T09:30:00Z",
209          "latest": "2024-01-15T09:30:00Z"
210        },
211        "postAge": "postAge",
212        "socialActivityCounts": {
213          "commentsCount": 1,
214          "sharesCount": 1,
215          "reactionsCount": 1,
216          "reactionTypeCounts": [
217            {
218              "count": 1,
219              "reactionType": "reactionType"
220            },
221            {
222              "count": 1,
223              "reactionType": "reactionType"
224            }
225          ]
226        },
227        "images": [
228          "images",
229          "images"
230        ],
231        "url": "url",
232        "video": {
233          "url": "url",
234          "thumbnail": "thumbnail"
235        },
236        "resharedPost": {
237          "urn": "urn",
238          "actor": {
239            "linkedinURL": "linkedinURL",
240            "name": "name",
241            "entityType": "entityType",
242            "image": "image",
243            "linkedinID": "linkedinID"
244          },
245          "postRange": {
246            "earliest": "2024-01-15T09:30:00Z",
247            "latest": "2024-01-15T09:30:00Z"
248          },
249          "postAge": "postAge",
250          "socialActivityCounts": {
251            "commentsCount": 1,
252            "sharesCount": 1,
253            "reactionsCount": 1,
254            "reactionTypeCounts": []
255          },
256          "images": [
257            "images",
258            "images"
259          ],
260          "url": "url",
261          "video": {
262            "url": "url",
263            "thumbnail": "thumbnail"
264          },
265          "resharedPost": {
266            "urn": "urn",
267            "actor": {
268              "linkedinURL": "linkedinURL",
269              "name": "name",
270              "entityType": "entityType"
271            },
272            "postRange": {
273              "earliest": "2024-01-15T09:30:00Z",
274              "latest": "2024-01-15T09:30:00Z"
275            },
276            "postAge": "postAge",
277            "socialActivityCounts": {},
278            "images": [
279              "images",
280              "images"
281            ],
282            "url": "url",
283            "video": {},
284            "commentary": "commentary",
285            "header": "header"
286          },
287          "commentary": "commentary",
288          "header": "header",
289          "headerEntity": {
290            "entityType": "entityType",
291            "image": "image",
292            "linkedinURL": "linkedinURL",
293            "linkedinID": "linkedinID",
294            "name": "name"
295          }
296        },
297        "commentary": "commentary",
298        "header": "header",
299        "headerEntity": {
300          "entityType": "entityType",
301          "image": "image",
302          "linkedinURL": "linkedinURL",
303          "linkedinID": "linkedinID",
304          "name": "name"
305        }
306      },
307      "commentary": "commentary",
308      "header": "header",
309      "headerEntity": {
310        "entityType": "entityType",
311        "image": "image",
312        "linkedinURL": "linkedinURL",
313        "linkedinID": "linkedinID",
314        "name": "name"
315      }
316    }
317  ],
318  "page": 1,
319  "pages": 1,
320  "totalResults": 1
321}

Get posts from a company’s LinkedIn page. Must pass either linkedinNumID or linkedinID.

Was this page helpful?
Previous

Get Person Posts

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

linkedinNumIDstringOptional

LinkedIn numeric company ID (e.g. “35625249”). This is the preferred and faster identifier.

linkedinIDstringOptional

LinkedIn vanity ID (e.g. “google”). This is the slower and less preferred identifer for posts.

pageintegerOptional>=1Defaults to 1

Page number (1-indexed)

perPageintegerOptional0-100Defaults to 10
Number of items per page

Response

This endpoint returns an object.
resultslist of objects
pageinteger
pagesinteger
totalResultsinteger

Errors

400
Bad Request Error
401
Unauthorized Error
429
Rate Limit Error