Skip to main content
POST
/
search
/
companies
Search companies
curl --request POST \
  --url https://api.seamless.ai/api/client/v1/search/companies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "nextToken": "eyJwYWdlIjoyLCJzZWFyY2hJZCI6IjEyMzQ1In0=",
  "limit": 50,
  "companyName": [
    "Seamless AI"
  ],
  "companyNameSearchType": "related",
  "companyDomain": [
    "seamless.ai"
  ],
  "companyState": [
    "CA"
  ],
  "companyCountry": [
    "United States"
  ],
  "companyZipCode": [
    "94105"
  ],
  "industry": [
    "Information Technology and Services"
  ],
  "companyKeyword": [
    "sales intelligence",
    "B2B SaaS"
  ],
  "companySize": [
    "51 - 200",
    "201 - 500"
  ],
  "companyRevenue": [
    "$20M - $50M"
  ],
  "technologies": [
    "Salesforce",
    "HubSpot"
  ],
  "technologiesIsOr": true,
  "companyType": "Public",
  "foundedOn": [
    "Less than 1 Year",
    "Last 1-3 Years"
  ],
  "newsTypes": [
    "Acquisition",
    "Expansion"
  ],
  "newsTypeDates": [
    "60"
  ],
  "latestFundingDates": [
    "90"
  ],
  "latestFundingClassifications": [
    "Series A",
    "Seed"
  ],
  "latestFundingTotals": [
    "$0 - $100K",
    "$100K - $1M"
  ]
}
'
{
  "data": [
    {
      "searchResultId": "cmp_sr_01J8YQ4FXZQ6N5G2T3A7BC9D1E",
      "name": "Seamless.AI",
      "street1": "800 W El Camino Real",
      "street2": "Suite 180",
      "street3": "Building B",
      "city": "Mountain View",
      "state": "CA",
      "postCode": "94040",
      "country": "United States",
      "domain": "seamless.ai",
      "description": "Seamless.AI is a sales intelligence platform for finding and engaging prospects.",
      "liUrl": "https://www.linkedin.com/company/seamless-ai/",
      "sicCode": "7372",
      "industries": [
        "Information Technology and Services",
        "Computer Software"
      ],
      "revenueRange": "$20M - $50M",
      "annualRevenue": "35000000",
      "staffCountRange": "51 - 200",
      "employeeCount": "125",
      "numContacts": "487",
      "technologies": [
        "Salesforce",
        "HubSpot",
        "Marketo"
      ],
      "linkedInId": "1234567",
      "companyLIURL": "https://www.linkedin.com/company/seamless-ai/",
      "foundedOn": "2015-01-01",
      "newsAndEvents": [
        {
          "title": "<string>",
          "url": "<string>",
          "date": "2023-11-07T05:31:56Z",
          "type": "<string>"
        }
      ],
      "fundingTotal": "135000000",
      "latestFundingDate": "2018-01-01",
      "latestFundingClassifications": [
        "Series D"
      ],
      "companyType": "Public",
      "stockTicker": "AAPL"
    }
  ],
  "supplementalData": {
    "isMore": true,
    "total": 150,
    "perPage": 5,
    "nextToken": "eyJwYWdlIjoyLCJzZWFyY2hJZCI6ImFiYzEyMyJ9"
  }
}

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.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
nextToken
string

Opaque cursor token from a previous /search/companies response. Use this to fetch the next page of results.

Example:

"eyJwYWdlIjoyLCJzZWFyY2hJZCI6IjEyMzQ1In0="

​
limit
integer
default:50

Number of companies to return per page before credit-based trimming is applied.

Example:

50

​
companyName
string[]

Company names to match. Use this when you know full company names or key name fragments.

Maximum array length: 100
Example:
["Seamless AI"]
​
companyNameSearchType
enum<string>
default:default

Matching strategy for companyName (default = standard matching, related = include aliases/related names, exact = exact company name only).

Available options:
default,
related,
exact
Example:

"related"

​
companyDomain
string[]

Company website domains to match (for example root domains without protocol).

Maximum array length: 100
Example:
["seamless.ai"]
​
companyState
enum<string>[]

Company location state filters. Combined with country/zip filters as part of location matching.

Maximum array length: 10
Available options:
NY,
Texas,
Florida,
VA,
CA
Example:
["CA"]
​
companyCountry
enum<string>[]

Company location country filters. Combined with state/zip filters as part of location matching.

Maximum array length: 10
Available options:
United States,
Canada,
United Kingdom,
Germany,
Australia
Example:
["United States"]
​
companyZipCode
enum<string>[]

Company postal/zip code filters for location-based matching.

Maximum array length: 10
Available options:
10001,
30301,
33101,
60601,
94105
Example:
["94105"]
​
industry
enum<string>[]

Industry categories to include in results. Valid values are the fixed industry list below.

