Search Companies - Lance API

curl -X POST https://api.lance.app/api/v1/entities/prospects/company \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 0,
    "size": 10,
    "account": {
      "industry": {
        "any": {
          "include": ["software development", "it services and it consulting"]
        }
      },
      "location": {
        "any": {
          "include": ["United States"]
        }
      }
    }
  }'

{
  "content": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z",
      "name": "Acme Technologies Inc.",
      "description": "Acme Technologies is a leading provider of enterprise software solutions...",
      "summary": "Enterprise software company specializing in cloud-based workflow automation and data analytics for Fortune 500 companies.",
      "headcount": "201-500",
      "industry": "software development",
      "phones": ["+1-555-123-4567"],
      "linkedinUrl": "https://www.linkedin.com/company/acme-technologies",
      "websiteUrl": "https://www.acmetech.com",
      "domain": "acmetech.com",
      "city": "San Francisco",
      "postalCode": "94105",
      "country": "United States",
      "logoUrl": "https://media.licdn.com/company/acme-logo.png",
      "baseProviderId": "ark_123456",
      "bullhornId": null,
      "crmId": null,
      "legalName": "Acme Technologies, Inc.",
      "foundedYear": 2015,
      "revenue": "$10M - $50M",
      "location": {
        "headquarter": {
          "continent": "North America",
          "country": "United States",
          "state": "California",
          "city": "San Francisco",
          "street": "123 Market Street",
          "postalCode": "94105",
          "rawAddress": "123 Market Street, San Francisco, CA 94105",
          "coordinates": {
            "lat": 37.7749,
            "lng": -122.4194
          }
        },
        "locations": []
      }
    }
  ],
  "totalElements": 1542,
  "totalPages": 155,
  "number": 0,
  "size": 10,
  "first": true,
  "last": false,
  "numberOfElements": 10,
  "empty": false
}

POST

api

entities

prospects

company

curl -X POST https://api.lance.app/api/v1/entities/prospects/company \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 0,
    "size": 10,
    "account": {
      "industry": {
        "any": {
          "include": ["software development", "it services and it consulting"]
        }
      },
      "location": {
        "any": {
          "include": ["United States"]
        }
      }
    }
  }'

{
  "content": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z",
      "name": "Acme Technologies Inc.",
      "description": "Acme Technologies is a leading provider of enterprise software solutions...",
      "summary": "Enterprise software company specializing in cloud-based workflow automation and data analytics for Fortune 500 companies.",
      "headcount": "201-500",
      "industry": "software development",
      "phones": ["+1-555-123-4567"],
      "linkedinUrl": "https://www.linkedin.com/company/acme-technologies",
      "websiteUrl": "https://www.acmetech.com",
      "domain": "acmetech.com",
      "city": "San Francisco",
      "postalCode": "94105",
      "country": "United States",
      "logoUrl": "https://media.licdn.com/company/acme-logo.png",
      "baseProviderId": "ark_123456",
      "bullhornId": null,
      "crmId": null,
      "legalName": "Acme Technologies, Inc.",
      "foundedYear": 2015,
      "revenue": "$10M - $50M",
      "location": {
        "headquarter": {
          "continent": "North America",
          "country": "United States",
          "state": "California",
          "city": "San Francisco",
          "street": "123 Market Street",
          "postalCode": "94105",
          "rawAddress": "123 Market Street, San Francisco, CA 94105",
          "coordinates": {
            "lat": 37.7749,
            "lng": -122.4194
          }
        },
        "locations": []
      }
    }
  ],
  "totalElements": 1542,
  "totalPages": 155,
  "number": 0,
  "size": 10,
  "first": true,
  "last": false,
  "numberOfElements": 10,
  "empty": false
}

Search for companies across the Lance database using comprehensive filters including industry, location, employee size, funding, and more. Results are automatically saved to the database and enriched with company summaries in the background.

Authentication

This endpoint requires authentication. The user must be logged in and belong to an organization.

Company summary generation runs in the background and consumes credits. Only companies with a description and LinkedIn URL but no existing summary will be enriched.

