# search_linkedin_posts: Search posts, every filter typed

Search posts on LinkedIn, with each LinkedIn filter as its own typed input. This action only reads; it changes nothing. Plan: Free and Connect.

```
POST https://api.heyreagent.com/v1/actions/search_linkedin_posts
Authorization: Bearer YOUR_KEY
content-type: application/json

{
  "keywords": "outbound sales"
}
```

## What you give it

- `keywords` (optional): text. Words to search for.
- `sortBy` (optional): one of: relevance, date. Order (default relevance).
- `datePosted` (optional): one of: past_day, past_week, past_month. How recent.
- `contentType` (optional): one of: videos, images, live_videos, collaborative_articles, documents, jobs. Only posts with this kind of content.
- `postedBy` (optional): a search filter id. Who posted it: given people, given company pages, you, your 1st-degree connections, or people you follow. Where to get it: `member`: run `lookup_search_ids` with type `PEOPLE` and use `matches[].id`. `company`: run `lookup_search_ids` with type `COMPANY` and use `matches[].id`.
  - `member` (optional): a list (text). People: ids from lookup_search_ids type PEOPLE.
  - `company` (optional): a list (text). Company pages: ids from lookup_search_ids type COMPANY.
  - `me` (optional): true or false. 
  - `firstConnections` (optional): true or false. 
  - `peopleYouFollow` (optional): true or false. 
- `mentioning` (optional): a search filter id. Posts that mention these people or company pages. Where to get it: `member`: run `lookup_search_ids` with type `PEOPLE` and use `matches[].id`. `company`: run `lookup_search_ids` with type `COMPANY` and use `matches[].id`.
  - `member` (optional): a list (text). People: ids from lookup_search_ids type PEOPLE.
  - `company` (optional): a list (text). Company pages: ids from lookup_search_ids type COMPANY.
- `author` (optional): a search filter id. Who the author is: their industry, their company, or words in their headline. Where to get it: `industry`: run `lookup_search_ids` with type `INDUSTRY` and use `matches[].id`. `company`: run `lookup_search_ids` with type `COMPANY` and use `matches[].id`.
  - `industry` (optional): a list (text). Ids from lookup_search_ids type INDUSTRY.
  - `company` (optional): a list (text). Ids from lookup_search_ids type COMPANY.
  - `keywords` (optional): text. Words in the author's headline.
- `limit` (optional): a number, 1 to 49. How many to return (1–49, default 10).
- `cursor` (optional): a cursor. nextCursor from the previous call, to get the next page. Keep the other arguments the same. Where to get it: The `nextCursor` from the last answer of `search_linkedin_posts`.
- `connectionId` (optional): a connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.

## What you get back

- `returned`: number
- `nextCursor`: a cursor
- `results[].type`: POST
- `results[].id`: a post id
- `results[].socialId`: a post social id
- `results[].shareUrl`: a post link
- `results[].title`: string
- `results[].text`: string
- `results[].date`: string
- `results[].parsedDatetime`: string
- `results[].reactionCounter`: number
- `results[].commentCounter`: number
- `results[].repostCounter`: number
- `results[].impressionsCounter`: number
- `results[].userReacted`: LIKE | PRAISE | APPRECIATION | EMPATHY | INTEREST | ENTERTAINMENT
- `results[].isRepost`: boolean
- `results[].repostId`: string
- `results[].repostParsedDatetime`: string

## Good to know

- At most 49 rows per call: LinkedIn's page size for this search.
- LinkedIn returns at most 1,000 rows for one search; narrow the filters to reach the rest.

Page: https://heyreagent.com/docs/actions/search_linkedin_posts