Search Companies

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"]
        }
      }
    }
  }'

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": 25,
    "account": {
      "employeeSize": {
        "type": "RANGE",
        "range": [
          { "start": 50, "end": 200 }
        ]
      },
      "industry": {
        "any": {
          "include": ["fintech", "financial services"]
        }
      }
    }
  }'

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": 20,
    "account": {
      "funding": {
        "type": ["SERIES_A", "SERIES_B", "SERIES_C"],
        "totalAmount": {
          "start": 1000000,
          "end": 50000000
        }
      },
      "foundedYear": {
        "start": 2015,
        "end": 2023
      }
    }
  }'

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": 15,
    "account": {
      "keyword": {
        "any": {
          "include": {
            "sources": [
              { "mode": "SMART", "source": "DESCRIPTION" },
              { "mode": "SMART", "source": "KEYWORD" }
            ],
            "content": ["artificial intelligence", "machine learning", "automation"]
          }
        }
      }
    }
  }'

curl -X POST https://api.lance.app/api/v1/entities/prospects/company \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": [
      "https://www.linkedin.com/company/anthropic",
      "https://www.openai.com"
    ],
    "page": 0,
    "size": 10
  }'

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": 20,
    "account": {
      "productAndServices": {
        "any": {
          "include": {
            "mode": "SMART",
            "content": ["CRM", "sales automation", "lead generation"]
          }
        }
      }
    }
  }'

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": 20,
    "account": {
      "metric": {
        "growth": [
          {
            "function": ["engineering", "sales"],
            "start": 10,
            "end": 100,
            "timeFrame": "TWELVE"
          }
        ]
      }
    }
  }'

{
  "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
}

{
  "content": [],
  "totalElements": 0,
  "totalPages": 0,
  "number": 0,
  "size": 10,
  "first": true,
  "last": true,
  "numberOfElements": 0,
  "empty": true
}

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"]
        }
      }
    }
  }'

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": 25,
    "account": {
      "employeeSize": {
        "type": "RANGE",
        "range": [
          { "start": 50, "end": 200 }
        ]
      },
      "industry": {
        "any": {
          "include": ["fintech", "financial services"]
        }
      }
    }
  }'

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": 20,
    "account": {
      "funding": {
        "type": ["SERIES_A", "SERIES_B", "SERIES_C"],
        "totalAmount": {
          "start": 1000000,
          "end": 50000000
        }
      },
      "foundedYear": {
        "start": 2015,
        "end": 2023
      }
    }
  }'

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": 15,
    "account": {
      "keyword": {
        "any": {
          "include": {
            "sources": [
              { "mode": "SMART", "source": "DESCRIPTION" },
              { "mode": "SMART", "source": "KEYWORD" }
            ],
            "content": ["artificial intelligence", "machine learning", "automation"]
          }
        }
      }
    }
  }'

curl -X POST https://api.lance.app/api/v1/entities/prospects/company \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": [
      "https://www.linkedin.com/company/anthropic",
      "https://www.openai.com"
    ],
    "page": 0,
    "size": 10
  }'

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": 20,
    "account": {
      "productAndServices": {
        "any": {
          "include": {
            "mode": "SMART",
            "content": ["CRM", "sales automation", "lead generation"]
          }
        }
      }
    }
  }'

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": 20,
    "account": {
      "metric": {
        "growth": [
          {
            "function": ["engineering", "sales"],
            "start": 10,
            "end": 100,
            "timeFrame": "TWELVE"
          }
        ]
      }
    }
  }'

{
  "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
}

{
  "content": [],
  "totalElements": 0,
  "totalPages": 0,
  "number": 0,
  "size": 10,
  "first": true,
  "last": true,
  "numberOfElements": 0,
  "empty": true
}

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

string[]

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

integer

default:0

Page number for pagination (0-indexed).

integer

default:10

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

object

Account-level filters for company search.

Show account properties

object

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

Show nameOrDomain properties

object

All conditions must match.

Show all properties

object

string

Search match mode: SMART, WORD, or STRICT

string[]

Array of terms to include

object

string

Search match mode: SMART, WORD, or STRICT

string[]

Array of terms to exclude

object

Any condition can match (same structure as all).

object

Filter by company domain with include/exclude arrays.

Show domain properties

object

string[]

Domains to include (all must match)

string[]

Domains to exclude

object

string[]

Domains to include (any can match)

string[]

Domains to exclude

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

Show socialMediaLink properties

object

string[]

Social media URLs to include (all must match)

string[]

Social media URLs to exclude

object

string[]

Social media URLs to include (any can match)

string[]

Social media URLs to exclude

object

Filter by company phone numbers with include/exclude arrays.

Show phoneNumber properties

object

string[]

Phone numbers to include (all must match)

string[]

Phone numbers to exclude

object

string[]

Phone numbers to include (any can match)

string[]

Phone numbers to exclude

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

object

string[]

Industries to include (all must match)

string[]

Industries to exclude

object

string[]

Industries to include (any can match)

string[]

Industries to exclude

object

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

Show location properties

object

string[]

Locations to include (all must match)

string[]

Locations to exclude

object

string[]

Locations to include (any can match)

string[]

Locations to exclude

object

Filter by company products and services with search modes.

