Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB
Enrich

Enrich Companies

Reveal full company data for companies you've already found via Search Companies.

Pass up to 100 company ids (from the search response). Each enriched result includes:

  • Firmographics: size, revenue range, year founded, company type
  • Industry: primary industry, sub-industry, SIC/NAICS codes
  • Locations: HQ and additional office sites
  • Technologies, funding rounds, buyer intent topics
  • LinkedIn followers, logo URL, social links

Billing: Charged per successful result via the reveal_company action.

Persisting to a table: Pass tableId to also add these companies to an existing table and populate the relevant enrichment columns. See Companies Tables.

post/v3/companies/enrich

Request body

idsstring[] required

Company IDs from search results (strings)

revealstring[]

Additional data fields to reveal. Each field is charged separately per result.

  • employeesByDepartment — breakdown of employees by department
  • employeesByLocation — breakdown of employees by country/state
  • employeesBySeniority — breakdown of employees by seniority level
  • competitors — list of competitor company IDs
  • intent — buyer intent topics
  • estimatedAnnualItSpend — estimated annual IT spend. 1 credit per company, charged only when a non-null value is returned.
  • monthlyWebsiteTraffic — monthly website traffic and month-over-month change. 1 credit per company, charged only when a non-null value is returned.
tableIdstring

Optional. If provided, these companies are also added to this table (if not already present) and the revealed fields' columns are populated. See the Tables API.

Example request

{
  "ids": [
    "16303253",
    "12790225"
  ],
  "reveal": [
    "employeesByDepartment",
    "employeesByLocation",
    "employeesBySeniority",
    "competitors",
    "intent",
    "estimatedAnnualItSpend",
    "monthlyWebsiteTraffic"
  ],
  "tableId": "583021"
}

Response

Successful response

requestIdstring uuid

Example response

{
  "results": [
    {
      "id": "16303253",
      "name": "Lusha",
      "alternativeName": "lusha",
      "domain": "www.lusha.com",
      "alternativeDomains": [
        "lusha.com"
      ],
      "description": "Lusha is the leader in Sales Streaming.",
      "companyType": "Private Company",
      "yearFounded": 2016,
      "employeeCount": {
        "exact": 364,
        "min": 201,
        "max": 500
      },
      "industry": "Technology, Information & Media",
      "subIndustry": "Software Development",
      "specialities": [
        "data enrichment",
        "sales intelligence"
      ],
      "industryTags": [
        "saas",
        "b2b"
      ],
      "sicCodes": [
        {
          "code": 7371,
          "description": "Custom computer programming services"
        }
      ],
      "naicsCodes": [
        {
          "code": 541511,
          "description": "Custom Computer Programming Services"
        }
      ],
      "companyOffering": "Cloud-based CRM software for small businesses",
      "emailDomain": "lusha.com",
      "additionalIndustries": [
        {
          "industry": "Financial Services",
          "subIndustry": "Insurance"
        }
      ],
      "estimatedAnnualItSpend": {
        "value": 500000,
        "currency": "USD",
        "valueUsd": 500000
      },
      "monthlyWebsiteTraffic": {
        "visits": 128450,
        "momChangePercent": 4.3,
        "month": "2026-06"
      },
      "location": {
        "city": "London",
        "state": "England",
        "stateCode": "MA",
        "country": "United Kingdom",
        "countryIso2": "GB",
        "continent": "Europe",
        "zipCode": "80904"
      },
      "additionalLocations": [
        {
          "city": "London",
          "state": "England",
          "stateCode": "MA",
          "country": "United Kingdom",
          "countryIso2": "GB",
          "continent": "Europe",
          "zipCode": "80904"
        }
      ],
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/company/lushadata"
      },
      "linkedinFollowers": 64339,
      "revenueRange": {
        "min": 10000000,
        "max": 50000000
      },
      "technologies": [
        "react",
        "node.js",
        "aws"
      ],
      "popularityTier": 1,
      "logoUrl": "https://logo.lusha.co/logo.jpg",
      "employeesByDepartment": [
        {
          "department": "Engineering & Technical",
          "count": 14
        },
        {
          "department": "Operations",
          "count": 40
        },
        {
          "department": "Other",
          "count": 104
        }
      ],
      "employeesByLocation": [
        {
          "country": "United States",
          "state": "Colorado",
          "count": 54
        },
        {
          "country": "United States",
          "state": "Texas",
          "count": 44
        },
        {
          "country": "United States",
          "state": null,
          "count": 162
        }
      ],
      "employeesBySeniority": [
        {
          "seniority": "Non-Manager",
          "count": 122
        },
        {
          "seniority": "Manager",
          "count": 39
        },
        {
          "seniority": "Vice President",
          "count": 3
        }
      ],
      "competitors": [
        {
          "id": "2497917",
          "name": "Clearbit",
          "domain": "clearbit.com"
        },
        {
          "id": "9781263",
          "name": "Hunter.io",
          "domain": "hunter.io"
        },
        {
          "id": "40857684",
          "name": "MCJ Solutions Inc",
          "domain": "zoominfo.com"
        }
      ],
      "businessModel": [
        "B2B"
      ],
      "phone": "(480) 729-6394",
      "email": "info@cobbmechanical.com",
      "keywords": [
        "construction",
        "hvac",
        "plumbing",
        "mechanical system"
      ],
      "specialitiesRefactored": [
        "construction",
        "hvac",
        "industrial piping",
        "mechanical systems",
        "plumbing"
      ],
      "error": {
        "code": "NOT_FOUND",
        "message": "Contact not found"
      }
    }
  ],
  "tableWrite": {
    "tableId": "482910",
    "added": 3,
    "alreadyPresent": 2,
    "rowsProcessed": 5,
    "rowsCharged": 5
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}