Job board jobs count
Parameters, response schema, and authenticated examples for /v1/active-jb-count.
BetaReturns the total count of job board 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-jb 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-jb. 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-jb with the exception of parameters that are not relevant for count (description_format, exclude_recruiter_fields, employment_type (raw), id, limit, offset, cursor).
description / description_advanced are not available for time_frame=6m.
bearerAuthAuthorizationBearer <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.
time_frame?stringTime window to count. Defaults to 1m.
1h,24h,7d,6m- count currently active listings only, so the number matches what/active-jbwould 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 no1mwindow 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.
"1m""1h""24h""7d""1m""6m"title?stringtitle_advanced?stringdescription?stringdescription_advanced?stringlocation?stringlocation_advanced?stringorganization?array<string>exclude_organization?array<string>organization_advanced?stringsource?array<>exclude_source?array<>seniority?array<string>organization_industry?array<string>exclude_organization_industry?array<string>organization_slug?array<string>exclude_organization_slug?array<string>organization_headcount_gte?integerorganization_headcount_lt?integerorganization_size?array<>ai_employment_type?array<>ai_experience_level?array<>ai_work_arrangement?array<>ai_education?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_taxonomies_a_primary?array<>ai_taxonomies_a?array<>exclude_ai_taxonomies_a?array<>ai_visa_sponsorship?string"only""exclude"has_salary?booleanhas_no_location?booleanorganization_agency?string"only""exclude"direct_apply?string"only""exclude"exclude_ats_duplicate?booleanlinkedin_id?array<>date_posted_gte?stringdate-timedate_posted_lt?stringdate-timedate_created_gte?stringdate-timedate_created_lt?stringdate-timeResponse Body
Total count of matching job board listings
application/jsonTotal count of listings matching the filter set in the selected time window. Returned by /active-ats-count and /active-jb-count.
| Field | Type | Description |
|---|---|---|
count* | integer | Number of listings matching the supplied filters in the selected Format int64 Range 0 <= value |
curl --fail-with-body --silent --show-error 'https://data.fantastic.jobs/v1/active-jb-count?time_frame=1m' \ --header "Authorization: Bearer ${FANTASTIC_JOBS_API_KEY:?Set FANTASTIC_JOBS_API_KEY}"{ "count": 0}