Skip to main content
POST
/
public
/
v1
/
companies
/
search
Search scored companies by name or domain
curl --request POST \
  --url http://app.stairoids.com/api/public/v1/companies/search \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "query": "acme",
  "page": 0,
  "size": 20
}
'
{
  "data": [
    {
      "companyId": 4521,
      "name": "Acme Corp",
      "domain": "acme.com",
      "industry": "Software",
      "country": "Netherlands",
      "city": "Amsterdam",
      "employeeCount": 250,
      "companySize": "201-500",
      "linkedInUrl": "https://www.linkedin.com/company/acme",
      "totalScore": 87,
      "icpMatched": true,
      "icpId": 7,
      "icpName": "Mid-market SaaS",
      "rankedLeadScoreId": 55231,
      "logoUrl": "<string>",
      "funnelStageId": 12,
      "funnelStage": "Hot",
      "labels": [
        {
          "id": 5,
          "name": "Strategic",
          "color": "#73d89c",
          "userGenerated": true
        }
      ],
      "latestActivityTimestamp": 1719500000000
    }
  ],
  "page": 0,
  "size": 20,
  "totalElements": 137,
  "totalPages": 7
}

Authorizations

​
X-Api-Key
string
header
required

Your organization's public API key. Manage it at GET /api/user/public-api-key.

Body

application/json

Search request for scored companies in your pipeline.

​
query
string

Free-text query matched against company name and employee names.

Example:

"acme"

​
page
integer<int32>
default:0

Zero-based page index.

Example:

0

​
size
integer<int32>
default:20

Page size (clamped to 100).

Example:

20

Response

OK

A page of results.

​
data
object[]

The items on this page.

​
page
integer<int32>

Zero-based page index.

Example:

0

​
size
integer<int32>

Requested page size.

Example:

20

​
totalElements
integer<int64>

Total number of matching items across all pages.

Example:

137

​
totalPages
integer<int32>

Total number of pages.

Example:

7