Get Person Posts

GET

https://data.api.aviato.co/social/person/posts

GET

/social/person/posts

$ curl https://data.api.aviato.co/social/person/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   "hasMoreResults": true,
319   "paginationToken": "paginationToken"
320 }

Get posts from a person’s LinkedIn profile. Must pass either linkedinEntityID or linkedinID.

Authentication

AuthorizationBearer

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

Query parameters

linkedinEntityIDstringOptional

LinkedIn entity ID for the person, this is the preferred and faster identifier for posts.

linkedinIDstringOptional

LinkedIn ID for the person, this is the slower and less preferred identifer for posts.

perPageintegerOptional0-100Defaults to 10

Number of items per page

paginationTokenstringOptional

Token for pagination, required to return results beyond the first page.

Response

This endpoint returns an object.

resultslist of objects

hasMoreResultsboolean

paginationTokenstringOptional

Errors

400

Bad Request Error

401

Unauthorized Error

429

Rate Limit Error