Expired job board jobs

Parameters, response schema, and authenticated examples for /v1/expired-jb.

Expired job board jobs

GET
/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.

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 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).
Default"1d"
Value in"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
application/json response fields: response
FieldTypeDescription
[index: integer]?
ExpiredJbJobId

Internal ID of an expired job board listing, returned as an item by /expired-jb. Match against ActiveJbJob.id to expire stale rows in your store. Only LinkedIn (source=linkedin) listings are re-checked for expiration; IDs from other JB sources (wellfound, ycombinator) will never appear in this feed.

Format int64
Example Request
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}"
Example Response
[  0]