Request

Body Parameters

url

string[]

Array of company URLs (LinkedIn or website) to search for specific companies.

page

integer

default:0

Page number for pagination (0-indexed).

size

integer

default:10

Number of results per page. Must be between 0 and 100.

account

object

Account-level filters for company search.

Show account properties

account.nameOrDomain

object

Filter by company name or domain with include/exclude patterns.

Show nameOrDomain properties

all

object

All conditions must match.

Show all properties

include

object

mode

string

Search match mode: SMART, WORD, or STRICT

content

string[]

Array of terms to include

exclude

object

mode

string

Search match mode: SMART, WORD, or STRICT

content

string[]

Array of terms to exclude

any

object

Any condition can match (same structure as all).

account.domain

object

Filter by company domain with include/exclude arrays.

Show domain properties

all

object

include

string[]

Domains to include (all must match)

exclude

string[]

Domains to exclude

any

object

include

string[]

Domains to include (any can match)

exclude

string[]

Domains to exclude

Filter by social media profile URLs with include/exclude arrays.

Show socialMediaLink properties

all

object

include

string[]

Social media URLs to include (all must match)

exclude

string[]

Social media URLs to exclude

any

object

include

string[]

Social media URLs to include (any can match)

exclude

string[]

Social media URLs to exclude

account.phoneNumber

object

Filter by company phone numbers with include/exclude arrays.

Show phoneNumber properties

all

object

include

string[]

Phone numbers to include (all must match)

exclude

string[]

Phone numbers to exclude

any

object

include

string[]

Phone numbers to include (any can match)

exclude

string[]

Phone numbers to exclude

account.industry

object

Filter by industry. Supports 900+ industries including: software development, it services and it consulting, financial services, hospitals and health care, manufacturing, retail, construction, real estate, education, marketing, biotechnology, telecommunications, saas, fintech, artificial intelligence (ai), generative ai, blockchain, cryptocurrency, and many more.

Show industry properties

all

object

include

string[]

Industries to include (all must match)

exclude

string[]

Industries to exclude

any

object

include

string[]

Industries to include (any can match)

exclude

string[]

Industries to exclude

account.location

object

Filter by company location (country, state, city).

Show location properties

all

object

include

string[]

Locations to include (all must match)

exclude

string[]

Locations to exclude

any

object

include

string[]

Locations to include (any can match)

exclude

string[]

Locations to exclude

account.productAndServices

object

Filter by company products and services with search modes.

Show productAndServices properties

all

object

All conditions must match.

Show all properties

include

object

mode

string

Search match mode: SMART, WORD, or STRICT

content

string[]

Array of products/services to include

exclude

object

mode

string

Search match mode: SMART, WORD, or STRICT

content

string[]

Array of products/services to exclude

any

object

Any condition can match (same structure as all).

Filter by social media presence. Values: FACEBOOK, INSTAGRAM, TWITTER, LINKEDIN.

Show socialMedia properties

all

object

include

string[]

Social media platforms to include (all must match)

exclude

string[]

Social media platforms to exclude

any

object

include

string[]

Social media platforms to include (any can match)

exclude

string[]

Social media platforms to exclude

account.type

object

Filter by company type. Values: PRIVATELY_HELD, PUBLIC_COMPANY, GOVERNMENT_AGENCY, PARTNERSHIP, SOLE_PROPRIETORSHIP, NON_PROFIT, EDUCATIONAL, SELF_OWNED, SELF_EMPLOYED.

Show type properties

all

object

include

string[]

Company types to include (all must match)

exclude

string[]

Company types to exclude

any

object

include

string[]

Company types to include (any can match)

exclude

string[]

Company types to exclude

account.foundedYear

object

Filter by founded year range.

Show foundedYear properties

start

integer

Minimum founded year

end

integer

Maximum founded year

account.employeeSize

object

Filter by employee count range.

Show employeeSize properties

type

string

required

Must be RANGE

range

object[]

required

Array of range objects with start and end values.

account.revenue

object

Filter by annual revenue range (same structure as employeeSize).

