Company search count

Introduction

The Company Search Count endpoint returns the total number of companies matching the same filters as Company search, without returning any profile. Use it to size a query before spending credits: Company search costs 1 credit per company delivered, while this endpoint is free.

The endpoint accepts exactly the filters of Company search, without the pagination parameters: a count is a single number, so there is no page to request, and sending cursor or perPage returns HTTP 422 with UNKNOWN_FIELD.

Like Usage, this endpoint costs 0 credits, but it is still a real request: it counts toward your rate limits.

Authorization

Request body

Filters are combined with AND logic, exactly as on Company search: the scalar filters (companyName, companyDomain, industry, specialities, maxDataAgeDate), the nested-object filters (employeeCountRange, foundedYear, followersCount, location) and the specialities matching rules. See the Company search page for the complete reference.

At least one filter is required, and maxDataAgeDate cannot be the only one: both cases return HTTP 422 with NO_FILTER_PROVIDED. Filters are validated before the query runs: unknown field names, blank values and values outside a closed list return HTTP 422 with the offending field and suggested values. See Search filter validation.

Response structure

Code examples

curl -X POST https://api.reversecontact.com/v2/search/organizations/count \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "industry": "Software Development",
    "employeeCountRange": { "min": 51, "max": 200 },
    "location": { "countryCode": "FR" }
  }'

const response = await fetch(
  "https://api.reversecontact.com/v2/search/organizations/count",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      industry: "Software Development",
      employeeCountRange: { min: 51, max: 200 },
      location: { countryCode: "FR" }
    })
  }
);

const payload = await response.json();
console.log(`${payload.data.count} matching companies`);

import requests

response = requests.post(
    "https://api.reversecontact.com/v2/search/organizations/count",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "industry": "Software Development",
        "employeeCountRange": {"min": 51, "max": 200},
        "location": {"countryCode": "FR"}
    }
)

payload = response.json()
print(f"{payload['data']['count']} matching companies")

Example response

{
  "success": true,
  "data": {
    "count": 2317
  },
  "error": null,
  "quotas": {
    "creditsConsumed": 0,
    "workspace": {
      "id": "ws_abc123",
      "credits": { "total": 10000, "used": 4521, "left": 5479 }
    }
  },
  "metadata": {
    "requestId": "req_o1c2o3u4n5t6",
    "executionTimeMs": 88
  }
}