Profile Keyword → Contacts

POST /search/contacts · Credits charged per results returned · v1, v2 · Part of the Contact Search API

Introduction

Match keywords against a contact’s profile: skills, bio, and specialties. Use it for niche expertise that titles don’t capture. Combine it with any other filter in the same request (AND logic).

AI agent prompt

Read https://docs.seamless.ai/api-catalog/contact-filters/profile-keyword. Using SEAMLESS_API_KEY, call POST https://api.seamless.ai/api/client/v1/search/contacts with the `contactKeyword` filter to find contacts matching: <your target>. Page with nextToken and keep each searchResultId.

Example

curl -X POST https://api.seamless.ai/api/client/v1/search/contacts \
  -H "Token: $SEAMLESS_API_KEY" -H "Content-Type: application/json" \
  -d '{"contactKeyword": ["sales enablement"], "limit": 25}'

import os, requests
rows = requests.post("https://api.seamless.ai/api/client/v1/search/contacts",
    headers={"Token": os.environ["SEAMLESS_API_KEY"]},
    json={"contactKeyword": ["sales enablement"], "limit": 25}).json()["data"]

Reference

Parameter	Type	Required	Description
`contactKeyword`	string[]	Yes	Filter contacts by keyword matches against their profile (e.g., skills, bio, specialties). Up to 10 keywords can be specified.
`keywordsIsOr`	boolean	No	Controls how multiple `contactKeyword` values are combined. When `false` (default), a contact must match all of the keywords (AND logic). When `true`, matching any one of them is enough (OR logic). Default `false`.
`limit`	integer	No	Results per page, up to 500. Default `50`.
`nextToken`	string	No	Cursor from `supplementalData.nextToken` to fetch the next page.

Response

Rows are contact previews with searchResultId, name, title, seniority, company, location, and LinkedIn URL, but no emails or phones. Send searchResultId to Contact Research to get them. Fields: Contact Search. Auth: Token header (API keys) · Errors: status codes · Billing: rate limits and credits

Catalog

Identity resolution

Search

Contact Search filters

Company Search filters

Research

My data

Platform

Coming soon

Profile Keyword → Contacts

Introduction

AI agent prompt

Example

Reference

Response

​Introduction

​AI agent prompt

​Example

​Reference

​Response

Introduction

AI agent prompt

Example

Reference

Response