Show productAndServices properties

object

All conditions must match.

Show all properties

object

string

Search match mode: SMART, WORD, or STRICT

string[]

Array of products/services to include

object

string

Search match mode: SMART, WORD, or STRICT

string[]

Array of products/services to exclude

object

Any condition can match (same structure as all).

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

Show socialMedia properties

object

string[]

Social media platforms to include (all must match)

string[]

Social media platforms to exclude

object

string[]

Social media platforms to include (any can match)

string[]

Social media platforms to exclude

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

object

string[]

Company types to include (all must match)

string[]

Company types to exclude

object

string[]

Company types to include (any can match)

string[]

Company types to exclude

object

Filter by founded year range.

Show foundedYear properties

integer

Minimum founded year

integer

Maximum founded year

object

Filter by employee count range.

Show employeeSize properties

string

required

Must be RANGE

object[]

required

Array of range objects with start and end values.

object

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

Show revenue properties

string

required

Must be RANGE

object[]

required

Array of range objects with start and end values.

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

object

string[]

Language enum values to include (all must match)

string[]

Language enum values to exclude

object

string[]

Language enum values to include (any can match)

string[]

Language enum values to exclude

object

Range filter for number of languages

number

Minimum count

number

Maximum count

object

Filter by geographic coordinates.

Show geoLocation properties

object

number

Latitude (-90 to 90)

number

Longitude (-180 to 180)

number

Search radius

string

Unit of measure: km or mi

object

Search by keywords across company data sources.

Show keyword properties

object

object[]

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

string[]

Keywords to search for

object

Same structure as include

object

Same structure as all

object

Filter by funding information.

Show funding properties

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

object

Range filter for total funding amount (start, end)

object

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

object

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

object

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

Show metric properties

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

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

Company[]

Array of company objects matching the search criteria.

Show Company object properties

string

Unique identifier (UUID) for the company.

string

ISO timestamp when the company record was created.

string

ISO timestamp when the company record was last updated.

string

Company name.

string | null

Full company description.

string | null

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

string | null

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

string | null

Primary industry classification.

string[]

Array of company phone numbers.

string | null

LinkedIn company page URL.

string | null

Company website URL.

string | null

Company domain (extracted from website).

string | null

Headquarters city.

string | null

Headquarters postal code.

string | null

Headquarters country.

string | null

URL to company logo image.

string | null

Internal provider identifier.

integer | null

Bullhorn CRM identifier.

string | null

Generic CRM identifier.

string | null

Legal/registered company name.

integer | null

Year the company was founded.

string | null

Estimated annual revenue range.

object | null

Detailed location information.

Show location properties

object | null

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

object[]

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

integer | null

Total number of companies matching the search criteria.

integer | null

Total number of pages available.

integer | null

Current page number (0-indexed).

integer | null

Number of results per page.

boolean | null

Whether this is the first page.

boolean | null

Whether this is the last page.

integer | null

Number of elements in the current page.

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"]
        }
      }
    }
  }'

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": 25,
    "account": {
      "employeeSize": {
        "type": "RANGE",
        "range": [
          { "start": 50, "end": 200 }
        ]
      },
      "industry": {
        "any": {
          "include": ["fintech", "financial services"]
        }
      }
    }
  }'

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": 20,
    "account": {
      "funding": {
        "type": ["SERIES_A", "SERIES_B", "SERIES_C"],
        "totalAmount": {
          "start": 1000000,
          "end": 50000000
        }
      },
      "foundedYear": {
        "start": 2015,
        "end": 2023
      }
    }
  }'

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": 15,
    "account": {
      "keyword": {
        "any": {
          "include": {
            "sources": [
              { "mode": "SMART", "source": "DESCRIPTION" },
              { "mode": "SMART", "source": "KEYWORD" }
            ],
            "content": ["artificial intelligence", "machine learning", "automation"]
          }
        }
      }
    }
  }'

curl -X POST https://api.lance.app/api/v1/entities/prospects/company \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": [
      "https://www.linkedin.com/company/anthropic",
      "https://www.openai.com"
    ],
    "page": 0,
    "size": 10
  }'

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": 20,
    "account": {
      "productAndServices": {
        "any": {
          "include": {
            "mode": "SMART",
            "content": ["CRM", "sales automation", "lead generation"]
          }
        }
      }
    }
  }'

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": 20,
    "account": {
      "metric": {
        "growth": [
          {
            "function": ["engineering", "sales"],
            "start": 10,
            "end": 100,
            "timeFrame": "TWELVE"
          }
        ]
      }
    }
  }'

{
  "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
}

{
  "content": [],
  "totalElements": 0,
  "totalPages": 0,
  "number": 0,
  "size": 10,
  "first": true,
  "last": true,
  "numberOfElements": 0,
  "empty": true
}

Error Responses

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.

Overview

Lead Lists

ICPs

Users

Prospects

Autocomplete

Enrichment

CRM Integration

Credits & Payments

Data Operations

Authentication

Request

Body Parameters

Response

Examples

Error Responses

Background Processing

​Authentication

​Request

​Body Parameters

​Response

​Examples

​Error Responses

​Background Processing

Authentication

Request

Body Parameters

Response

Examples

Error Responses

Background Processing