Sign in

v1

latestOpenAPI 3.0.02026-07-1390307.4 KB
Contact Research

Research contacts

Research contacts by searchResultId from contact search results or Contact enrich

post/contacts/research

Request body

searchResultIdsstring[]

Array of search result IDs obtained from a prior /search/contacts call. Each ID triggers a contact research request that consumes one credit. Mutually exclusive with the contacts property.

isJobChangeboolean

When set to true, triggers a job change research for the provided contacts. Must be used together with the contacts array; cannot be used with searchResultIds.

skipDeduplicationCheckboolean

When true, research will not check for duplicate records that you already researched recently, and perform a research (which can result in credit usage)

Example request

{
  "searchResultIds": [
    "11ad7a1c-9a63-30e0-a1de-cd9a766805ca",
    "22bd8b2d-0b74-41f1-b2ef-de0ab877916db"
  ],
  "contacts": [
    {
      "contactName": "John Doe",
      "companyName": "Acme Corp",
      "title": "Software Engineer",
      "domain": "acme.com",
      "email": "john.doe@acme.com",
      "liProfileUrl": "https://www.linkedin.com/in/johndoe",
      "liSalesNavUrl": "https://www.linkedin.com/sales/lead/ACoAAA...",
      "liRecruiterUrl": "https://www.linkedin.com/talent/search/profile/AEMAA..."
    }
  ]
}

Response

The request IDs for research

successboolean

Indicates whether the research request was accepted successfully.

requestIdsstring[]

Array of request IDs corresponding to each contact research request. Use these IDs to poll for results via /contacts/research/poll.

Example response

{
  "success": true,
  "requestIds": [
    "6Ei5iKuSHzJXvqjVPWiZ_"
  ]
}