Sign in
latestOpenAPI 3.0.3Proprietary2026-08-1960166333.3 KB

8e62fb5a9414

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
  • Open job posting counts: total and breakdowns by department, location, and seniority

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.
  • monthlyWebsiteTraffic — monthly website traffic and month-over-month change.
  • openJobsTotal — reveals the total open job count. In the response, this appears as the total field inside the openJobs object.
  • openJobsByDepartment — reveals open job counts broken down by department. In the response, this appears as the byDepartment field inside the openJobs object.
  • openJobsByLocation — reveals open job counts broken down by location. In the response, this appears as the byLocation field inside the openJobs object.
  • openJobsBySeniority — reveals open job counts broken down by seniority level. In the response, this appears as the bySeniority field inside the openJobs object.
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",
    "openJobsTotal",
    "openJobsByDepartment",
    "openJobsByLocation",
    "openJobsBySeniority"
  ],
  "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"
      },
      "openJobs": {
        "total": 47,
        "byDepartment": [
          {
            "department": "Engineering",
            "count": 21
          }
        ],
        "byLocation": [
          {
            "location": "United States",
            "count": 12
          }
        ],
        "bySeniority": [
          {
            "seniority": "Manager",
            "count": 5
          }
        ]
      },
      "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",
        "facebook": "https://www.facebook.com/lusha",
        "x": "https://x.com/lusha"
      },
      "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
  }
}