Export Jobs

Export job search results using the same search parameters as /v2/jobs/search, but save the result as a downloadable file. This endpoint creates a task and returns its status and identifier. The user can poll the task using the Get Task Status endpoint.

Endpoint

POST /v2/jobs/export

Request Body

Note:

While some top-level request fields are required (such as search), the attributes within those fields are optional. You can include only the filters you need, for example, specifying just job_titles inside search is valid.
Filter combinations can be mixed and matched.
Use specific filters to narrow down search results and get relevant matches.

object

Parameters used to filter job search results

Show child attributes

job_titles

string[]

Array of job titles to search for

keywords

string[]

Array of keywords to match in job descriptions

job_board

string

Filter by the source job board (e.g., “iCIMS”, “Lever”, “Greenhouse”).

job_slug

string

Filter by the unique job slug (used for deep linking or targeting specific jobs).

location_group

string

Predefined geographic area (e.g., “Bay_Area”)

location_types

string[]

Array of work arrangements (e.g., “Remote”, “Hybrid”, “On-site”, “In-Person”)

locations

object[]

Array of location objects with city, region, and country

Show child attributes

city

string

City name

region

string

State, region, or province

country

string

Country name

experience

string[]

Array of experience levels (e.g., “Entry”, “Mid”, “Senior”)

yoe

object

Years of experience range object

Show child attributes

min

number

Minimum years of experience

max

number

Maximum years of experience

company_name

string

Filter by specific company name

company_slug

string

Filter by the unique company slug (used for deep linking or specific company targeting).

salary

object

Salary range object

Show child attributes

min

number

Minimum salary

max

number

Maximum salary

job_type

string[]

Array of job types (e.g., “Full Time”, “Contract”)

industry

string[]

Filter by industry sector. Can be a single string or an array of strings.

sub_industry

string[]

Filter by more specific industry category. Can be a single string or an array of strings.

date_posted

string

The date when the job was posted. Format: YYYY-MM-DD

visa

string

Filter for jobs that offer visa sponsorship (“true” or “false”)

sort_by

string

Field to sort results by (e.g., “relevance”, “date posted”, “salary”)

sort_order

string

Sort direction (“asc” or “desc”)

currency

string

Currency code for salary filtering (e.g., “USD”, “EUR”).

days_ago

number

Filter jobs posted within the last specified number of days.

include_expired

string

Whether to include expired job listings in the results (“true” or “false”).

include_no_salary

string

Whether to include jobs that do not specify a salary (“true” or “false”).

include_yoe

string

Whether to include jobs without explicit years of experience data (“true” or “false”).

month

string

Filter jobs posted in a specific month. Format: YYYY-MM (e.g., “2024-06”).

page

number

default:"1"

Page number for pagination

limit

number

default:"10"

Number of results per page

Note:The pagination (page and limit) fields control the number of results returned and which subset of results is displayed.

format

string

required

Export file format (csv, or json)

Response

Returns a task object representing the export job.

string

Unique task ID

Note:Use this task ID to check the export status using the Get Task Status endpoint and download the result once it’s ready.

type

string

Type of the task, always "export_job_data" for this endpoint

state

string

Current state of the task (queued, processing, finished, failed, canceled)

progress

number

Task progress as a float between 0.0 and 1.0

created_at

string

ISO timestamp of task creation

updated_at

string

ISO timestamp of last update

started_at

string

ISO timestamp of when the task started, or null

completed_at

string

ISO timestamp of when the task completed, or null

user_id

string

ID of the user who initiated the task

error

string

Error message if the task failed, otherwise null

worker_id

string

ID of the worker that processed the task, or null

priority

integer

Task priority level (higher means more urgent)

input

object

Task input payload, including the search query and export format

result

object

Present only when the task is complete

Show child attributes

download_url

string

URL to download the exported file

file_size

integer

File size in bytes

record_count

integer

Total number of jobs exported

expiry_time

string

ISO timestamp when the download URL will expire

format

string

Format of the exported file (e.g., json, csv).

Example Request

{
    "search": {
  "job_titles": ["Site/Civil Engineer"],
  "geo_locations": [{"city": "Richmond", "region": "Virginia", "country": "United States"}],
  "yoe": {"min": 1, "max": 6},
  "company_name": "CompanyXYZ",
  "job_types": ["Full-time"],
  "industry": ["Design", "Construction"],
  "sub_industry": ["Architecture", "Building Construction"],
  "visa": "true",
  "sort_by": "relevance",
  "sort_order": "desc",
  "page": 1,
  "limit": 10
},
  "format": "json"
}

Example Response

{
    "id": "7700n868-05b7-4763-af74-e2c789c3260d",
    "type": "export_job_data",
    "state": "queued",
    "progress": 0.0,
    "created_at": "2025-06-13T06:10:07.605259",
    "updated_at": "2025-06-13T06:10:07.605260",
    "started_at": null,
    "completed_at": null,
    "user_id": "27893d278da3e42f2878gh90",
    "error": null,
    "worker_id": null,
    "priority": 0,
    "input": {
        "query": {
            "job_titles": [
                "Site/Civil Engineer"
            ],
            "keywords": null,
            "location_group": null,
            "location_types": [
                "In-Person"
            ],
            "geo_locations": [
                {
                    "city": "Richmond",
                    "region": "Virginia",
                    "country": "United States"
                }
            ],
            "experience": null,
            "yoe": {
                "min": 1.0,
                "max": 6.0
            },
            "include_yoe": null,
            "company_types": null,
            "company_name": "CompanyXYZ",
            "date_posted": null,
            "days_ago": null,
            "month": null,
            "salary": null,
            "include_no_salary": null,
            "currency": null,
            "job_types": [
                "Full-time"
            ],
            "job_category": null,
            "industry": [
                "Design",
                "Construction"
            ],
            "sub_industry": [
                "Architecture",
                "Building Construction"
            ],
            "visa": "false",
            "include_expired": null,
            "hide_seen_jobs": null,
            "user_id": null,
            "company_slug": null,
            "job_slug": null,
            "job_board": null,
            "sort_by": "relevance",
            "sort_order": "desc",
            "page": 1,
            "limit": 10
        },
        "format": "json"
    },
    "result": null
}

Error Responses

401 Unauthorized

Returns when the API key is missing, invalid, or incorrect.

403 Forbidden

Returns when your account does not have permission to access the requested feature.

This usually means the feature is restricted to certain subscription tiers.

422 Unprocessable Entity Error

Returns when the request contains invalid or improperly formatted data.

Occurs when the industry field is missing, not a string, or doesn’t match any value from the list of valid industries.
Can also be returned if sub_industry is not a valid string from the list of allowed sub-industries.
May result from JSON decoding errors, such as malformed JSON or incorrect data types in the request body.

500 Internal Server Error

Returns when an unexpected error occurs on the server.

Also occurs during unhandled server-side failures or bugs that prevent the request from being processed.

Jobs API

Companies API

Resume (Embeddings) API

Tasks API

Error Handling

Endpoint

Request Body

Response

Example Request

Example Response

Error Responses

Jobs API

Companies API

Resume (Embeddings) API

Tasks API

Error Handling

​Endpoint

​Request Body

​Response

​Example Request

​Example Response

​Error Responses

Endpoint

Request Body

Response

Example Request

Example Response

Error Responses