---
ref: tool:heyreagent/search-posts
name: Search posts
company: company:heyreagent
workflows: []
access: [mcp, api]
tags: [capability:track-intent, category:sales-engagement, has:api, has:mcp]
docs: https://heyreagent.com/docs/actions/search_posts
updated: 2026-10-25
---

# Search posts

Returns LinkedIn posts matching keywords, filtered by date, the author's headline, industry or company, or the companies a post mentions.

Note: Company and industry filters take names, and the action uses the top match. datePosted is past_day, past_week or past_month. Up to 50 posts per call; a nextCursor works only on the account that ran the search.

## Set up

Use the first option your agent supports.

### MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

```json
{ "mcpServers": { "heyreagent": { "url": "https://api.heyreagent.com/mcp" } } }
```

Call the MCP tool `search_posts`.

Server URL: https://api.heyreagent.com/mcp

Note: Claude and ChatGPT sign in to HeyReagent in the browser, with no key. Connect the LinkedIn account on heyreagent.com first. Each tool has the same name and inputs as the API action.

### API (official)

- Base URL: https://api.heyreagent.com
- Endpoint: `POST /v1/actions/search_posts`
- Auth: send the header `Authorization: Bearer $HEYREAGENT_API_KEY`
- Get a key: https://heyreagent.com/t
- Docs: https://heyreagent.com/docs

Note: Every action is a POST to /v1/actions/<name> with its inputs as a JSON body, reads included. Create the key under Menu, then Developers; it is shown once. An answer is { ok: true, result } or { ok: false, error, message }.

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.