List posts

Returns all LinkedIn posts for a profile with scraped lead counts (reactions, comments, reshares). Supports pagination and filtering by date range. Requires leads scraping to be enabled for the profile.

GET/linkedin/leads/{profileId}/posts

Authorization

AuthorizationBearer token · headerrequired

API key authentication. Generate an API key from your workspace settings.

Path parameters

profileIdstring<uuid>required

LinkedIn profile ID (UUID)

Query parameters

startDatestring<date-time>

Filter posts published on or after this date

endDatestring<date-time>

Filter posts published on or before this date

limitinteger

Maximum number of posts to return (1-100)

min 1 · max 100 · default: 20

cursorstring

Pagination cursor from previous response

Responses

200

List of LinkedIn posts with lead counts

postsLinkedInLeadPost[]

Show properties

Array of LinkedInLeadPost

idstring<uuid>

urlstring<uri>

LinkedIn post URL

commentarystring | null

Post text content

publishedAtstring<date-time> | null

likeCountinteger | null

commentCountinteger | null

shareCountinteger | null

scrapedLeadsCountobject

Show properties

reactionsinteger

commentsinteger

resharesinteger

nextCursorstring | null

Cursor for fetching the next page

hasMoreboolean

Whether more posts are available

401

Unauthorized - Missing or invalid API key

codestring

messagestring

403

Forbidden - Insufficient permissions

codestring

messagestring

404

Not Found - Resource does not exist

codestring

messagestring

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Parameters

profileIdpath*LinkedIn profile ID (UUID)startDatequeryFilter posts published on or after this dateendDatequeryFilter posts published on or before this datelimitqueryMaximum number of posts to return (1-100)cursorqueryPagination cursor from previous response

Request

curl -X GET 'https://app.tryordinal.com/api/v1/linkedin/leads/497f6eca-6276-4993-bfeb-53cbbbba6f08/posts' \
  -H 'Authorization: Bearer YOUR_TOKEN'

const response = await fetch("https://app.tryordinal.com/api/v1/linkedin/leads/497f6eca-6276-4993-bfeb-53cbbbba6f08/posts", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://app.tryordinal.com/api/v1/linkedin/leads/497f6eca-6276-4993-bfeb-53cbbbba6f08/posts",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "posts": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "url": "http://example.com",
      "commentary": "string",
      "publishedAt": "2019-08-24T14:15:22Z",
      "likeCount": 0,
      "commentCount": 0,
      "shareCount": 0,
      "scrapedLeadsCount": {
        "reactions": 0,
        "comments": 0,
        "reshares": 0
      }
    }
  ],
  "nextCursor": "string",
  "hasMore": true
}

{
  "code": "UNAUTHORIZED",
  "message": "Invalid or unauthorized API key"
}

{
  "code": "FORBIDDEN",
  "message": "Engagement profiles cannot be used for analytics"
}

{
  "code": "NOT_FOUND",
  "message": "Post not found or does not belong to this workspace"
}