Job Title → Contacts

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

Introduction

Find people by the title they hold today. Titles match on relevance, so “VP of Sales” also finds “Vice President, Sales”. Set titlesExactMatch to true for exact titles only. Combine it with any other filter in the same request (AND logic).

AI agent prompt

Read https://docs.seamless.ai/api-catalog/contact-filters/job-title. Using SEAMLESS_API_KEY, call POST https://api.seamless.ai/api/client/v1/search/contacts with the `jobTitle` 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 '{"jobTitle": ["Chief Technology Officer"], "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={"jobTitle": ["Chief Technology Officer"], "limit": 25}).json()["data"]

Reference

Parameter	Type	Required	Description
`jobTitle`	string[]	Yes	Filter contacts by job title. Matches are based on relevance to the provided title strings. Up to 10 titles can be specified.
`titlesExactMatch`	boolean	No	Controls how `jobTitle` values are matched. When `false` (default), titles match on relevance, so `"VP of Sales"` also matches `"Vice President, Sales"`. When `true`, only exact title matches are returned. 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

Job Title → Contacts

Introduction

AI agent prompt

Example

Reference

Response

​Introduction

​AI agent prompt

​Example

​Reference

​Response

Introduction

AI agent prompt

Example

Reference

Response