Expired job board jobs
Parameters, response schema, and authenticated examples for /v1/expired-jb.
Returns a feed of job board listings that have expired within the selected time window. Use the time_frame parameter to select 1h, 1d, 1m, or 6m.
Coverage: Expiration is only tracked for LinkedIn listings (source=linkedin). Other job board sources (wellfound, ycombinator) are not re-checked for expiration, so this feed will never return their IDs.
Warning: The '1m' and '6m' feeds can be very large. Retrieve them with a server-side client rather than relying on an in-browser response preview.
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 for expired job board listings.
1h- rolling window of listings that expired in the last hour. Refreshed continuously.1d- daily snapshot of expirations from the previous UTC day. Refreshed once per day at 01:00 UTC; this is the most common choice for daily syncs. Despite the name this is not a rolling 24-hour window.1m- monthly window of listings that expired during the last 31 days.6m- full 6-month backfill of expirations (very large feed).
"1d""1h""1d""1m""6m"Response Body
A JSON array of internal IDs for job board listings that expired in the selected window. Match each ID against ActiveJbJob.id to expire stale rows in your store.
application/json| Field | Type | Description |
|---|---|---|
[index: integer]? | ExpiredJbJobId | Internal ID of an expired job board listing, returned as an item by Format int64 |
curl --fail-with-body --silent --show-error 'https://data.fantastic.jobs/v1/expired-jb?time_frame=1d' \ --header "Authorization: Bearer ${FANTASTIC_JOBS_API_KEY:?Set FANTASTIC_JOBS_API_KEY}"[ 0]