Search Companies

POST

prospecting

company

curl --request POST \
  --url https://api.lusha.com/prospecting/company/search \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "pages": {
    "page": 0,
    "size": 20
  },
  "filters": {
    "companies": {
      "include": {
        "companyLocations": [
          {
            "country": "United States",
            "state": "California"
          },
          {
            "country": "Germany"
          }
        ]
      }
    }
  }
}
'

{
  "requestId": "<string>",
  "currentPage": 123,
  "pageLength": 123,
  "totalResults": 123,
  "companies": [
    {
      "id": "<string>",
      "name": "<string>",
      "fqdn": "<string>",
      "description": "<string>",
      "logoUrl": "<string>",
      "hasCompanyEmployeesCount": true,
      "hasCompanyRevenue": true,
      "hasCompanyMainIndustry": true,
      "hasCompanySubIndustry": true,
      "hasCompanyFunding": true,
      "hasCompanyIntent": true,
      "hasCompanyTechnologies": true,
      "hasCompanyCity": true,
      "hasCompanyCountry": true,
      "signalTypes": null
    }
  ]
}

{
  "statusCode": 400,
  "message": "Invalid request parameters"
}

{
  "statusCode": 401,
  "message": "Invalid API key"
}

{
  "statusCode": 429,
  "message": "Too many requests. Please wait before making another request."
}

{
  "statusCode": 500,
  "message": "Internal server error. Please try again later."
}

Authorizations

api_key

string

header

required

Your Lusha API key. You can find this in your Lusha dashboard under API settings.

Include this key in the api_key header for all requests.

Body

application/json

filters

object

required

Show child attributes

pages

object

Show child attributes

Response

Search results with company IDs

requestId

string

The requestId that should be used in Prospecting Enrich request API params

currentPage

number

Current page of search results

pageLength

number

Page length

totalResults

number

Total search results

companies

object[]

Show child attributes

⌘I

curl --request POST \
  --url https://api.lusha.com/prospecting/company/search \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "pages": {
    "page": 0,
    "size": 20
  },
  "filters": {
    "companies": {
      "include": {
        "companyLocations": [
          {
            "country": "United States",
            "state": "California"
          },
          {
            "country": "Germany"
          }
        ]
      }
    }
  }
}
'

{
  "requestId": "<string>",
  "currentPage": 123,
  "pageLength": 123,
  "totalResults": 123,
  "companies": [
    {
      "id": "<string>",
      "name": "<string>",
      "fqdn": "<string>",
      "description": "<string>",
      "logoUrl": "<string>",
      "hasCompanyEmployeesCount": true,
      "hasCompanyRevenue": true,
      "hasCompanyMainIndustry": true,
      "hasCompanySubIndustry": true,
      "hasCompanyFunding": true,
      "hasCompanyIntent": true,
      "hasCompanyTechnologies": true,
      "hasCompanyCity": true,
      "hasCompanyCountry": true,
      "signalTypes": null
    }
  ]
}

{
  "statusCode": 400,
  "message": "Invalid request parameters"
}

{
  "statusCode": 401,
  "message": "Invalid API key"
}

{
  "statusCode": 429,
  "message": "Too many requests. Please wait before making another request."
}

{
  "statusCode": 500,
  "message": "Internal server error. Please try again later."
}

Overview

Credits & Plans

Guides

Endpoints

Endpoint: (POST) https://api.lusha.com/prospecting/company/search

Signal Filtering (Premium Feature)

Authorizations

Body

Response