Search companies

curl --request POST \
  --url https://api.companyenrich.com/v2/companies/search \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "pageSize": 50,
  "cursor": "<string>",
  "expand": [],
  "filter": {
    "query": "<string>",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "domain": "<string>",
    "keywords": "<string>",
    "technologies": "<string>",
    "region": "<string>",
    "country": "<string>",
    "state": 123,
    "city": 123,
    "workforceGrowth": {
      "min": 123,
      "max": 123
    },
    "workforceSize": [
      {
        "min": 123,
        "max": 123
      }
    ],
    "naicsCodes": "<string>",
    "foundedYear": {
      "min": 123,
      "max": 123
    },
    "fundingAmount": {
      "min": 123,
      "max": 123
    },
    "fundingYear": {
      "min": 123,
      "max": 123
    }
  },
  "semantic": {
    "query": "<string>",
    "weight": 0.5,
    "autoFilter": true
  },
  "lookalike": {
    "domains": [
      "<string>"
    ],
    "weight": 0,
    "minScore": 0.5
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    pageSize: 50,
    cursor: '<string>',
    expand: [],
    filter: {
      query: '<string>',
      id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
      domain: '<string>',
      keywords: '<string>',
      technologies: '<string>',
      region: '<string>',
      country: '<string>',
      state: 123,
      city: 123,
      workforceGrowth: {min: 123, max: 123},
      workforceSize: [{min: 123, max: 123}],
      naicsCodes: '<string>',
      foundedYear: {min: 123, max: 123},
      fundingAmount: {min: 123, max: 123},
      fundingYear: {min: 123, max: 123}
    },
    semantic: {query: '<string>', weight: 0.5, autoFilter: true},
    lookalike: {domains: ['<string>'], weight: 0, minScore: 0.5}
  })
};

