Fetch a past search + its results

GEThttps://myagentmail.com/linkedin/searches/{id}

Re-open a persisted search without spending another LinkedIn quota.

Path parameters

id

required

string

Responses

200application/json

`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).

404Not found.

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.

Request

import { MyAgentMail } from "myagentmail";

const client = new MyAgentMail({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// GET /linkedin/searches/{id}
const result = await client.request("get", "/linkedin/searches/{id}", { params: { id: "string" } });

Example response · 200

{
  "search": {
    "id": "string",
    "sessionId": "string",
    "query": "string",
    "lookback": "past-24h",
    "minIntent": "low",
    "intentDescription": "string",
    "resultCount": 0,
    "tookMs": 0,
    "errorCode": "string",
    "errorMessage": "string",
    "createdAt": "2026-07-17T14:07:30.561Z"
  },
  "results": [
    {
      "postUrl": "string",
      "postExcerpt": "string",
      "postedAt": "2026-07-17T14:07:30.561Z",
      "author": {
        "name": "string",
        "profileUrl": "string",
        "headline": "string",
        "role": "string",
        "company": "string"
      },
      "classification": {
        "engage": false,
        "intent": "low",
        "reason": "string"
      },
      "triageScore": 0,
      "rank": 0
    }
  ]
}