v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB
Search

Search Companies

Look up companies by identifier. Returns a preview of each company profile.

Accepted identifiers (at least one required per company):

  • Lusha company id
  • name
  • domain

Up to 100 companies per request. Each result includes a has field listing the data available via Enrich Companies.

Pass a signals filter to narrow results to companies showing specific activity (e.g. headcount growth, hiring surge).

Billing: Charged per successful result via the api_search action.

post/v3/companies/search

Request body

Example request

{
  "companies": [
    {
      "clientReferenceId": "comp-ref-1",
      "id": "16303253",
      "name": "Lusha",
      "domain": "lusha.com"
    }
  ],
  "options": {
    "includePartialProfiles": true
  },
  "signals": {
    "types": [
      "headcountIncrease3m",
      "surgeInHiring"
    ],
    "startDate": "2025-01-01",
    "maxResultsPerSignal": 10
  }
}

Response

Successful response

requestIdstring uuid

Example response

{
  "results": [
    {
      "clientReferenceId": "comp-ref-1",
      "id": "16303253",
      "name": "Lusha",
      "domain": "www.lusha.com",
      "employeeCount": {
        "exact": 364,
        "min": 201,
        "max": 500
      },
      "industry": "Technology, Information & Media",
      "location": {
        "city": "London",
        "state": "England",
        "stateCode": "MA",
        "country": "United Kingdom",
        "countryIso2": "GB",
        "continent": "Europe"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/company/lushadata"
      },
      "has": [
        "alternativeName",
        "alternativeDomains",
        "description",
        "companyType",
        "yearFounded",
        "subIndustry",
        "specialities",
        "sicCodes",
        "naicsCodes",
        "additionalLocations",
        "linkedinFollowers",
        "popularityTier",
        "logoUrl",
        "employeesByDepartment",
        "employeesByLocation",
        "employeesBySeniority",
        "competitors",
        "businessModel",
        "phones",
        "emails",
        "keywords",
        "socialLinks",
        "estimatedAnnualItSpend",
        "monthlyWebsiteTraffic"
      ],
      "canReveal": [
        {
          "field": "employeesByDepartment",
          "credits": 1
        },
        {
          "field": "employeesByLocation",
          "credits": 1
        },
        {
          "field": "employeesBySeniority",
          "credits": 1
        },
        {
          "field": "competitors",
          "credits": 1
        },
        {
          "field": "intent",
          "credits": 0
        },
        {
          "field": "estimatedAnnualItSpend",
          "credits": 1
        },
        {
          "field": "monthlyWebsiteTraffic",
          "credits": 1
        }
      ],
      "signalTypes": [
        "headcountIncrease3m"
      ],
      "error": {
        "code": "NOT_FOUND",
        "message": "Contact not found"
      }
    }
  ],
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}