Organization search count

Introduction

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

The endpoint accepts exactly the filters of Organization 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 Organization search: the scalar filters (companyName, companyDomain, industry, specialities, maxDataAgeDate), the nested-object filters (employeeCountRange, foundedYear, followersCount, location) and the specialities matching rules. See the Organization 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 organizations`);

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 organizations")

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