Skip to main content
POST
Rolling out. The Historical Jobs endpoints are documented ahead of release and may not be live on api.hirebase.org yet. If you get a 404 or 405, the rollout has not reached production; check the changelog or email hello@hirebase.org and we will let you know when it is available.
Export every archived job matching a filter set as a downloadable file. Pass the same filters you refined with Historical Jobs Search; the export bills exactly the count that endpoint showed. Historical exports are purchased per dataset, not drawn from your monthly Jobs allowance. The response contains a Stripe Checkout link and the id of the task the export will run under. Nothing runs, and nothing is charged, until payment completes.
This endpoint requires an API key. See Authentication.

​
Pricing

The price is a function of the number of records, quoted before you pay and never higher than the quote. Minimum charge 0.50.Examples:500records→0.50. Examples: 500 records → 60; 3,096 records → 182.88;20,000records→182.88; 20,000 records → 490; 150,000 records → $1,340. If the export fails after payment, the charge is refunded automatically.

​
Request Body

​
object
required
The filter set. Same fields and rules as Historical Jobs Search: job_titles, keywords, geo_locations, location_group, company_names, company_slugs, date_posted_from, date_posted_to, date_expired_from, date_expired_to. At least one filter is required; unknown keys return 422.
​
string
default:"json"
json (JSON Lines: one record per line) or csv.
​
integer
Cap the export at this many records, most recently posted first. Omit to export every match. Priced at min(limit, match count).
​
string
Where to send the buyer after Checkout. Defaults to the historical jobs guide.

​
Response

​
string
The task the export runs under once paid. Poll GET /v2/tasks/{task_id}; it returns 404 until payment completes.
​
string
Stripe Checkout URL. Open it (or send it to whoever holds the card) to pay.
​
integer
Records the export will contain.
​
number
Total price in USD.
​
string
Always awaiting_payment at this point.

​
After payment

The export task is created immediately on payment. When it finishes, the task’s result carries download_url (private link, valid 30 days), file_size and record_count, and an email with the same link goes to your account address.

​
Exported record fields

Each record is the full archived job object: _id, job_title, job_title_raw, company_name, company_slug, company_data, locations, location_type, date_posted, date_expired, job_categories, job_type, experience_level, yoe_range, salary_range, skills, technologies, benefits, education_level, requirements_summary, visa_sponsored, application_link, job_board, md5_hash, and description where still retained (see the coverage table on the search page).
Multi-location postings appear once per location. To collapse them, group on company_slug + job_title + date_posted (or on md5_hash) on your side.