Search

Search for jobs

POST/job/search

Authorization

ApiKeyAuth

Body

application/json

qstring

Search query for job titles, descriptions, or organization names. Supports fuzziness and boosting.

Example: "Software Engineer"

sizeinteger

Number of results to return. Defaults to 50.

Example: 50

frominteger

Offset for pagination. Defaults to 0.

Example: 0

sort_bystring

Field to sort by. Defaults to creation_date.

Example: "creation_date"

sort_orderenum

Sort order. Defaults to desc.

Example: "desc"

ascdesc

creation_datestring (date-time)

Filter jobs by their creation date. Accepts either a specific date or a full datetime.

Example: "2025-01-14"

published_sincestring (date-time)

Filter for jobs published since the specified date.

Example: "2024-03-20T00:00:00.000Z"

published_onstring (date-time)

Filter for jobs published on a specific date. Accepts either a specific date or a datetime range.

Example: "2024-03-20T00:00:00.000Z"

titlestring

Filter jobs by title.

Example: "Data Scientist"

hiring_organization_namestring

Filter jobs by the hiring organization's name. Comma-separated for multiple organizations.

Example: "Google,Amazon"

countrystring

Filter jobs by country. Comma-separated for multiple countries.

Example: "Canada,France"

employment_typestring

Filter jobs by employment type. Accepted values include open text, or standardized employment types (e.g., "FULL_TIME", "PART_TIME", "INTERNSHIP", etc.).

Example: "FULL_TIME"

languagestring

Filter jobs by language.

Example: "English"

industrystring

Filter jobs by industry. Comma-separated for multiple industries.

Example: "Technology,Healthcare"

occupational_categorystring

Filter jobs by occupational category. Comma-separated for multiple categories.

Example: "IT,Engineering"

domainstring

Filter jobs by domain. Comma-separated for multiple domains.

Example: "www.linkedin.com,fr.indeed.com"

facetsarray of string

Specify fields for faceted search. Aggregates results by the specified fields.

Example: ["employment_type","country"]

Response

200400401500

Search results with matching jobs and facets.

Body

application/json

okboolean

Indicates if the operation was successful.

Example: true

hitsarray of object

facetsobject

totalinteger

Total number of search results.

Example: 100

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/job/search', {
    method: 'POST',
    headers: {
      "apikey": "ApiKeyAuth <apiKey>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "q": "Software Engineer",
      "size": 50,
      "from": 0,
      "sort_by": "creation_date",
      "sort_order": "desc",
      "creation_date": "2025-01-14",
      "published_since": "2024-03-20T00:00:00.000Z",
      "published_on": "2024-03-20T00:00:00.000Z",
      "title": "Data Scientist",
      "hiring_organization_name": "Google,Amazon",
      "country": "Canada,France",
      "employment_type": "FULL_TIME",
      "language": "English",
      "industry": "Technology,Healthcare",
      "occupational_category": "IT,Engineering",
      "domain": "www.linkedin.com,fr.indeed.com",
      "facets": [
        "employment_type",
        "country"
      ]
    }),
});
const data = await response.json();

Response

200400

{
  "ok": true,
  "hits": [
    {
      "id": "text",
      "title": "text",
      "description": "text",
      "employment_type": "text",
      "hiring_organization_name": "text",
      "country": "text",
      "language": "text",
      "other_fields": {
        "ANY_ADDITIONAL_PROPERTY": null
      }
    }
  ],
  "facets": {
    "ANY_ADDITIONAL_PROPERTY": [
      {
        "key": "text",
        "doc_count": 1
      }
    ]
  },
  "total": 100
}