Maximum array length: 5
Available options:
Accounting,
Airlines/Aviation,
Alternative Dispute Resolution,
Alternative Medicine,
Animation,
Apparel & Fashion,
Architecture & Planning,
Arts and Crafts,
Automotive,
Aviation & Aerospace,
Banking,
Biotechnology,
Broadcast Media,
Building Materials,
Business Supplies and Equipment,
Capital Markets,
Chemicals,
Civic & Social Organization,
Civil Engineering,
Commercial Real Estate,
Computer & Network Security,
Computer Games,
Computer Hardware,
Computer Networking,
Computer Software,
Construction,
Consumer Electronics,
Consumer Goods,
Consumer Services,
Cosmetics,
Dairy,
Defense & Space,
Design,
E-Learning,
Education Management,
Electrical/Electronic Manufacturing,
Entertainment,
Environmental Services,
Events Services,
Executive Office,
Facilities Services,
Farming,
Financial Services,
Fine Art,
Fishery,
Food & Beverages,
Food Production,
Fund-Raising,
Furniture,
Gambling & Casinos,
Glass, Ceramics & Concrete,
Government Administration,
Government Relations,
Graphic Design,
Health, Wellness and Fitness,
Higher Education,
Hospital & Health Care,
Hospitality,
Human Resources,
Import and Export,
Individual & Family Services,
Industrial Automation,
Information Services,
Information Technology and Services,
Insurance,
International Affairs,
International Trade and Development,
Internet,
Investment Banking,
Investment Management,
Judiciary,
Law Enforcement,
Law Practice,
Legal Services,
Legislative Office,
Leisure, Travel & Tourism,
Libraries,
Logistics and Supply Chain,
Luxury Goods & Jewelry,
Machinery,
Management Consulting,
Maritime,
Market Research,
Marketing and Advertising,
Mechanical or Industrial Engineering,
Media Production,
Medical Devices,
Medical Practice,
Mental Health Care,
Military,
Mining & Metals,
Motion Pictures and Film,
Museums and Institutions,
Music,
Nanotechnology,
Newspapers,
Non-Profit Organization Management,
Oil & Energy,
Online Media,
Outsourcing/Offshoring,
Package/Freight Delivery,
Packaging and Containers,
Paper & Forest Products,
Performing Arts,
Pharmaceuticals,
Philanthropy,
Photography,
Plastics,
Political Organization,
Primary/Secondary Education,
Printing,
Professional Training & Coaching,
Program Development,
Public Policy,
Public Relations and Communications,
Public Safety,
Publishing,
Railroad Manufacture,
Ranching,
Real Estate,
Recreational Facilities and Services,
Religious Institutions,
Renewables & Environment,
Research,
Restaurants,
Retail,
Security and Investigations,
Semiconductors,
Shipbuilding,
Sporting Goods,
Sports,
Staffing and Recruiting,
Supermarkets,
Telecommunications,
Textiles,
Think Tanks,
Tobacco,
Translation and Localization,
Transportation/Trucking/Railroad,
Utilities,
Venture Capital & Private Equity,
Veterinary,
Warehousing,
Wholesale,
Wine and Spirits,
Wireless,
Writing and Editing
Example:
["Information Technology and Services"]
​
companyKeyword
string[]

Free-text keywords used to match company profile text (name, description, and related indexed company data).

Maximum array length: 10
Example:
["sales intelligence", "B2B SaaS"]
​
companySize
enum<string>[]

Employee size bands to match against company headcount ranges.

Maximum array length: 10
Available options:
0 - 1 (Self-employed),
2 - 10,
11 - 50,
51 - 200,
201 - 500,
501 - 1,000,
1,001 - 5,000,
5,001 - 10,000,
10,001+
Example:
["51 - 200", "201 - 500"]
​
companyRevenue
enum<string>[]

Revenue range bands to match estimated company revenue.

Maximum array length: 10
Available options:
$0 - $100K,
$100K - $1M,
$1M - $5M,
$5M - $20M,
$20M - $50M,
$50M - $100M,
$100M - $500M,
$500M - $1B,
$1B+
Example:
["$20M - $50M"]
​
technologies
enum<string>[]

Technologies used by the company. Sample enum values for documentation only (not exhaustive; actual values come from API/typeahead).

Maximum array length: 10
Available options:
Salesforce,
HubSpot,
Marketo,
Outreach,
Apollo
Example:
["Salesforce", "HubSpot"]
​
technologiesIsOr
boolean

If true, matches companies using any of the specified technologies (OR). If false, matches only companies using all specified technologies (AND).

Example:

true

​
companyType
enum<string> | null

Filter by company type. Public = companies with a known stock ticker/exchange, Private = all others.

Available options:
Public,
Private
Example:

"Public"

​
foundedOn
enum<string>[]

Company age buckets based on founding date.

Maximum array length: 4
Available options:
Less than 1 Year,
Last 1-3 Years,
Last 4-10 Years,
10+ Years
Example:
["Less than 1 Year", "Last 1-3 Years"]
​
newsTypes
enum<string>[]

Filter companies by news/event classification type.

Maximum array length: 8
Available options:
Acquisition,
Corporate Challenges,
Cost Cutting,
Expansion,
Investment,
Leadership,
Partnership,
Recognition
Example:
["Acquisition", "Expansion"]
​
newsTypeDates
enum<string>[]

Limit news/event results to a rolling day window (60, 90, 180, or 365 days). Only the first value is applied.

Maximum array length: 1
Available options:
60,
90,
180,
365
Example:
["60"]
​
latestFundingDates
enum<string>[]

Filter companies based on the date of their latest funding round (90, 180, 365 days or 3 years).

Maximum array length: 1
Available options:
90,
180,
365,
1095
Example:
["90"]
​
latestFundingClassifications
enum<string>[]

Filter companies based on the classifications of their latest funding round.

Maximum array length: 14
Available options:
Angel,
Pre-Seed,
Seed,
Series A,
Series B,
Series C,
Series D,
Series E,
Series F,
Series G,
Series H,
Series I,
Series J,
Other
Example:
["Series A", "Seed"]
​
latestFundingTotals
enum<string>[]

Filter companies based on the total funding amount they have raised.

Maximum array length: 9
Available options:
$0 - $100K,
$100K - $1M,
$1M - $5M,
$5M - $20M,
$20M - $50M,
$50M - $100M,
$100M - $500M,
$500M - $1B,
$1B+
Example:
["$0 - $100K", "$100K - $1M"]

Response

Company Search Results

​
data
object[]

A list of companies

​
supplementalData
object

Pagination metadata for the current search result set.