Individual Lookup

Pull one person's recent LinkedIn posts. Synchronous, returns the posts directly.

POST /post

Costs 0.10 credit per post returned, so cost scales with max_record_fetch. A profile with no posts is free. Returns the posts directly in the response, no list and no polling.

Pass a LinkedIn profile URL. The response contains an array of posts in data.posts.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
person_linkedin_url	string	LinkedIn profile URL to pull posts for.
max_record_fetch	integer	Optional. Maximum posts to return. Defaults to 10.
posted_limit	string	Optional. How far back to look, relative to now: any, 1h, 24h, week, month (default), 3months, 6months, year.

Response

The record is under data. See Response Format for the fields every endpoint returns.

Field	Description
person_linkedin_url	The profile the posts belong to.
posts	Array of posts, newest first. Empty when the profile has none.

Each post carries post_url, post_text, post_type, date_posted, num_likes, num_comments and num_shares. Anything the source returns that has no canonical name is kept under extra. The top-level total is the number of posts returned. When no posts are found, status is not_found and data.posts is an empty array.

Example

Input

{
  "api_key": "your_api_key",
  "person_linkedin_url": "https://www.linkedin.com/in/jane-doe-example/",
  "max_record_fetch": 2,
  "posted_limit": "year"
}

Output

{
  "status": "success",
  "data": {
    "person_linkedin_url": "https://www.linkedin.com/in/jane-doe-example/",
    "posts": [
      {
        "post_url": "https://www.linkedin.com/posts/jane-doe-example_activity-7488220267815612416",
        "post_text": "Excited to share that we just closed our Series B...",
        "post_type": "post",
        "date_posted": "2026-07-29",
        "num_likes": 74,
        "num_comments": 3,
        "num_shares": 1,
        "extra": {
          "id": "7488220267815612416",
          "account_type": "profile",
          "author_name": "Jane Doe"
        }
      }
    ]
  },
  "credits_used": 0.1,
  "credits_remaining": 7624.4,
  "total": 1,
  "message": "Saved 1 post(s), charged 0.1 credits",
  "success": true
}

Error

{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "person_linkedin_url: Field required"
  },
  "success": false
}

To pull posts for every contact in a list in one call instead, use List Lookup.