Saved Search → Companies

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

Introduction

Run a saved company 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/company-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/companies with {"savedSearchId": <id>} and page with nextToken.

Example

curl -X POST https://api.seamless.ai/api/client/v1/search/companies \
  -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/companies",
    headers={"Token": os.environ["SEAMLESS_API_KEY"]},
    json={"savedSearchId": 1234}).json()["data"]

Reference

Parameter	Type	Required	Description
`savedSearchId`	integer	Yes	ID of a saved company 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 company previews with searchResultId, companyName, domain, address, industry, size, revenue, and technologies. Send searchResultId to Company Research for the full record. Fields: Company 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 → Companies

Introduction

AI agent prompt

Example

Reference

Response

​Introduction

​AI agent prompt

​Example

​Reference

​Response

Introduction

AI agent prompt

Example

Reference

Response