Show revenue properties

type

string

required

Must be RANGE

range

object[]

required

Array of range objects with start and end values.

account.language

object

Filter by company operating language. Supports 49 languages: english, spanish, french, portuguese, german, dutch, italian, chinese, turkish, polish, russian, swedish, arabic, indonesian, danish, czech, norwegian, japanese, korean, romanian, ukrainian, thai, hindi, malay, tagalog, vietnamese, finnish, persian, greek, hungarian, bengali, marathi, telugu, panjabi, serbian, slovak, croatian, lithuanian, latvian, albanian, icelandic, armenian, bosnian, tamil, javanese, malayalam, kannada, burmese.

Show language properties

all

object

include

string[]

Language enum values to include (all must match)

exclude

string[]

Language enum values to exclude

any

object

include

string[]

Language enum values to include (any can match)

exclude

string[]

Language enum values to exclude

range

object

Range filter for number of languages

start

number

Minimum count

end

number

Maximum count

account.geoLocation

object

Filter by geographic coordinates.

Show geoLocation properties

position

object

lat

number

Latitude (-90 to 90)

lng

number

Longitude (-180 to 180)

radius

number

Search radius

unit

string

Unit of measure: km or mi

account.keyword

object

Search by keywords across company data sources.

Show keyword properties

all

object

include

object

sources

object[]

Array of source configurations with mode (SMART, WORD, STRICT) and source. Sources: NAME, KEYWORD, SEO, DESCRIPTION, INDUSTRY

content

string[]

Keywords to search for

exclude

object

Same structure as include

any

object

Same structure as all

account.funding

object

Filter by funding information.

Show funding properties

type

string[]

Funding round types: PRE_SEED, SEED, SERIES_A, SERIES_B, SERIES_C, SERIES_D, SERIES_E, SERIES_F, SERIES_G, SERIES_H, SERIES_I, SERIES_J, VENTURE_ROUND, ANGEL, PRIVATE_EQUITY, DEBT_FINANCING, CONVERTIBLE_NOTE, GRANT, CORPORATE_ROUND, EQUITY_CROWDFUNDING, PRODUCT_CROWDFUNDING, SECONDARY_MARKET, POST_IPO_EQUITY, POST_IPO_DEBT, POST_IPO_SECONDARY, NON_EQUITY_ASSISTANCE, INITIAL_COIN_OFFERING, UNDISCLOSED, SERIES_UNKNOWN, FUNDING_ROUND

totalAmount

object

Range filter for total funding amount (start, end)

lastAmount

object

Range filter for last funding round amount (start, end)

duration

object

Time range for funding (start, end as ISO timestamps)

account.metric

object

Filter by company metrics (employee counts by department, growth rates).

Show metric properties

employee

object[]

Array of employee count filters by department. Each object has:

function: array of department enums (see below)
start: minimum employee count
end: maximum employee count

Department values: program_and_project_management, education, purchasing, accounting, sales, research, operations, customer_success_and_support, legal, product_management, media_and_communication, real_estate, quality_assurance, consulting, arts_and_design, healthcare_services, entrepreneurship, engineering, community_and_social_services, marketing, information_technology, business_development, administrative, military_and_protective_services, finance, human_resources, support

growth

object[]

Array of headcount growth filters by department. Each object has:

function: array of department enums (same as employee, also accepts custom strings)
start: minimum growth percentage
end: maximum growth percentage
timeFrame: ONE, THREE, SIX, TWELVE, or TWENTY_FOUR (months)

Response

content

Company[]

Array of company objects matching the search criteria.

Show Company object properties

string

Unique identifier (UUID) for the company.

createdAt

string

ISO timestamp when the company record was created.

updatedAt

string

ISO timestamp when the company record was last updated.

name

string

Company name.

description

string | null

Full company description.

summary

string | null

AI-generated company summary (generated in background if not present).

headcount

string | null

Employee count range (e.g., “51-200”).

industry

string | null

Primary industry classification.

phones

string[]

Array of company phone numbers.

linkedinUrl

string | null

LinkedIn company page URL.