fetch('https://api.companyenrich.com/v2/companies/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.companyenrich.com/v2/companies/search"

payload = {
    "pageSize": 50,
    "cursor": "<string>",
    "expand": [],
    "filter": {
        "query": "<string>",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "domain": "<string>",
        "keywords": "<string>",
        "technologies": "<string>",
        "region": "<string>",
        "country": "<string>",
        "state": 123,
        "city": 123,
        "workforceGrowth": {
            "min": 123,
            "max": 123
        },
        "workforceSize": [
            {
                "min": 123,
                "max": 123
            }
        ],
        "naicsCodes": "<string>",
        "foundedYear": {
            "min": 123,
            "max": 123
        },
        "fundingAmount": {
            "min": 123,
            "max": 123
        },
        "fundingYear": {
            "min": 123,
            "max": 123
        }
    },
    "semantic": {
        "query": "<string>",
        "weight": 0.5,
        "autoFilter": True
    },
    "lookalike": {
        "domains": ["<string>"],
        "weight": 0,
        "minScore": 0.5
    }
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "domain": "<string>",
      "website": "<string>",
      "logoUrl": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "legalName": "<string>",
      "description": "<string>",
      "type": "private",
      "foundedYear": 123,
      "employees": "1-10",
      "revenue": "under-1m",
      "industry": "<string>",
      "industries": [
        "<string>"
      ],
      "categories": [
        "b2b"
      ],
      "location": {
        "country": {
          "code": "<string>",
          "name": "<string>"
        },
        "state": {
          "id": 123,
          "name": "<string>",
          "code": "<string>"
        },
        "city": {
          "id": 123,
          "name": "<string>"
        },
        "address": "<string>",
        "postalCode": "<string>",
        "phone": "<string>"
      },
      "socials": {
        "linkedinUrl": "<string>",
        "linkedinId": "<string>",
        "twitterUrl": "<string>",
        "facebookUrl": "<string>",
        "instagramUrl": "<string>",
        "angellistUrl": "<string>",
        "crunchbaseUrl": "<string>",
        "youtubeUrl": "<string>",
        "githubUrl": "<string>",
        "g2Url": "<string>"
      },
      "financial": {
        "stockSymbol": "<string>",
        "stockExchange": "<string>",
        "totalFunding": 123,
        "fundingStage": "<string>",
        "fundingDate": "2023-11-07T05:31:56Z",
        "fundingRounds": [
          {
            "date": "2023-11-07T05:31:56Z",
            "amount": "<string>",
            "type": "<string>",
            "url": "<string>",
            "investors": "<string>"
          }
        ]
      },
      "keywords": [
        "<string>"
      ],
      "naicsCodes": [
        "<string>"
      ],
      "technologies": [
        "<string>"
      ],
      "workforce": {
        "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "domain": "<string>",
        "observedEmployeeCount": 123,
        "departmentHeadcount": {
          "cSuite": 123,
          "productManagement": 123,
          "engineeringTechnical": 123,
          "design": 123,
          "education": 123,
          "finance": 123,
          "humanResources": 123,
          "informationTechnology": 123,
          "legal": 123,
          "marketing": 123,
          "medicalHealth": 123,
          "operations": 123,
          "sales": 123,
          "consulting": 123
        },
        "unclassifiedHeadcount": 123,
        "historyFrom": "2023-12-25",
        "historyTo": "2023-12-25",
        "employeeCountRange": "1-10",
        "history": [
          {
            "date": "2023-12-25",
            "observedEmployeeCount": 123,
            "departmentHeadcount": {
              "cSuite": 123,
              "productManagement": 123,
              "engineeringTechnical": 123,
              "design": 123,
              "education": 123,
              "finance": 123,
              "humanResources": 123,
              "informationTechnology": 123,
              "legal": 123,
              "marketing": 123,
              "medicalHealth": 123,
              "operations": 123,
              "sales": 123,
              "consulting": 123
            },
            "unclassifiedHeadcount": 123,
            "employeeCountRange": "1-10"
          }
        ],
        "nextCursor": "<string>"
      }
    }
  ],
  "nextCursor": "<string>",
  "scores": {},
  "interpretation": {
    "filter": {
      "query": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "domain": "<string>",
      "keywords": "<string>",
      "technologies": "<string>",
      "region": "<string>",
      "country": "<string>",
      "state": 123,
      "city": 123,
      "type": "private",
      "employees": "1-10",
      "reportedEmployees": "1-10",
      "revenue": "under-1m",
      "workforceGrowth": {
        "period": "m6",
        "department": "overall",
        "min": 123,
        "max": 123
      },
      "workforceSize": [
        {
          "department": "overall",
          "min": 123,
          "max": 123
        }
      ],
      "naicsCodes": "<string>",
      "categories": "b2b",
      "foundedYear": {
        "min": 123,
        "max": 123
      },
      "fundingRounds": "seed",
      "fundingAmount": {
        "min": 123,
        "max": 123
      },
      "fundingYear": {
        "min": 123,
        "max": 123
      },
      "require": "linkedin"
    },
    "boost": {
      "names": [
        "<string>"
      ],
      "categories": [
        "b2b"
      ],
      "revenue": [
        "under-1m"
      ]
    }
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": {}
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

Company · Search

Search companies

Search companies using filters, a natural-language query, or lookalike seed domains.

Standard search costs 1 credit per returned company, semantic search costs 2, and lookalike search costs 5, plus requested paid expansions. Empty results cost one result’s base price.

Each requested expansion (financial, keywords, naicsCodes, technologies, or workforce) adds 1 credit per returned company. workforce includes the latest 12 months of history. Use its nextCursor with GET /v2/companies/workforce to retrieve each preceding 12-month page for another 1 credit. Repeating an expansion does not multiply its cost.

The request can contain standard filters, a semantic query, or lookalike seed companies. Filters can be combined with either search mode, but semantic and lookalike searches cannot be combined.

Semantic queries infer company attributes by default. For example, saas companies in Turkey filters companies in Turkey and ranks companies categorized as SaaS higher. Inferred location, employee, founded year, and funding values filter results. Inferred company names, categories, and revenue rank matching companies higher without excluding others; a company the query names, such as Monzo in Monzo digital bank, ranks first. Request filters that include values take precedence over inferred values of the same kind; request exclusions apply together with inferred values. The response interpretation reports what was inferred. Set semantic.autoFilter to false to disable inference.

Send an empty object ({}) to search without filters.

Results use cursor pagination. Omit cursor for the first page and pass a cursor returned by the previous response to continue. Numbered pagination is not supported.

Keep the same query when continuing a search. Cursors expire 24 hours after the first page. Lookalike searches reorder the first 150 matches; subsequent matches retain their original order. Preserve the returned order rather than sorting all results by score.

A value filter supports these input forms:

match one value: "TR"
match several values using the field’s default rule: ["TR", "US"]
configure advanced matching rules: { "in": ["TR"], "notIn": ["US"] }

A single value or array matches any provided value for scalar fields, NAICS codes, and funding rounds. For keywords, technologies, categories, and required features, every provided value must match. The object form can select another supported matching rule explicitly.

POST

companies

Search companies

curl --request POST \
  --url https://api.companyenrich.com/v2/companies/search \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "pageSize": 50,
  "cursor": "<string>",
  "expand": [],
  "filter": {
    "query": "<string>",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "domain": "<string>",
    "keywords": "<string>",
    "technologies": "<string>",
    "region": "<string>",
    "country": "<string>",
    "state": 123,
    "city": 123,
    "workforceGrowth": {
      "min": 123,
      "max": 123
    },
    "workforceSize": [
      {
        "min": 123,
        "max": 123
      }
    ],
    "naicsCodes": "<string>",
    "foundedYear": {
      "min": 123,
      "max": 123
    },
    "fundingAmount": {
      "min": 123,
      "max": 123
    },
    "fundingYear": {
      "min": 123,
      "max": 123
    }
  },
  "semantic": {
    "query": "<string>",
    "weight": 0.5,
    "autoFilter": true
  },
  "lookalike": {
    "domains": [
      "<string>"
    ],
    "weight": 0,
    "minScore": 0.5
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    pageSize: 50,
    cursor: '<string>',
    expand: [],
    filter: {
      query: '<string>',
      id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
      domain: '<string>',
      keywords: '<string>',
      technologies: '<string>',
      region: '<string>',
      country: '<string>',
      state: 123,
      city: 123,
      workforceGrowth: {min: 123, max: 123},
      workforceSize: [{min: 123, max: 123}],
      naicsCodes: '<string>',
      foundedYear: {min: 123, max: 123},
      fundingAmount: {min: 123, max: 123},
      fundingYear: {min: 123, max: 123}
    },
    semantic: {query: '<string>', weight: 0.5, autoFilter: true},
    lookalike: {domains: ['<string>'], weight: 0, minScore: 0.5}
  })
};

