MyAgentMail
Get started
All endpoints
LinkedIn — Searches

Run a historical search

POSThttps://myagentmail.com/linkedin/searches

Synchronous keyword search across the past 24 hours, week, or month. Returns the full hit list inline. Use this for one-shot lookups; for continuous monitoring use POST /v1/linkedin/signals.

Request body

Content-Type: application/json

sessionId
string

Omit or send null to auto-distribute. Pass a session id to pin.

query
required
string
lookback
"past-24h" | "past-week" | "past-month"

enum: "past-24h" | "past-week" | "past-month"

default: "past-week"

minIntent
"low" | "medium" | "high"

Filter results below this intent level. Omit for unfiltered.

enum: "low" | "medium" | "high"

intentDescription
required
string

Plain-English firing rule the LLM classifier treats as the authoritative definition of what should fire (same semantics as on signals). The keyword is a coarse pre-filter; this rule decides engage and the cited reason on every result.

limit
integer

default: 50

Responses

200application/jsonSearch ran successfully. results may be empty.
search
object
id
required
string
sessionId
string

The LinkedIn session that actually ran the search (the router's pick when the caller didn't pin).

query
required
string
lookback
required
"past-24h" | "past-week" | "past-month"

enum: "past-24h" | "past-week" | "past-month"

minIntent
"low" | "medium" | "high"

enum: "low" | "medium" | "high"

intentDescription
required
string

Plain-English firing rule used by the classifier (same semantics as on signals).

resultCount
required
integer
tookMs
integer
errorCode
string

Set on partial failure (e.g. LINKEDIN_RATE_LIMITED). Search row is still persisted.

errorMessage
string
createdAt
required
string

format: date-time

results
object[]
postUrl
string
postExcerpt
string
postedAt
string

format: date-time

author
object
name
string
profileUrl
string
headline
string
role
string
company
string
classification
object
engage
boolean
intent
"low" | "medium" | "high"

enum: "low" | "medium" | "high"

reason
string
triageScore
integer
rank
integer

Original position in LinkedIn's ranked result list (0 = top).

404LinkedIn session not found or inactive.
429LinkedIn rate-limited this session. The search row is persisted with errorCode=LINKEDIN_RATE_LIMITED.
502LinkedIn returned an unexpected error. The search row is persisted with the error captured.

Authentication

Send your API key in the X-API-Key header (or Authorization: Bearer <key>). Any prefix accepted by this endpoint — tk_, wk_, ak_, or sa_ — is documented in the key prefix table.