websiteUrl

string | null

Company website URL.

domain

string | null

Company domain (extracted from website).

city

string | null

Headquarters city.

postalCode

string | null

Headquarters postal code.

country

string | null

Headquarters country.

logoUrl

string | null

URL to company logo image.

baseProviderId

string | null

Internal provider identifier.

bullhornId

integer | null

Bullhorn CRM identifier.

crmId

string | null

Generic CRM identifier.

legalName

string | null

Legal/registered company name.

foundedYear

integer | null

Year the company was founded.

revenue

string | null

Estimated annual revenue range.

location

object | null

Detailed location information.

Show location properties

headquarter

object | null

Headquarters location with continent, country, state, city, street, postalCode, rawAddress, and coordinates (lat, lng).

locations

object[]

Array of additional office locations (same structure as headquarter).

totalElements

integer | null

Total number of companies matching the search criteria.

totalPages

integer | null

Total number of pages available.

number

integer | null

Current page number (0-indexed).

size

integer | null

Number of results per page.

first

boolean | null

Whether this is the first page.

last

boolean | null

Whether this is the last page.

numberOfElements

integer | null

Number of elements in the current page.

empty

boolean | null

Whether the result set is empty.

Examples

curl -X POST https://api.lance.app/api/v1/entities/prospects/company \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 0,
    "size": 10,
    "account": {
      "industry": {
        "any": {
          "include": ["software development", "it services and it consulting"]
        }
      },
      "location": {
        "any": {
          "include": ["United States"]
        }
      }
    }
  }'

{
  "content": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z",
      "name": "Acme Technologies Inc.",
      "description": "Acme Technologies is a leading provider of enterprise software solutions...",
      "summary": "Enterprise software company specializing in cloud-based workflow automation and data analytics for Fortune 500 companies.",
      "headcount": "201-500",
      "industry": "software development",
      "phones": ["+1-555-123-4567"],
      "linkedinUrl": "https://www.linkedin.com/company/acme-technologies",
      "websiteUrl": "https://www.acmetech.com",
      "domain": "acmetech.com",
      "city": "San Francisco",
      "postalCode": "94105",
      "country": "United States",
      "logoUrl": "https://media.licdn.com/company/acme-logo.png",
      "baseProviderId": "ark_123456",
      "bullhornId": null,
      "crmId": null,
      "legalName": "Acme Technologies, Inc.",
      "foundedYear": 2015,
      "revenue": "$10M - $50M",
      "location": {
        "headquarter": {
          "continent": "North America",
          "country": "United States",
          "state": "California",
          "city": "San Francisco",
          "street": "123 Market Street",
          "postalCode": "94105",
          "rawAddress": "123 Market Street, San Francisco, CA 94105",
          "coordinates": {
            "lat": 37.7749,
            "lng": -122.4194
          }
        },
        "locations": []
      }
    }
  ],
  "totalElements": 1542,
  "totalPages": 155,
  "number": 0,
  "size": 10,
  "first": true,
  "last": false,
  "numberOfElements": 10,
  "empty": false
}

Error Responses

400 Bad Request

Returned when the request body fails validation.

{
  "error": "Invalid request body",
  "issues": [
    {
      "code": "too_big",
      "maximum": 100,
      "type": "number",
      "inclusive": true,
      "exact": false,
      "message": "Number must be less than or equal to 100",
      "path": ["size"]
    }
  ]
}

Background Processing

This endpoint triggers two background processes:

Global Company Repository Sync: All returned companies are saved to the global company repository for cross-tenant data sharing.
Company Summary Generation: Companies that have a description and linkedinUrl but no summary will have AI-generated summaries created in the background. This process:
- Consumes credits from the organization’s account
- Only runs in production with valid organization credentials
- Updates the company records asynchronously

The response returns immediately with the search results. Background processing does not affect response time.

Get User Get Prospect Company

​Authentication

​Request

​Body Parameters

​Response

​Examples

​Error Responses

​Background Processing

Authentication

Request

Body Parameters

Response

Examples

Error Responses

Background Processing