> ## Documentation Index > Fetch the complete documentation index at: https://docs.companyenrich.com/llms.txt > Use this file to discover all available pages before exploring further. # Search > **Cost:** 1 credit per company returned. 1 credit minimum if no results are found. **Notice**: Up to 10.000 results can be returned from this endpoint (page * pageSize can not exceed 10.000). If you need more results, please use the scroll endpoint. Searches companies based on given criteria. You can search by name, domain, industry, employees, revenue, founded year, and more. At most 100 companies are returned per request. If you need more results, please use the pagination parameters. ## OpenAPI ````yaml openapi/v1.json POST /companies/search openapi: 3.0.4 info: title: Company Enrich API description: >- The Company Enrich API provides programmatic access to a comprehensive database of company and person data for enrichment, search, and lead generation. ## Key Features - **Company Enrichment** — Enrich company profiles by domain, ID, or matching properties. Supports single lookups, batch requests, and bulk background jobs. - **Company Search** — Search and filter companies by industry, location, size, technology usage, keywords, and more. Supports page-based, cursor-based, and async export pagination. - **People Search** — Search for professionals by job title, company, location, and other criteria. Export results in CSV or JSON. - **Similar Companies** — Find companies similar to a given company based on shared attributes. - **Company Lists** — Create and manage saved lists of companies for organizing and exporting your data. ## Authentication All API requests require a Bearer token passed in the `Authorization` header: ``` Authorization: Bearer YOUR_API_TOKEN ``` You can generate API tokens from your [dashboard](https://companyenrich.com/dashboard). ## Credits Most API calls consume credits. The credit cost for each endpoint is documented in its description. You can check your remaining credit balance using the User endpoint. ## Rate Limiting The global API limiter allows **500 requests per minute** per IP address. Authenticated API routes also use a per-user route limiter based on plan capabilities. Supplementary lookup endpoints (such as keyword/technology/industry autocompletes) use a separate per-user route-level bucket. termsOfService: https://companyenrich.com/terms-and-conditions contact: url: https://companyenrich.com/ email: support@companyenrich.com version: 1.0.0 servers: - url: https://api.companyenrich.com security: - Bearer: [] tags: - name: Company / Enrichment description: >- Enrich company data by domain, properties, or in batch. Get company details by ID. - name: Company / Bulk Enrichment description: >- Create and manage asynchronous bulk enrichment jobs for large domain lists. - name: Company / Search description: Search companies by filters with pagination and cursor scrolling. - name: Company / Export description: Create and manage asynchronous company search export jobs. - name: Company / Similar description: Find companies similar to a given company by domain or ID. - name: People / Search description: >- Search people by various criteria with page-based or cursor-based pagination. - name: People / Enrichment description: >- Resolve work email addresses for individual people in realtime or background jobs. - name: People / Export description: Create and manage asynchronous people search export jobs. - name: Jobs description: >- Endpoints for listing and monitoring background processing jobs such as bulk enrichments and async exports. - name: Company / Lists description: Endpoints for creating and managing company lists and export lists. - name: Geo description: >- Endpoints for looking up geographic data including regions, countries, states, and cities. - name: Industries description: >- Endpoints for listing available industry classifications used in company search filters. - name: Keywords description: Endpoints for looking up keywords used in company search filters. - name: Technologies description: Endpoints for looking up technologies used in company search filters. - name: User description: >- Endpoints for retrieving information about the authenticated user, including credit balance and account details. - name: Positions description: >- Endpoints for looking up job positions and titles used in people search filters. paths: /companies/search: post: tags: - Company / Search summary: Search description: >- **Cost:** 1 credit per company returned. 1 credit minimum if no results are found. **Notice**: Up to 10.000 results can be returned from this endpoint (page * pageSize can not exceed 10.000). If you need more results, please use the scroll endpoint. Searches companies based on given criteria. You can search by name, domain, industry, employees, revenue, founded year, and more. At most 100 companies are returned per request. If you need more results, please use the pagination parameters. parameters: - name: expand in: query description: >- Expandable response fields. Repeat the parameter to request multiple expansions. Supported values: - `workforce`: costs 5 credits per company and adds the `workforce` field to `CompanyInfo`. schema: type: array items: enum: - workforce type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/CompanySearchPageInput' required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PaginatedListOfCompanyInfo' '400': description: Bad Request content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '401': description: Unauthorized content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '402': description: Payment Required content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '422': description: Unprocessable Entity content: application/problem+json: schema: $ref: '#/components/schemas/HttpValidationProblemDetails' '429': description: Too Many Requests content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' components: schemas: CompanySearchPageInput: type: object properties: page: type: integer description: The page number to return. Must be greater than 0 format: int32 pageSize: maximum: 100 minimum: 1 type: integer description: >- The number of results to return in each page. Must be between 1 and 100 format: int32 lists: type: array items: type: string format: uuid description: The list IDs to filter by nullable: true semanticQuery: maxLength: 500 type: string description: >- The semantic search query to find companies with. More natural language version of the standard query. nullable: true semanticWeight: maximum: 1 minimum: 0 type: number description: >- The semantic weight to apply to the results. Must be between 0 and 1. 0.7 is default. Larger values will prioritize semantic similarity, smaller values will prioritize traditional search factors. format: double nullable: true exclude: $ref: '#/components/schemas/CompanyExcludeFilters' query: maxLength: 250 type: string description: The search query to apply on the company name and domain nullable: true foundedYear: $ref: '#/components/schemas/YearRange' fundingAmount: $ref: '#/components/schemas/CompanyFundingAmountRange' fundingYear: $ref: '#/components/schemas/YearRange' categoryOperator: $ref: '#/components/schemas/NullableOfFilterOperator' keywordsOperator: $ref: '#/components/schemas/NullableOfFilterOperator' technologiesOperator: $ref: '#/components/schemas/NullableOfFilterOperator' workforceGrowth: $ref: '#/components/schemas/CompanyWorkforceGrowthInput' workforceSize: type: array items: $ref: '#/components/schemas/CompanyWorkforceSizeInput' description: >- Filter companies by absolute workforce headcount. Multiple entries can be provided to filter on different departments simultaneously. nullable: true require: type: array items: $ref: '#/components/schemas/FeatureRequirement' description: The features that must exist for the company nullable: true regions: type: array items: type: string description: The region IDs to filter by nullable: true countries: type: array items: type: string description: The 2 letter country codes to filter by nullable: true states: type: array items: type: integer format: int32 description: The state IDs to filter by nullable: true cities: type: array items: type: integer format: int32 description: The city IDs to filter by nullable: true type: type: array items: $ref: '#/components/schemas/CompanyType' description: The list of company types to filter by nullable: true category: type: array items: $ref: '#/components/schemas/CompanyCategory' description: The list of company categories to filter by nullable: true employees: type: array items: $ref: '#/components/schemas/CompanyEmployees' description: The list of employee counts to filter by nullable: true reportedEmployees: type: array items: $ref: '#/components/schemas/CompanyEmployees' description: The list of externally reported employee counts to filter by nullable: true revenue: type: array items: $ref: '#/components/schemas/CompanyRevenue' description: The list of revenue ranges to filter by nullable: true naicsCode: type: array items: type: integer format: int32 description: >- The NAICS codes to filter by. Can be 2 to 6 digit codes. In case of a 2-5 digit code, all 6 digit codes under it will be included nullable: true keywords: type: array items: type: string description: The keywords to filter by nullable: true technologies: type: array items: type: string description: The technologies to filter by nullable: true fundingRounds: type: array items: $ref: '#/components/schemas/CompanyFundingRound' description: The funding rounds to filter by nullable: true PaginatedListOfCompanyInfo: required: - items type: object properties: items: type: array items: $ref: '#/components/schemas/CompanyInfo' description: The items in the list page: type: integer description: The current page number. 1-indexed format: int32 totalPages: type: integer description: The total number of pages format: int32 totalItems: type: integer description: The total number of items in the list format: int32 ProblemDetails: type: object properties: type: type: string nullable: true title: type: string nullable: true status: type: integer format: int32 nullable: true detail: type: string nullable: true instance: type: string nullable: true HttpValidationProblemDetails: type: object properties: type: type: string nullable: true title: type: string nullable: true status: type: integer format: int32 nullable: true detail: type: string nullable: true instance: type: string nullable: true errors: type: object additionalProperties: type: array items: type: string CompanyExcludeFilters: type: object properties: domains: type: array items: type: string description: The domain names of companies to exclude from the results nullable: true regions: type: array items: type: string description: The region IDs to filter by nullable: true countries: type: array items: type: string description: The 2 letter country codes to filter by nullable: true states: type: array items: type: integer format: int32 description: The state IDs to filter by nullable: true cities: type: array items: type: integer format: int32 description: The city IDs to filter by nullable: true type: type: array items: $ref: '#/components/schemas/CompanyType' description: The list of company types to filter by nullable: true category: type: array items: $ref: '#/components/schemas/CompanyCategory' description: The list of company categories to filter by nullable: true employees: type: array items: $ref: '#/components/schemas/CompanyEmployees' description: The list of employee counts to filter by nullable: true reportedEmployees: type: array items: $ref: '#/components/schemas/CompanyEmployees' description: The list of externally reported employee counts to filter by nullable: true revenue: type: array items: $ref: '#/components/schemas/CompanyRevenue' description: The list of revenue ranges to filter by nullable: true naicsCode: type: array items: type: integer format: int32 description: >- The NAICS codes to filter by. Can be 2 to 6 digit codes. In case of a 2-5 digit code, all 6 digit codes under it will be included nullable: true keywords: type: array items: type: string description: The keywords to filter by nullable: true technologies: type: array items: type: string description: The technologies to filter by nullable: true fundingRounds: type: array items: $ref: '#/components/schemas/CompanyFundingRound' description: The funding rounds to filter by nullable: true description: >- Exclusion filters to apply on the companies. If a company matches any of the filters here, it will be excluded from the results. nullable: true YearRange: type: object properties: min: type: integer description: The minimum year (inclusive) format: int32 nullable: true max: type: integer description: The maximum year (inclusive) format: int32 nullable: true description: The range of years nullable: true CompanyFundingAmountRange: type: object properties: min: type: number description: The minimum funding amount (inclusive) format: double nullable: true max: type: number description: The maximum funding amount (inclusive) format: double nullable: true description: The funding amount range to filter by nullable: true NullableOfFilterOperator: enum: - And - Or - null description: The operator to apply to the filters. Defaults to And. nullable: true CompanyWorkforceGrowthInput: type: object properties: period: $ref: '#/components/schemas/NullableOfCompanyWorkforceGrowthPeriod' department: $ref: '#/components/schemas/NullableOfCompanyWorkforceGrowthDepartment' minPercent: type: number description: >- The minimum workforce growth percentage (inclusive). Example: 15 means 15% growth, -10 means 10% decline. format: double nullable: true maxPercent: type: number description: >- The maximum workforce growth percentage (inclusive). Example: 15 means 15% growth, -10 means 10% decline. format: double nullable: true description: >- Filter companies by workforce growth percentage over a selected period and department. nullable: true CompanyWorkforceSizeInput: type: object properties: department: $ref: '#/components/schemas/NullableOfCompanyWorkforceGrowthDepartment2' min: type: integer description: The minimum headcount (inclusive). format: int32 nullable: true max: type: integer description: The maximum headcount (inclusive). format: int32 nullable: true FeatureRequirement: enum: - linkedin - twitter - facebook - instagram - angellist - crunchbase - youtube - country - city - state - revenue - foundedYear - anyFunding CompanyType: enum: - private - public - self-employed - self-owned - partnership - nonprofit - educational - government CompanyCategory: enum: - b2b - b2c - b2g - e-commerce - media - service-provider - mobile - saas - local-business CompanyEmployees: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K CompanyRevenue: enum: - under-1m - 1m-10m - 10m-50m - 50m-100m - 100m-200m - 200m-1b - over-1b CompanyFundingRound: enum: - seed - debt_financing - angel - venture - series_a - series_b - series_c - series_d - series_e - series_f - series_g - series_h - other CompanyInfo: required: - id type: object properties: id: type: string description: The unique identifier of the company format: uuid name: maxLength: 1024 type: string description: The name of the company nullable: true domain: maxLength: 1024 type: string description: The primary domain name of the company nullable: true website: type: string description: The website URL of the company format: uri nullable: true type: $ref: '#/components/schemas/NullableOfCompanyType' legalName: type: string description: The legal name of the company nullable: true industry: type: string description: The main industry of the company nullable: true industries: type: array items: type: string description: The industries associated with the company nullable: true categories: type: array items: $ref: '#/components/schemas/CompanyCategory' description: The categories of the company from most to least specific. nullable: true employees: $ref: '#/components/schemas/NullableOfCompanyEmployees' reported_employees: $ref: '#/components/schemas/NullableOfCompanyEmployees2' revenue: $ref: '#/components/schemas/NullableOfCompanyRevenue' description: type: string description: The description of the company nullable: true keywords: type: array items: type: string description: The search keywords of the company nullable: true technologies: type: array items: type: string description: The technologies associated with the company nullable: true subsidiaries: type: array items: type: string description: The subsidiaries associated with the company nullable: true founded_year: type: integer description: The year the company was founded format: int32 nullable: true naics_codes: type: array items: type: string description: The NAICS codes associated with the company nullable: true location: $ref: '#/components/schemas/CompanyLocationInfo' financial: $ref: '#/components/schemas/CompanyFinancialInfo' socials: $ref: '#/components/schemas/CompanySocialUrls' page_rank: type: number description: The page rank of the company format: float nullable: true workforce: $ref: '#/components/schemas/CompanyWorkforceInfo' logo_url: type: string description: The logo URL of the company nullable: true seo_description: type: string description: The SEO description of the company nullable: true updated_at: type: string description: The last updated timestamp of the company format: date-time NullableOfCompanyWorkforceGrowthPeriod: enum: - m6 - y1 - y2 - null description: The period to measure workforce growth over. nullable: true NullableOfCompanyWorkforceGrowthDepartment: enum: - overall - c_suite - product_management - engineering_technical - design - education - finance - human_resources - information_technology - legal - marketing - medical_health - operations - sales - consulting - null description: The department to measure workforce growth for. nullable: true NullableOfCompanyWorkforceGrowthDepartment2: enum: - overall - c_suite - product_management - engineering_technical - design - education - finance - human_resources - information_technology - legal - marketing - medical_health - operations - sales - consulting - null description: >- The department to filter headcount for. Defaults to overall if not specified. nullable: true NullableOfCompanyType: enum: - unknown - private - public - self-employed - self-owned - partnership - nonprofit - educational - government - null description: The type of the company nullable: true NullableOfCompanyEmployees: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K - null description: The employee count range. nullable: true NullableOfCompanyEmployees2: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K - null description: The employee count range reported by external data providers. nullable: true NullableOfCompanyRevenue: enum: - under-1m - 1m-10m - 10m-50m - 50m-100m - 100m-200m - 200m-1b - over-1b - null description: The range of annual revenue of the company in USD nullable: true CompanyLocationInfo: type: object properties: country: $ref: '#/components/schemas/CountryInfo' state: $ref: '#/components/schemas/StateInfo' city: $ref: '#/components/schemas/CityInfo' address: type: string nullable: true postal_code: type: string nullable: true phone: type: string nullable: true description: The location information of the company nullable: true CompanyFinancialInfo: type: object properties: stock_symbol: type: string nullable: true stock_exchange: type: string nullable: true total_funding: type: integer format: int64 nullable: true funding_stage: type: string nullable: true funding_date: type: string format: date-time nullable: true funding: type: array items: $ref: '#/components/schemas/CompanyFundingInfo' nullable: true description: The financial information of the company nullable: true CompanySocialUrls: type: object properties: linkedin_url: type: string description: The LinkedIn URL of the company format: uri nullable: true linkedin_id: maxLength: 1024 type: string description: The LinkedIn ID of the company nullable: true twitter_url: type: string description: The Twitter URL of the company format: uri nullable: true facebook_url: type: string description: The Facebook URL of the company format: uri nullable: true instagram_url: type: string description: The Instagram URL of the company format: uri nullable: true angellist_url: type: string description: The AngelList URL of the company format: uri nullable: true crunchbase_url: type: string description: The Crunchbase URL of the company format: uri nullable: true youtube_url: type: string description: The YouTube URL of the company format: uri nullable: true github_url: type: string description: The GitHub URL of the company format: uri nullable: true g2_url: type: string description: The G2 URL of the company format: uri nullable: true description: The social URLs of the company CompanyWorkforceInfo: required: - company_id - domain - department_headcount type: object properties: company_id: type: string description: The CompanyEnrich ID of the company. format: uuid domain: type: string description: The canonical domain of the company. observed_employee_count: type: integer description: Observed number of distinct current employees in our people dataset. format: int32 employee_count_range: $ref: '#/components/schemas/NullableOfCompanyEmployees' department_headcount: $ref: '#/components/schemas/CompanyWorkforceDepartmentHeadcount' unclassified_headcount: type: integer description: Headcount where department could not be classified. format: int32 history: type: array items: $ref: '#/components/schemas/CompanyWorkforceHistoryEntry' description: >- Monthly workforce snapshots showing headcount changes over time. Only months where headcount changed are included. nullable: true description: >- Expanded workforce insights for the company. This field is only returned when `expand=workforce` is requested. nullable: true CountryInfo: type: object properties: code: type: string description: The ISO 3166-1 alpha-2 code of the country name: type: string description: The name of the country latitude: type: number description: The latitude of the country format: float nullable: true longitude: type: number description: The longitude of the country format: float nullable: true description: The origin country information of the company nullable: true StateInfo: type: object properties: id: type: integer description: The ID of the state format: int32 name: type: string description: The name of the state code: type: string description: The ISO 3166-2 code of the state nullable: true latitude: type: number description: The latitude of the state format: float nullable: true longitude: type: number description: The longitude of the state format: float nullable: true description: The state information of the company nullable: true CityInfo: type: object properties: id: type: integer description: The ID of the city format: int32 name: type: string description: The name of the city latitude: type: number description: The latitude of the city format: float nullable: true longitude: type: number description: The longitude of the city format: float nullable: true description: The city information of the company nullable: true CompanyFundingInfo: type: object properties: date: type: string format: date-time nullable: true amount: type: string nullable: true type: type: string nullable: true url: type: string nullable: true from: type: string nullable: true CompanyWorkforceDepartmentHeadcount: type: object properties: c_suite: type: integer description: Headcount in the c-suite root department. format: int32 nullable: true product_management: type: integer description: Headcount in the product management root department. format: int32 nullable: true engineering_technical: type: integer description: Headcount in the engineering and technical root department. format: int32 nullable: true design: type: integer description: Headcount in the design root department. format: int32 nullable: true education: type: integer description: Headcount in the education root department. format: int32 nullable: true finance: type: integer description: Headcount in the finance root department. format: int32 nullable: true human_resources: type: integer description: Headcount in the human resources root department. format: int32 nullable: true information_technology: type: integer description: Headcount in the information technology root department. format: int32 nullable: true legal: type: integer description: Headcount in the legal root department. format: int32 nullable: true marketing: type: integer description: Headcount in the marketing root department. format: int32 nullable: true medical_health: type: integer description: Headcount in the medical and health root department. format: int32 nullable: true operations: type: integer description: Headcount in the operations root department. format: int32 nullable: true sales: type: integer description: Headcount in the sales root department. format: int32 nullable: true consulting: type: integer description: Headcount in the consulting root department. format: int32 nullable: true description: Headcount grouped by root department name. CompanyWorkforceHistoryEntry: required: - date - department_headcount type: object properties: date: type: string description: First day of the month for this snapshot. format: date observed_employee_count: type: integer description: >- Observed number of distinct employees in our people dataset for this month. format: int32 employee_count_range: $ref: '#/components/schemas/NullableOfCompanyEmployees' department_headcount: $ref: '#/components/schemas/CompanyWorkforceDepartmentHeadcount' unclassified_headcount: type: integer description: Headcount where department could not be classified. format: int32 securitySchemes: Bearer: type: apiKey description: >- API Token used for authentication. Example: "Authorization: Bearer {token}" name: Authorization in: header x-bearer-format: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.