Research contacts
Research contacts by searchResultId from contact search results or Contact enrich
curl --request POST \
--url https://api.seamless.ai/api/client/v1/contacts/research \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"searchResultIds": [
"searchResultId1",
"searchResultId2"
]
}
'{
"success": true,
"requestIds": [
"6Ei5iKuSHzJXvqjVPWiZ_"
]
}{
"message": "<string>"
}{
"msg": "<string>",
"code": "<string>",
"data": {
"productCategory": "<string>",
"additionalCreditsNeeded": 123
}
}{
"message": "<string>"
}Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
- Authorization URL
- https://login.seamless.ai/oauth/authorize
- Token URL
- https://api.seamless.ai/api/client/v1/oauth/accessToken
Body
Array of search result IDs obtained from a prior /search/contacts call. Each ID triggers a contact research request that consumes one credit. Intended as an alternative to the contacts property; if both are sent, their combined length must not exceed 500.
500[
"11ad7a1c-9a63-30e0-a1de-cd9a766805ca",
"22bd8b2d-0b74-41f1-b2ef-de0ab877916db"
]
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.
false
Contact enrich request. Provide an array of contacts to research by identity. Each item must include one of the following combinations:
- contactName and companyName (optionally include title when using isJobChange)
- contactName and domain
- liProfileUrl
- liSalesNavUrl
- liRecruiterUrl
Intended as an alternative to searchResultIds; if both are sent, their combined length must not exceed 500. When isJobChange is true, only the contacts array should be used.
500Show child attributes
Show child attributes
IDs of the contact lists to add each newly saved contact to. Contacts that were already researched are not saved again, so they are not added to the lists. The lists must already belong to the authenticated user; an unknown ID fails the research request items, which report the error when you poll for them.
50[1234, 5678]
When true, research will not check for duplicate records that you already researched recently, and perform a research (which can result in credit usage)
Response
The request IDs for research
Indicates whether the research request was accepted successfully.
true
Array of request IDs corresponding to each contact research request. Use these IDs to poll for results via /contacts/research/poll.
500["6Ei5iKuSHzJXvqjVPWiZ_"]
Was this page helpful?
curl --request POST \
--url https://api.seamless.ai/api/client/v1/contacts/research \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"searchResultIds": [
"searchResultId1",
"searchResultId2"
]
}
'{
"success": true,
"requestIds": [
"6Ei5iKuSHzJXvqjVPWiZ_"
]
}{
"message": "<string>"
}{
"msg": "<string>",
"code": "<string>",
"data": {
"productCategory": "<string>",
"additionalCreditsNeeded": 123
}
}{
"message": "<string>"
}