Saved Search → Contacts

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

Introduction

Run a saved contact search by its ID instead of sending filters. Build the search once in the Seamless app or with the Engagement API, then rerun it from code. savedSearchId can’t be combined with other filters; only limit, page, and nextToken are allowed alongside it.

AI agent prompt

Read https://docs.seamless.ai/api-catalog/contact-filters/saved-search. Using SEAMLESS_API_KEY, list my saved searches with GET https://api.seamless.ai/api/client/v2/saved-searches, then call POST https://api.seamless.ai/api/client/v1/search/contacts with {"savedSearchId": <id>} and page with nextToken.

Example

curl -X POST https://api.seamless.ai/api/client/v1/search/contacts \
  -H "Token: $SEAMLESS_API_KEY" -H "Content-Type: application/json" \
  -d '{"savedSearchId": 1234}'

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

Reference

Parameter	Type	Required	Description
`savedSearchId`	integer	Yes	ID of a saved contact search, from `GET /saved-searches` (v2). Combining it with any other filter returns a validation error.
`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

Saved Search → Contacts

Introduction

AI agent prompt

Example

Reference

Response

​Introduction

​AI agent prompt

​Example

​Reference

​Response

Introduction

AI agent prompt

Example

Reference

Response