LinkedIn Posts

Search LinkedIn posts and articles by keyword. Returns post content, author, publication date, engagement metrics (likes, comments, shares, reactions), and attached content (images, articles, videos, job listings) for each result.

Endpoint

GET /v1/linkedin/posts

Price: $0.006 per request Free tier: 50 requests/month

Parameters

Parameter	Required	Description
`query`	Yes	Search keyword (max 500 characters)
`page`	No	Page number for pagination (default: 1)
`sort_by`	No	Sort order: `most_recent` or `relevance` (default: `most_recent`)
`get_sentiment`	No	Set to `true` to add AI emotion analysis (Plutchik’s Wheel) to each result. Adds +$0.001 per request to the cost. Returns emotion scores, dominant emotion, intensity, and polarity.

Response Fields

Field	Type	Description
`posts`	array	Array of matching posts
`posts[].title`	string	Post title (format: `@author on LinkedIn`)
`posts[].url`	string	Direct link to the post
`posts[].date`	string	Publication date and time
`posts[].author`	string	Author name
`posts[].source`	string	`"LinkedIn"`
`posts[].domain`	string	`"linkedin.com"`
`posts[].snippet`	string	Post content text
`posts[].urn`	string	LinkedIn post URN identifier
`posts[].likes`	integer	Number of likes
`posts[].comments`	integer	Number of comments
`posts[].shares`	integer	Number of shares
`posts[].reactions`	object	Reaction type breakdown (e.g. `{"like": 2, "appreciation": 1}`)
`posts[].images`	array	Image URLs attached to the post
`posts[].article`	object/null	Shared article with `title`, `subtitle`, `url`, `description`
`posts[].video`	object/null	Video content with `thumbnail` and `duration` (ms)
`posts[].job`	object/null	Job listing with `title`, `subtitle`, `url`, `description`
`posts[].has_content_entities`	boolean	`true` if the post has attached content (image, article, video, or job). Posts with `has_content_entities: false` may be reposts — use the Post Details endpoint to check.
`posts[].sentiment`	object/null	Emotion analysis results. Only present when `get_sentiment=true`. Returns `null` if analysis fails.
`posts[].sentiment.emotions`	object	Plutchik emotion scores (0-100) for: `joy`, `trust`, `fear`, `surprise`, `sadness`, `disgust`, `anger`, `anticipation`.
`posts[].sentiment.dominant_emotion`	string	The emotion with the highest score.
`posts[].sentiment.emotional_intensity`	integer	Overall emotional intensity on a scale of 0-10.
`posts[].sentiment.polarity`	string	Overall sentiment polarity: `positive`, `negative`, or `neutral`.
`page`	integer	Current page number
`count`	integer	Number of results returned

Example Request

cURL

curl "https://apidirect.io/v1/linkedin/posts?query=artificial%20intelligence&page=1&sort_by=most_recent" \
  -H "X-API-Key: YOUR_API_KEY"

Python

import requests

response = requests.get(
    "https://apidirect.io/v1/linkedin/posts",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "query": "artificial intelligence",
        "page": 1,
        "sort_by": "most_recent"
    }
)
print(response.json())

Example Response

{
  "posts": [
    {
      "title": "@John Doe on LinkedIn",
      "url": "https://linkedin.com/posts/...",
      "date": "2024-01-15 14:30:00",
      "author": "John Doe",
      "source": "LinkedIn",
      "domain": "linkedin.com",
      "snippet": "Exciting developments in artificial intelligence...",
      "urn": "urn:li:activity:7444854690124652545",
      "likes": 12,
      "comments": 3,
      "shares": 1,
      "reactions": {
        "like": 10,
        "appreciation": 2
      },
      "images": [
        "https://media.licdn.com/dms/image/..."
      ],
      "article": null,
      "video": null,
      "job": null,
      "has_content_entities": true,
      "sentiment": {
        "emotions": {
          "joy": 40,
          "trust": 55,
          "fear": 0,
          "surprise": 10,
          "sadness": 0,
          "disgust": 0,
          "anger": 0,
          "anticipation": 30
        },
        "dominant_emotion": "trust",
        "emotional_intensity": 5,
        "polarity": "positive"
      }
    }
  ],
  "page": 1,
  "count": 10
}