Skip to main content
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.
  • 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. Public API v2 is in beta, so v2 calls return 403 until Seamless enables v2 for your organization.

Filters

The API reference has the full schema and every allowed value. 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

Response (trimmed)
Search results do not include emails or phone numbers. Send the searchResultId to the Contact Research API to get them. For Python, JavaScript, and other languages, see Search contacts in the API reference.