> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seamless.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Saved Search → Companies

> Run a saved company search by its ID instead of sending filters. One filter of the Seamless.AI Company Search API.

> [!NOTE]
>
> `POST /search/companies` · Credits charged per results returned · v1, v2 · Part of the [Company Search API](/api-catalog/company-search)

## 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](/api-catalog/engagement#saved-searches), 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

```text theme={null}
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

```bash cURL theme={null}
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}'
```

```python Python theme={null}
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](/api-catalog/company-enrichment) for the full record. Fields: [Company Search](/api-catalog/company-search).

Auth: `Token` header ([API keys](/authentication/api-keys)) · Errors: [status codes](/api-http-status-codes) · Billing: [rate limits and credits](/rate-limits-and-credits)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.