Endpoints // Search

People search count

New

Count matching people with the same filters as People search, for free.

POST/v2/search/people/count

Introduction

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

The endpoint accepts exactly the filters of People search, without the pagination parameters: a count is a single number, so there is no page to request.

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

Authorization

Name	Type	Required	Description
`apikey`	string	Yes	Your API key from the developer dashboard. Pass it via `Authorization: Bearer YOUR_API_KEY` header.

Request body

All filters are optional and combined with AND logic, exactly as on People search: scalar filters, the nested-object filters (followersCount, currentCompanyEmployeeCountRange, totalExperienceMonths, location, experience) the position taxonomy filters, and the skills, languages, keywords and job change filters. See the People search page for the complete reference.

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

Field	Type	Description
`success`	boolean	`true` if the request was processed successfully
`error`	`null`	Always `null` on success

dataobject

Total number of matching profiles

Show child attributes

Field	Type	Description
`count`	number	Total profiles matching the supplied filters, across all pages

Code examples

Code Examples

curl -X POST https://api.reversecontact.com/v2/search/people/count \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "currentFunction": "Marketing",
    "currentSeniority": ["Director", "VP"],
    "location": { "countryCode": "FR" }
  }'

const response = await fetch(
  "https://api.reversecontact.com/v2/search/people/count",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      currentFunction: "Marketing",
      currentSeniority: ["Director", "VP"],
      location: { countryCode: "FR" }
    })
  }
);

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

import requests

response = requests.post(
    "https://api.reversecontact.com/v2/search/people/count",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "currentFunction": "Marketing",
        "currentSeniority": ["Director", "VP"],
        "location": {"countryCode": "FR"}
    }
)

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

Example response

200 - Success

Example Response

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