Skip to main content
GET
/
companies
/
search
cURL
curl --request GET \
  --url https://public-api.lonescale.com/companies/search \
  --header 'x-api-key: <api-key>'
{
  "results": [
    {
      "linkedinId": "2135371",
      "linkedinUniversalName": "stripe",
      "linkedinUrl": "https://www.linkedin.com/company/stripe",
      "name": "Stripe",
      "domain": "stripe.com",
      "websiteUrl": "https://stripe.com",
      "logoUrl": "<string>",
      "description": "<string>",
      "linkedinTagline": "Help increase the GDP of the internet.",
      "industry": "Computer Software",
      "foundedYear": 2010,
      "staffCount": 13809,
      "staffCountRange": {
        "start": 5001,
        "end": 10000
      },
      "countryCode": "US",
      "city": "South San Francisco",
      "postalCode": "94080",
      "linkedinSpecialities": [
        "<string>"
      ],
      "linkedinHashtags": [
        "<string>"
      ],
      "confirmedLocations": [
        {
          "country": "<string>",
          "geographicArea": "<string>",
          "city": "<string>",
          "postalCode": "<string>",
          "line1": "<string>",
          "headquarter": true
        }
      ],
      "fundingData": {},
      "headcount": [
        {
          "function": "Engineering",
          "count": 5058
        }
      ]
    }
  ],
  "count": 1,
  "custom": {
    "crm_id": "abc-123",
    "priority": "1"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.lonescale.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Provide your API key in the x-api-key header.

Query Parameters

​
domain
string

Company domain (e.g. stripe.com). Schemes, www., paths, and casing are normalized server-side.

Minimum string length: 1
​
linkedin_id
string

Numeric LinkedIn company id (the digits in linkedin.com/company/{id}).

Minimum string length: 1
​
slug
string

LinkedIn universal name / slug (the trailing segment in linkedin.com/company/{slug}).

Minimum string length: 1
​
name
string

Company name. Best-effort match — prefer domain, linkedin_id, or slug for deterministic resolution.

Minimum string length: 1
​
enrich
boolean
default:false

When true, fall back to on-demand enrichment if no cached match is found, and attach a headcount breakdown when possible. Defaults to false.

​
custom
string

Arbitrary key/value passthrough echoed unchanged in the response — useful for correlating results with records on your side. Pass a URL-encoded JSON object, e.g. custom=%7B%22crm_id%22%3A%22abc-123%22%2C%22priority%22%3A1%7D (decodes to {"crm_id":"abc-123","priority":1}). Only flat string/number values are kept — nested objects, arrays, booleans and null are dropped.

Response

Search completed. results contains at most one company, or is empty when nothing matched.

​
results
object[]
required

At most one matching company. Empty when nothing was found.

​
count
integer
required

Number of items in results (0 or 1).

Example:

1

​
custom
object
required

The custom map from the request, echoed unchanged. {} when none was sent.

Example:
{ "crm_id": "abc-123", "priority": "1" }