My Company Data API

Endpoints GET /companies · POST /companies (v2) · Credits free · Versions v1, v2

Introduction

Every company your organization researches is saved to your org. The My Company Data API reads those records back, with firmographics, phones, technologies, and funding, without spending credits. Use it to keep CRM accounts and warehouse tables in sync, and to manage which lists each company belongs to.

AI agent prompt

Read https://docs.seamless.ai/api-catalog/my-company-data. Using SEAMLESS_API_KEY, call
GET https://api.seamless.ai/api/client/v1/companies with startDate/endDate for the last 24 hours,
page through every result, and upsert each company into my CRM keyed on domain.

Authentication

Send your API key in the Token header, or Authorization: Bearer <token> with OAuth. Create a key under Settings → Public API.

Example

curl "https://api.seamless.ai/api/client/v1/companies?startDate=2026-10-19T00:00:00Z&endDate=2026-10-20T00:00:00Z&page=1&limit=100" \
  -H "Token: $SEAMLESS_API_KEY"

import os, requests

H = {"Token": os.environ["SEAMLESS_API_KEY"]}
page = 1
while True:
    rows = requests.get("https://api.seamless.ai/api/client/v1/companies", headers=H,
                        params={"page": page, "limit": 100}).json()["data"]
    if not rows:
        break
    for co in rows:
        print(co.get("companyName"), co.get("domain"))
    page += 1

curl -X POST https://api.seamless.ai/api/client/v2/companies \
  -H "Token: $SEAMLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "companyIds": [9912345], "listIds": [123], "listAction": "add" }'

Reference

`GET /companies`

Parameter	Type	Description
`page`	integer	Page number to retrieve
`limit`	integer	Results per page
`startDate`	string	ISO 8601 start of the lookback window
`endDate`	string	ISO 8601 end of the lookback window

`POST /companies` (v2)

Parameter	Type	Description
`companyIds`	integer[]	Saved companies to update
`listIds`	integer[]	Lists to apply. They must already belong to you.
`listAction`	string	`add`, `remove`, or `replace`

Response

data is an array of company records with the same fields as Company Research. See the Data dictionary.

Errors

Status	Meaning
`401`	Missing or invalid API key
`429`	Rate limit reached

Catalog

Identity resolution

Search

Contact Search filters

Company Search filters

Research

My data

Platform

Coming soon

My Company Data API

Introduction

AI agent prompt

Authentication

Example

Reference

`GET /companies`

`POST /companies` (v2)

Response

Errors

​Introduction

​AI agent prompt

​Authentication

​Example

​Reference

​GET /companies

​POST /companies (v2)

​Response

​Errors

​Related

Introduction

AI agent prompt

Authentication

Example

Reference

`GET /companies`

`POST /companies` (v2)

Response

Errors

Related