Getting Started Companies Jobs Stats

Stats API

Retrieve summary information about the companies and jobs in your Recuity workspace.

Workspace stats

GET/api/v1/stats

Returns aggregate statistics for your tracked jobs: total counts plus job counts per company and per country. The endpoint takes no parameters: it always reports on the workspace the API key belongs to.

https://recuity.ai/api/v1/stats

Example request

curl -X GET \
  "https://recuity.ai/api/v1/stats" \
  -H "X-API-Key: YOUR_API_KEY"
import requests

response = requests.get(
    "https://recuity.ai/api/v1/stats",
    headers={"X-API-Key": "YOUR_API_KEY"}
)
data = response.json()

Example response

200 OK
{
  "total_jobs_count": 18420,
  "total_companies_with_jobs_count": 312,
  "total_tracking_companies_count": 480,
  "total_companies_added_count": 12,
  "company_wise_job_count": {
    "TechCorp Solutions": 142,
    "Northwind Labs": 87
  },
  "country_wise_job_count": {
    "United Kingdom": 9120,
    "Netherlands": 2140
  },
  "last_updated_on": "2026-01-23T18:27:47Z"
}

Response fields

FieldTypeDescription
total_jobs_countNumberTotal number of jobs being tracked
total_companies_with_jobs_countNumberNumber of companies with active jobs
total_tracking_companies_countNumberTotal number of companies being tracked
total_companies_added_countNumberNumber of companies your workspace has added
company_wise_job_countObjectKey-value pairs: company name → job count
country_wise_job_countObjectKey-value pairs: country name → job count
last_updated_onStringTimestamp when statistics were last updated (ISO 8601)
Previous← Jobs