Contact Search API

The Contact Search API returns people who match your filters, with the job, company, and location attributes you need to choose who to enrich. Each result carries a searchResultId that you pass to the Contact Research API to unlock emails and phone numbers.

Endpoint

POST /search/contacts

Credits

Charged per results returned. Empty pages are free. Details

Page size

Up to 500 per page. Paginate with nextToken.

Use it for

Building prospect lists by persona: title, seniority, and department at target accounts.
Finding the buying committee at a list of domains (up to 100 domains per request).
Trigger-based prospecting: recent job changes, funding rounds, and company news.
Reverse lookup (v2): pass emailAddress or phoneNumber to find who an email or phone number belongs to.

Filters

Category	Filters
Person	`fullName`, `jobTitle`, `titlesExactMatch`, `seniority`, `department`, `contactKeyword`, `keywordsIsOr`
Company	`companyName`, `companyNameSearchType`, `companyDomain`, `companySize`, `companyRevenue`, `companyFoundedOn`, `companyType`
Industry	`industry`, `industrySicCodes`, `industryNaicsCodes`
Location	`locations`, `locationRadius`, `contactState`, `contactCountry`, `contactZipCode`, `zipCodesRadius`, `locationType`, `timezones`
Technology	`technologies`, `technologiesIsOr`
Signals	`jobChanges`, `pastCompany`, `newsTypes`, `newsTypeDates`, `companyLatestFundingDates`, `companyLatestFundingClassifications`, `companyLatestFundingTotals`
Freshness	`lastModifiedAfter`, `lastModifiedBefore`
Reverse lookup (v2 only)	`emailAddress`, `phoneNumber` (up to 100 each)
Paging	`limit`, `nextToken`, `page`, `savedSearchId`

Allowed values:

seniority: C-Level, VP, Director, Manager, Senior, Mid-Level, Entry Level, Other
department: Sales, Marketing, Engineering, IT, Finance, Human Resources, Operations, Support, Legal, Project Management, Other
companySize: 2 - 10 through 10,001+
companyRevenue: $0 - $100K through $1B+
newsTypes: Acquisition, Corporate Challenges, Cost Cutting, Expansion, Investment, Leadership, Partnership, Recognition

The API reference has the full schema and every allowed value.

Every filter as its own API

Each filter has a dedicated page with an example, a parameter reference, allowed values, and an AI agent prompt.

Person	Company	Location	Signals
Job Title	Company Name	Location	Job Change
Seniority	Company Domain	State or Region	Past Company
Department	Company Size	Country	Company News
Full Name	Company Revenue	Zip Code	Funding Date
Profile Keyword	Company Age	Timezone	Funding Stage
Saved Search	Company Type		Total Funding
Last Updated Date	Industry · SIC · NAICS		Technology

Reverse lookup by email or phone: Email → Profile and Phone → Profile.

Location values must match Seamless spelling exactly. Resolve them first with the Location Lookup API. Search returns non-fatal warnings with suggestions when a location matches nothing.

Example

curl -X POST https://api.seamless.ai/api/client/v1/search/contacts \
  -H "Token: $SEAMLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jobTitle": ["Head of Revenue Operations"],
    "seniority": ["VP", "Director"],
    "companySize": ["201 - 500", "501 - 1,000"],
    "locations": ["Texas"],
    "limit": 25
  }'

curl -X POST https://api.seamless.ai/api/client/v2/search/contacts \
  -H "Token: $SEAMLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "emailAddress": ["jane.doe@example.com"] }'

curl -X POST https://api.seamless.ai/api/client/v1/search/contacts \
  -H "Token: $SEAMLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jobChanges": { "changeType": "New Hire" },
    "seniority": ["C-Level"],
    "limit": 50
  }'

Response (trimmed)

{
  "data": [
    {
      "searchResultId": "ctc_sr_...",
      "fullName": "Jane Doe",
      "jobTitle": "VP, Revenue Operations",
      "seniority": "VP",
      "department": "Operations",
      "companyName": "Acme Corp",
      "domain": "acme.com",
      "city": "Austin",
      "state": "Texas",
      "country": "United States",
      "liUrl": "https://www.linkedin.com/in/...",
      "companySize": "201 - 500",
      "timeAtRole": "1 year 4 months"
    }
  ],
  "supplementalData": { "isMore": true, "total": 1243, "nextToken": "..." }
}

Search results do not include emails or phone numbers. Send the searchResultId to the Contact Research API to get them.

Catalog

Identity resolution

Search

Contact Search filters

Company Search filters

Research

My data

Platform

Coming soon

Contact Search API

Endpoint

Credits

Page size

Use it for

Filters

Every filter as its own API

Example

Endpoint

Credits

Page size

​Use it for

​Filters

​Every filter as its own API

​Example

​Related

Use it for

Filters

Every filter as its own API

Example

Related