Skip to main content
POST
/
v1
/
posts
/
search
Search Posts
curl --request POST \
  --url https://api.linkupapi.com/v1/posts/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "post_type": "<string>",
  "sort_by": "<string>",
  "country": "<string>",
  "keyword": "<string>",
  "post_date": "<string>",
  "linkedin_url": "<string>",
  "total_results": 123,
  "start_page": 123,
  "end_page": 123,
  "login_token": "<string>"
}
'
{
  "status": "success",
  "data": {
    "total_results": 1,
    "pagination": {
        "start_page": 1,
        "end_page": 1,
        "results_per_page": 50,
        "pages_fetched": 1
      },
    "posts": [
      {
        "shareAudience": "PUBLIC",
        "shareUrl": "https://www.linkedin.com/posts/user_post-activity-123",
        "text": "Example post content",
        "created_time": "2023-04-01T12:00:00",
        "numLikes": 50,
        "numComments": 10,
        "numShares": 5,
        "actor_name": "John Doe",
        "actor_description": "Software Engineer at Tech Company",
        "actor_image": "https://media.licdn.com/dms/image/profile.jpg",
        "actor_profile_url": "https://www.linkedin.com/in/johndoe",
        "post_images": [
          "https://media.licdn.com/dms/image/post1.jpg"
        ]
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.linkupapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Search and extract LinkedIn posts with advanced filtering options including post type, sorting, keywords, and date filters.
Credit Usage: 1 credit per 10 results (or fraction thereof). For example:
  • 1-10 results = 1 credit
  • 11-20 results = 2 credits
  • 300 results = 30 credits

​
Header Parameters

​
x-api-key
string
required
Your API key

​
Body Parameters

​
post_type
string
Type of posts to search for: “photos” or “jobs” or “videos”
​
sort_by
string
default:"date_posted"
How to sort the results: “date_posted” or “relevance”
​
country
string
default:"FR"
Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)
​
keyword
string
Search keyword for posts
​
post_date
string
Filter posts by date: “past-24h” or “past-week” or “past-month”
​
linkedin_url
string
LinkedIn profile URL to extract posts from
​
total_results
integer
default:"10"
Number of posts to retrieve (used when not in pagination mode)
​
start_page
integer
First page to fetch when using pagination mode (default: 1)
​
end_page
integer
Last page to fetch when using pagination mode (default: same as start_page)
​
login_token
string
required
LinkedIn authentication cookie obtained from the login/verify process

​
Response

​
status
string
Request status (success/error)
​
data
object
{
  "status": "success",
  "data": {
    "total_results": 1,
    "pagination": {
        "start_page": 1,
        "end_page": 1,
        "results_per_page": 50,
        "pages_fetched": 1
      },
    "posts": [
      {
        "shareAudience": "PUBLIC",
        "shareUrl": "https://www.linkedin.com/posts/user_post-activity-123",
        "text": "Example post content",
        "created_time": "2023-04-01T12:00:00",
        "numLikes": 50,
        "numComments": 10,
        "numShares": 5,
        "actor_name": "John Doe",
        "actor_description": "Software Engineer at Tech Company",
        "actor_image": "https://media.licdn.com/dms/image/profile.jpg",
        "actor_profile_url": "https://www.linkedin.com/in/johndoe",
        "post_images": [
          "https://media.licdn.com/dms/image/post1.jpg"
        ]
      }
    ]
  }
}

​
Notes

  • Images URLs are direct links to LinkedIn’s media servers
  • Text content has special characters normalized
  • Social metrics (likes, comments, shares) are included when available
  • Post visibility information is included
  • Results are paginated with a maximum of 50 posts per page
  • Pagination Mode vs. Total Results Mode:
    • Total Results Mode: Use the total_results parameter to specify how many posts you want (default)
    • Pagination Mode: Use start_page and end_page parameters to fetch specific pages of results
    • Credit usage in pagination mode is based on the number of pages fetched (1 credit per page)
    • When using pagination mode, total_results parameter is ignored
  • The API supports:
    • Multiple filtering options
    • Custom sort orders
    • Keyword search
    • Date-based filtering
    • Profile-specific post extraction
  • Post content may be limited based on:
    • Privacy settings
    • Network connection level
    • Content visibility settings