integrations

Search LinkedIn messages in a case

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}
Close
GET /linkedin/{caseId}/search-messages
Access token

Searches message text and subjects across every LinkedIn conversation in the case and returns one page of matches, newest first, each with its conversation title and participant names; optionally limit to conversations carrying all of the given tags. On a case shared with opposing counsel, messages from profiles the caller may not see are excluded.

Path parameters

  • caseId string Required

Query parameters

  • page number

    Default value is 1.

  • perPage number

    Default value is 10.

  • skip number

    If skip/limit not provided, page/perPage will take precedence

  • limit number

    If skip/limit not provided, page/perPage will take precedence

  • sortOrder string

    Values are asc or desc. Default value is asc.

  • searchText string Required

    Search text for message content and subject

  • tags array[string]

    Filter by conversation tag IDs (comma-separated)

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • total number Required
      • page number
      • perPage number
      • skip number
      • limit number
      • totalPages number Required
      • nextPage number | null Required
      • previousPage number | null Required
      • data array[object]
        Hide data attributes Show data attributes object
        • id string Required
        • from string Required
        • to string Required
        • date string(date-time) Required
        • content string Required
        • folder string | null Required
        • isDraft boolean Required
        • attachments string Required
        • conversationId string Required
        • conversationTitle string | null Required
        • participants array[string] Required
        • profileId string Required
    • statusCode number Required
    • timestamp string(date-time) Required
GET /linkedin/{caseId}/search-messages 
curl \
 --request GET 'http://api.example.com/linkedin/{caseId}/search-messages?searchText=string' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "data": {
    "total": 42,
    "page": 1,
    "perPage": 20,
    "skip": 0,
    "limit": 20,
    "totalPages": 3,
    "nextPage": 2,
    "previousPage": 42.0,
    "data": [
      {
        "id": "507f1f77bcf86cd799439011",
        "from": "Jane Doe",
        "to": "John Smith",
        "date": "2026-01-15T14:30:00.000Z",
        "content": "Thanks for connecting. Are you free for a call next week?",
        "folder": "INBOX",
        "isDraft": false,
        "attachments": "string",
        "conversationId": "65a1b2c3d4e5f6a7b8c9d0e2",
        "conversationTitle": "Project update",
        "participants": [
          "Jane Doe",
          "John Smith"
        ],
        "profileId": "65a1b2c3d4e5f6a7b8c9d0e3"
      }
    ]
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}