POST
/
v1
/
posts
/
search
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"
        ]
      }
    ]
  }
}

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)

​
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