ATS jobs count

Parameters, response schema, and authenticated examples for /v1/active-ats-count.

Beta

ATS jobs count

GET
/v1/active-ats-count

Returns the total count of ATS listings matching your filters in the selected time window. No job rows are returned in the body.

Use this endpoint to select the subscription tier that matches your job volume. Call the endpoint with time_frame=1m (every job indexed during the last 31 days, including jobs that have since expired) to see how many jobs match your filters per month. This is the most direct way to figure out which plan you need before subscribing.

1m counts a different set of jobs than the other windows. 1h, 24h, 7d, and 6m count currently active listings only, matching what /active-ats would return for the same window and filters. 1m also includes listings that have expired since being indexed, making it a measure of monthly indexing volume rather than a snapshot of what is live right now. See Count Endpoints.

You don't need this endpoint for pagination. You do not need this endpoint to know how many times to increase offset on /active-ats. Just keep increasing offset on the data endpoint until it returns fewer rows than your limit, that's cheaper than a separate count call.

Cost & timeouts. This endpoint scans the entire filtered set on every call and is intentionally not designed for frequent use. This endpoint will timeout if it runs longer than 60 seconds, and you are likely to hit it on time_frame=6m - use 6m sparingly.

You may use this endpoint to calculate the number of jobs you need to backfill using the 6m time_frame. However, please reach out to us if your API requests are complex and are timing out.

Each call consumes 1 API Request.

Parameters. This endpoint accepts the same parameters as /active-ats with the exception of parameters that are not relevant for count (description_format, include_basic_organization_details, id, limit, offset, cursor).

description / description_advanced are not available for time_frame=6m.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Authenticate requests with Authorization: Bearer YOUR_API_KEY. Find and manage your API key in the dashboard at https://dashboard.fantastic.jobs/dashboard. Store the key in an environment variable and never expose it in client-side code.

Query Parameters

time_frame?string

Time window to count. Defaults to 1m.

  • 1h, 24h, 7d, 6m - count currently active listings only, so the number matches what /active-ats would return for the same window and filters. Listings that have expired are no longer in these windows.
  • 1m - counts every job indexed in the trailing 31 days, including jobs that have since expired. This is monthly indexing volume rather than a live snapshot, which is why it's the window to use for plan sizing. There is no 1m window on the data endpoints.

A 1m count therefore lands close to the sum of 31 consecutive daily 24h calls, while a single 7d or 6m count comes in lower than the sum of the daily calls covering the same period.

description / description_advanced are not available on 6m.

Default"1m"
Value in"1h""24h""7d""1m""6m"
title?string
title_advanced?string
description?string
description_advanced?string
location?string
location_advanced?string
organization?array<string>
exclude_organization?array<string>
organization_advanced?string
domain?array<string>
exclude_domain?array<string>
source?array<string>
exclude_source?array<string>
organization_industry?array<string>
exclude_organization_industry?array<string>
organization_slug?array<string>
exclude_organization_slug?array<string>
organization_headcount_gte?integer
organization_headcount_lt?integer
organization_size?array<>
organization_funding_gte?integer
Formatint64
organization_funding_lt?integer
Formatint64
ai_experience_level?array<>
ai_work_arrangement?array<>
ai_employment_type?array<>
ai_language?array<>

Filter by the AI-detected language of the job description. Matches the ai_job_language response field. Input a comma-separated list.

ai_education?array<>
ai_taxonomies_a_primary?array<>
ai_taxonomies_a?array<>
exclude_ai_taxonomies_a?array<>
ai_visa_sponsorship?string
Value in"only""exclude"
has_salary?boolean
has_no_location?boolean
organization_agency?string
Value in"only""exclude"
date_posted_gte?string
Formatdate-time
date_posted_lt?string
Formatdate-time
date_created_gte?string
Formatdate-time
date_created_lt?string
Formatdate-time

Response Body

Total count of matching ATS listings

application/json

Total count of listings matching the filter set in the selected time window. Returned by /active-ats-count and /active-jb-count.

application/json response fields: response
FieldTypeDescription
count*
integer

Number of listings matching the supplied filters in the selected time_frame.

Format int64
Range 0 <= value
Example Request
curl --fail-with-body --silent --show-error 'https://data.fantastic.jobs/v1/active-ats-count?time_frame=1m' \  --header "Authorization: Bearer ${FANTASTIC_JOBS_API_KEY:?Set FANTASTIC_JOBS_API_KEY}"
Example Response
{  "count": 0}