fetch('https://api.companyenrich.com/v2/companies/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.companyenrich.com/v2/companies/search"

payload = {
    "pageSize": 50,
    "cursor": "<string>",
    "expand": [],
    "filter": {
        "query": "<string>",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "domain": "<string>",
        "keywords": "<string>",
        "technologies": "<string>",
        "region": "<string>",
        "country": "<string>",
        "state": 123,
        "city": 123,
        "workforceGrowth": {
            "min": 123,
            "max": 123
        },
        "workforceSize": [
            {
                "min": 123,
                "max": 123
            }
        ],
        "naicsCodes": "<string>",
        "foundedYear": {
            "min": 123,
            "max": 123
        },
        "fundingAmount": {
            "min": 123,
            "max": 123
        },
        "fundingYear": {
            "min": 123,
            "max": 123
        }
    },
    "semantic": {
        "query": "<string>",
        "weight": 0.5,
        "autoFilter": True
    },
    "lookalike": {
        "domains": ["<string>"],
        "weight": 0,
        "minScore": 0.5
    }
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "domain": "<string>",
      "website": "<string>",
      "logoUrl": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "legalName": "<string>",
      "description": "<string>",
      "type": "private",
      "foundedYear": 123,
      "employees": "1-10",
      "revenue": "under-1m",
      "industry": "<string>",
      "industries": [
        "<string>"
      ],
      "categories": [
        "b2b"
      ],
      "location": {
        "country": {
          "code": "<string>",
          "name": "<string>"
        },
        "state": {
          "id": 123,
          "name": "<string>",
          "code": "<string>"
        },
        "city": {
          "id": 123,
          "name": "<string>"
        },
        "address": "<string>",
        "postalCode": "<string>",
        "phone": "<string>"
      },
      "socials": {
        "linkedinUrl": "<string>",
        "linkedinId": "<string>",
        "twitterUrl": "<string>",
        "facebookUrl": "<string>",
        "instagramUrl": "<string>",
        "angellistUrl": "<string>",
        "crunchbaseUrl": "<string>",
        "youtubeUrl": "<string>",
        "githubUrl": "<string>",
        "g2Url": "<string>"
      },
      "financial": {
        "stockSymbol": "<string>",
        "stockExchange": "<string>",
        "totalFunding": 123,
        "fundingStage": "<string>",
        "fundingDate": "2023-11-07T05:31:56Z",
        "fundingRounds": [
          {
            "date": "2023-11-07T05:31:56Z",
            "amount": "<string>",
            "type": "<string>",
            "url": "<string>",
            "investors": "<string>"
          }
        ]
      },
      "keywords": [
        "<string>"
      ],
      "naicsCodes": [
        "<string>"
      ],
      "technologies": [
        "<string>"
      ],
      "workforce": {
        "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "domain": "<string>",
        "observedEmployeeCount": 123,
        "departmentHeadcount": {
          "cSuite": 123,
          "productManagement": 123,
          "engineeringTechnical": 123,
          "design": 123,
          "education": 123,
          "finance": 123,
          "humanResources": 123,
          "informationTechnology": 123,
          "legal": 123,
          "marketing": 123,
          "medicalHealth": 123,
          "operations": 123,
          "sales": 123,
          "consulting": 123
        },
        "unclassifiedHeadcount": 123,
        "historyFrom": "2023-12-25",
        "historyTo": "2023-12-25",
        "employeeCountRange": "1-10",
        "history": [
          {
            "date": "2023-12-25",
            "observedEmployeeCount": 123,
            "departmentHeadcount": {
              "cSuite": 123,
              "productManagement": 123,
              "engineeringTechnical": 123,
              "design": 123,
              "education": 123,
              "finance": 123,
              "humanResources": 123,
              "informationTechnology": 123,
              "legal": 123,
              "marketing": 123,
              "medicalHealth": 123,
              "operations": 123,
              "sales": 123,
              "consulting": 123
            },
            "unclassifiedHeadcount": 123,
            "employeeCountRange": "1-10"
          }
        ],
        "nextCursor": "<string>"
      }
    }
  ],
  "nextCursor": "<string>",
  "scores": {},
  "interpretation": {
    "filter": {
      "query": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "domain": "<string>",
      "keywords": "<string>",
      "technologies": "<string>",
      "region": "<string>",
      "country": "<string>",
      "state": 123,
      "city": 123,
      "type": "private",
      "employees": "1-10",
      "reportedEmployees": "1-10",
      "revenue": "under-1m",
      "workforceGrowth": {
        "period": "m6",
        "department": "overall",
        "min": 123,
        "max": 123
      },
      "workforceSize": [
        {
          "department": "overall",
          "min": 123,
          "max": 123
        }
      ],
      "naicsCodes": "<string>",
      "categories": "b2b",
      "foundedYear": {
        "min": 123,
        "max": 123
      },
      "fundingRounds": "seed",
      "fundingAmount": {
        "min": 123,
        "max": 123
      },
      "fundingYear": {
        "min": 123,
        "max": 123
      },
      "require": "linkedin"
    },
    "boost": {
      "names": [
        "<string>"
      ],
      "categories": [
        "b2b"
      ],
      "revenue": [
        "under-1m"
      ]
    }
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": {}
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

Authorizations

Authorization

string

header

required

API Token used for authentication. Example: "Authorization: Bearer {token}"

Body

application/json

pageSize

integer<int32>

The maximum number of companies to return

Required range: 1 <= x <= 100

cursor

string | null

An opaque cursor returned by a previous search response. Omit for the first page.

Maximum string length: 1024

expand

enum<string>[] | null

Additional company data to include. Each requested expansion is charged per returned company, on top of the base cost:

financial: 1 credit
keywords: 1 credit
naicsCodes: 1 credit
technologies: 1 credit
workforce: 1 credit. Includes the latest 12 months of history; each earlier 12-month page from GET /v2/companies/workforce costs another 1 credit.

Available options:

financial,

keywords,

naicsCodes,

technologies,

workforce

filter

object | null

The filters to apply to the company search

Show child attributes

semantic

object | null

The semantic query used to find relevant companies

Show child attributes

lookalike

object | null

The seed companies used to find lookalike companies

Show child attributes

Response

items

object[]

required

The companies returned for this page

Show child attributes

nextCursor

string | null

An opaque cursor for the next page. Omitted when there are no more results.

scores

object | null

Ranking scores by company ID for lookalike searches. The first 150 matches include ranking penalties; later matches retain their original scores and order. Scores are not probabilities. Preserve the returned item order.

Show child attributes

interpretation

object | null

How the semantic query was interpreted. Present for semantic queries with autoFilter enabled.

Show child attributes

Overview

Company · Enrichment

Company · Bulk Enrichment

Company · Search Export

People · Search Export

Company · Search

People · Search

Industries

Keywords

Technologies

Positions

User

Batches

People · Enrichment

Geo

Search companies

Authorizations

Body

Response