Skip to main content
GET
/
linkedin
/
post-search
Search LinkedIn posts
curl --request GET \
  --url https://api.harvest-api.com/linkedin/post-search \
  --header 'X-API-Key: <api-key>'
{
  "elements": [
    {
      "id": "<string>",
      "content": "<string>",
      "linkedinUrl": "<string>",
      "author": {
        "id": "<string>",
        "urn": "<string>",
        "publicIdentifier": "<string>",
        "universalName": "<string>",
        "name": "<string>",
        "linkedinUrl": "<string>",
        "type": true,
        "info": true,
        "website": true,
        "websiteLabel": true,
        "avatar": {
          "url": "<string>",
          "width": 123,
          "height": 123,
          "expiresAt": 123
        }
      },
      "postedAt": {
        "timestamp": 123,
        "date": "<string>",
        "postedAgoShort": "<string>",
        "postedAgoText": "<string>"
      },
      "postImages": [
        {
          "url": "<string>",
          "width": 123,
          "height": 123,
          "expiresAt": 123
        }
      ],
      "postVideo": {
        "thumbnailUrl": "<string>",
        "videoUrl": "<string>"
      },
      "article": {
        "title": "<string>",
        "subtitle": "<string>",
        "link": "<string>",
        "linkLabel": "<string>",
        "description": "<string>",
        "image": {
          "url": "<string>",
          "width": 123,
          "height": 123,
          "expiresAt": 123
        }
      },
      "repostId": "<string>",
      "repost": {},
      "repostedBy": {
        "publicIdentifier": "<string>",
        "name": "<string>",
        "linkedinUrl": "<string>"
      },
      "newsletterUrl": "<string>",
      "newsletterTitle": "<string>",
      "socialContent": {
        "hideCommentsCount": true,
        "hideReactionsCount": true,
        "hideSocialActivityCounts": true,
        "hideShareAction": true,
        "hideSendAction": true,
        "hideRepostsCount": true,
        "hideViewsCount": true,
        "hideReactAction": true,
        "hideCommentAction": true,
        "shareUrl": "<string>",
        "showContributionExperience": true,
        "showSocialDetail": true
      },
      "engagement": {
        "likes": 123,
        "comments": 123,
        "shares": 123,
        "reactions": [
          {
            "type": "<string>",
            "count": 123
          }
        ]
      }
    }
  ],
  "pagination": {
    "totalPages": 123,
    "totalElements": 123,
    "pageNumber": 123,
    "previousElements": 123,
    "pageSize": 123,
    "paginationToken": "<string>"
  },
  "status": "<string>",
  "error": "<string>",
  "query": {
    "search": "<string>",
    "profileId": "<string>",
    "companyId": "<string>",
    "postedLimit": "<string>",
    "sortBy": "<string>",
    "page": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.harvest-api.com/llms.txt

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

const params = new URLSearchParams({
  profile: 'https://www.linkedin.com/in/williamhgates',
  // profileId: 'ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc', // Or Bill Gates profile ID (faster response)
  postedLimit: 'month',
  sortBy: 'date',
  page: '1',
});

const firstPage = await fetch(
  `https://api.harvest-api.com/linkedin/post-search?${params.toString()}`,
  {
    headers: { 'X-API-Key': '<api-key>' },
  },
).then((response) => response.json());

params.set('page', '2');
// paginationToken is required if it was returned by the API. (LinkedIn requires it in some cases, otherwise it returns page 1 again)
params.set('paginationToken', firstPage.pagination.paginationToken);

const secondPage = await fetch(
  `https://api.harvest-api.com/linkedin/post-search?${params.toString()}`,
  {
    headers: { 'X-API-Key': '<api-key>' },
  },
).then((response) => response.json());

​
How to get Profile ID

const params = new URLSearchParams({
  url: 'https://www.linkedin.com/in/williamhgates',
  apiKey: '<api-key>',
});

fetch(`https://api.harvest-api.com/linkedin/profile?${params.toString()}`)
  .then((res) => res.json())
  .then((data) => {
    console.log(`Bill Gates profile ID: ${data.id}`);
  });

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
search
string

Keywords to search for in posts

​
profile
string

Filter posts by author's profile URL (comma-separated). Note: LinkedIn returns fewer results per profile when using post search. To extract all posts by a profile, use the /linkedin/profile-posts endpoint

​
profileId
string

Filter posts by author's profile ID or IDs (comma-separated). It's faster to search by ID. Note: LinkedIn returns fewer results per profile when using post search. To extract all posts by a profile, use the /linkedin/profile-posts endpoint

​
company
string

Filter posts by this company URL or URLs (comma-separated). Note: LinkedIn returns fewer results per company when using post search. To extract all posts by a company, use the /linkedin/company-posts endpoint

​
companyId
string

Filter posts by company ID or IDs (comma-separated). It's faster to search by ID. Note: LinkedIn returns fewer results per company when using post search. To extract all posts by a company, use the /linkedin/company-posts endpoint

​
authorsCompany
string

List of LinkedIn companies where authors of posts work (comma-separated). It supports company URLs and IDs.

​
authorsIndustryId
string

List of LinkedIn industry IDs of authors' companies (comma-separated). It supports industry IDs. Full list of industry IDs: https://github.com/HarvestAPI/linkedin-industry-codes-v2/blob/main/linkedin_industry_code_v2_all_eng.csv

​
mentioningMember
string

Filter posts mentioning this LinkedIn profile URL or ID (comma-separated). It supports profile URLs and IDs.

​
mentioningCompany
string

Filter posts mentioning this LinkedIn company URL or ID (comma-separated). It supports company URLs and IDs.

​
contentType
string

Filter by content type. Supported values: 'videos', 'images', 'live_videos', 'documents', 'collaborative_articles', 'jobs'

​
authorKeywords
string

Filter by keywords in authors' profiles

​
group
string

Group LinkedIn URL or Group ID

​
postedLimit
string

Filter posts by maximum posted date. Supported values: '24h', 'week', 'month'. This parameter will be sent to LinkedIn, the filtering will be done on their side

​
scrapePostedLimit
string

Post-Filter posts by maximum posted date. Supported values: '1h', '24h', 'week','month', '3months', '6months', 'year'. This parameter will be applied after receiving results from LinkedIn, the filtering will be done on our side

​
sortBy
string

Sort by field. Supported values: 'relevance', 'date'

​
page
integer
default:1

Page number for pagination

​
paginationToken
string<nullable>

Required if it was returned by the previous page. Otherwise the page will always be 1 (on LinkedIn side). Doesn't apply for all queries, usually profile posts return this token

Response

Post search response

​
elements
object[]
​
pagination
object
​
status
string
​
error
string
​
query
object