BEbettercontact

New Company Finder search

Changed on

Find companies from firmographic, funding and hiring criteria.

This endpoint is asynchronous: it answers immediately with a request_id and searches in the background. Retrieve the results with GET /company_finder/async/{request_id}. Company Finder does not send webhooks.

Several filters only accept exact values from a fixed list. See Taxonomies.

post/company_finder/async

Request

  • Base URL
    https://app.bettercontact.rocks/api/v2
  • URL
    https://app.bettercontact.rocks/api/v2/company_finder/async
  • Auth
    API key in header X-API-Key

Request body

limitinteger

Number of companies to return for this page, between 1 and 200. Defaults to 100. A value above 200 is refused with 422; 0, a negative number or a non-numeric value falls back to the default.

offsetinteger

Zero-based number of matches to skip. A negative value is treated as 0.

To walk through results, keep limit constant and increase offset by limit on each call. The total number of matching companies is returned as summary.companies_found.

Example request

{
  "filters": {
    "company_headcount_min": 51,
    "company_headcount_max": 500
  },
  "limit": 100
}

Response

Company Finder request accepted. Poll GET /company_finder/async/{request_id}.

successboolean
messagestring
request_idstring

Example response

{
  "success": true,
  "message": "Company finder request accepted.",
  "request_id": "bc39ffbfc24cf043b748"
}

Changes