JobSearch

https://jobsearch.api.jobtechdev.se/
Admin
JobSearch is an API for searching current job ads from the Swedish Public Employment Service, used...
Tokens:3,961
Snippets:13
Trust Score:8.4
Update:3 months ago
Show doc for...
Tokens:
Raw
### GET /complete

Source: https://jobsearch.api.jobtechdev.se

Provides auto-completion suggestions, likely for search queries.

```APIDOC
## GET /complete

### Description
Provides auto-completion suggestions, likely for search queries.

### Method
GET

### Endpoint
/complete
```

--------------------------------

### GET /search

Source: https://jobsearch.api.jobtechdev.se

Searches for job ads based on various criteria.

```APIDOC
## GET /search

### Description
Searches for job ads based on various criteria.

### Method
GET

### Endpoint
/search
```

--------------------------------

### Get Job Ad Logo by ID

Source: https://jobsearch.api.jobtechdev.se/swagger.json

Retrieves the binary file for a job ad's logo using the job ad's ID.

```APIDOC
## GET /ad/{id}/logo

### Description
Load a logo binary file by ID.

### Method
GET

### Endpoint
/ad/{id}/logo

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the job ad.

### Response
#### Success Response (200)
- **(binary file)** - The logo binary file.

#### Error Response (404)
- **description**: Job ad not found
```

--------------------------------

### GET /ad/{id}

Source: https://jobsearch.api.jobtechdev.se

Retrieves a specific job ad by its unique identifier.

```APIDOC
## GET /ad/{id}

### Description
Retrieves a specific job ad by its unique identifier.

### Method
GET

### Endpoint
/ad/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the job ad.
```

--------------------------------

### GET /search

Source: https://jobsearch.api.jobtechdev.se/swagger.json

Performs a search for job advertisements based on specified criteria. This endpoint allows for freetext searching in ad headlines, descriptions, and employer names, with options to refine the search fields and filter by various attributes.

```APIDOC
## GET /search

### Description
Performs a search for job advertisements based on specified criteria. This endpoint allows for freetext searching in ad headlines, descriptions, and employer names, with options to refine the search fields and filter by various attributes.

### Method
GET

### Endpoint
/search

### Parameters
#### Query Parameters
- **q** (string) - Optional - Search in ad headline, ad description and employer name
- **qfields** (array of strings) - Optional - Fields to freetext search in, in addition to default freetext search (parameter q). Valid input values: ['occupation', 'skill', 'trait', 'location', 'employer']. Default (no input): Search in ad headline, ad description and employer name
- **duration** (array of strings) - Optional - One or more employment-duration codes, code according to the taxonomy
- **limit** (integer) - Optional - Maximum number of results to return. Minimum 0, maximum 50. Default: 5
- **contextual** (boolean) - Optional - Set to False to disable contextual typeahead (default: True)
- **label** (array of strings) - Optional
- **published-before** (string) - Optional - Fetch job ads published before specified date and time (format YYYY-mm-ddTHH:MM:SS) or number of minutes.
- **published-after** (string) - Optional - Fetch job ads published after specified date and time. Accepts either datetime (format YYYY-mm-ddTHH:MM:SS) or number of minutes (e.g 60 means published in the last hour)
- **occupation-name** (array of strings) - Optional - One or more occupational codes according to the taxonomy
- **occupation-group** (array of strings) - Optional - One or more occupational group codes according to the taxonomy
- **occupation-field** (array of strings) - Optional - One or more occupational area codes according to the taxonomy
- **occupation-collection** (array of strings) - Optional - One or more occupational collections according to the taxonomy

#### Header Parameters
- **x-feature-freetext-bool-method** (string) - Optional - Boolean method to use for unclassified freetext words. Defaults to "or". Valid values: ['and', 'or']
- **x-feature-disable-smart-freetext** (boolean) - Optional - Disables machine learning enriched queries. Freetext becomes traditional freetext query according to the setting of "x-feature-freetext-bool-method"
- **x-feature-enable-false-negative** (boolean) - Optional - Enables extra search for the current known term in free text to avoid false negatives
- **X-Fields** (string) - Optional - An optional fields mask

### Response
#### Success Response (200)
- **description**: Success
- **schema**: #/definitions/SearchResults
```

--------------------------------

### GET /ad/{id}/logo

Source: https://jobsearch.api.jobtechdev.se

Retrieves the logo associated with a specific job ad.

```APIDOC
## GET /ad/{id}/logo

### Description
Retrieves the logo associated with a specific job ad.

### Method
GET

### Endpoint
/ad/{id}/logo

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the job ad.
```

--------------------------------

### Search Job Ads

Source: https://jobsearch.api.jobtechdev.se/swagger.json

This endpoint allows you to search for job ads. You can specify search terms, fields to search within, employment durations, relevance thresholds, result details, pagination, sorting, and statistics.

```APIDOC
## GET /jobs

### Description
Searches for job ads based on specified criteria.

### Method
GET

### Endpoint
/jobs

### Parameters
#### Query Parameters
- **q** (string) - Required - Freely searchable text. Searches in ad headline, ad description and employer name by default.
- **qfields** (array of strings) - Optional - Fields to freetext search in, in addition to default freetext search (parameter q). Valid input values: ['occupation', 'skill', 'trait', 'location', 'employer']. Default: Search in ad headline, ad description and employer name.
- **duration** (array of strings) - Optional - One or more employment-duration codes, code according to the taxonomy.
- **relevance-threshold** (number) - Optional - Set a result relevance threshold between 0 and 1.
- **resdet** (string) - Optional - Show 'full' (default) or 'brief' results details. Valid input values: ['full', 'brief'].
- **offset** (integer) - Optional - The offset parameter defines the offset from the first result you want to fetch. Valid range is (0-2000). Default: 0.
- **limit** (integer) - Optional - Number of results to fetch. Valid range is (0-100). Default: 10.
- **sort** (string) - Optional - Sorting criteria. Valid input values: ['relevance', 'pubdate-desc', 'pubdate-asc', 'applydate-desc', 'applydate-asc', 'updated', 'id'].
- **stats** (array of strings) - Optional - Show statistics for specified fields. Available fields: ['occupation-name', 'occupation-group', 'occupation-field', 'country', 'municipality', 'region'].
- **stats.limit** (integer) - Optional - Maximum number of statistical rows per field. Valid range is (0-30).
- **label** (array of strings) - Optional - One or more label strings, to filter ads by label.

#### Header Parameters
- **X-Fields** (string) - Optional - An optional fields mask.

### Response
#### Success Response (200)
- **total** (object) - Total number of hits.
- **positions** (integer) - Number of positions.
- **query_time_in_millis** (integer) - Query time in milliseconds.
- **result_time_in_millis** (integer) - Result time in milliseconds.
- **stats** (array of objects) - Statistics for specified fields.
- **freetext_concepts** (object) - Freetext concepts found.
- **hits** (array of objects) - Array of job ad search results.

### Request Example
```json
{
  "q": "developer",
  "limit": 20,
  "sort": "pubdate-desc"
}
```

### Response Example
```json
{
  "total": {
    "value": 1500
  },
  "positions": 20,
  "query_time_in_millis": 50,
  "result_time_in_millis": 30,
  "stats": [
    {
      "type": "occupation-name",
      "values": [
        {
          "term": "Software developer",
          "count": 500
        }
      ]
    }
  ],
  "freetext_concepts": {
    "skill": ["Java", "Python"]
  },
  "hits": [
    {
      "ad_id": "12345",
      "headline": "Senior Software Developer",
      "description": "...",
      "employer_name": "Tech Corp",
      "published_date": "2023-10-27T10:00:00Z",
      "application_deadline": "2023-11-30T23:59:59Z"
    }
  ]
}
```
```

--------------------------------

### Typeahead / Suggest Searchword

Source: https://jobsearch.api.jobtechdev.se/swagger.json

Provides search suggestions or typeahead completions for search queries.

```APIDOC
## GET /complete

### Description
Typeahead / Suggest next searchword.

### Method
GET

### Endpoint
/complete

### Parameters
#### Query Parameters
- **published-before** (string) - Optional - Fetch job ads published before specified date and time (format YYYY-mm-ddTHH:MM:SS) or number of minutes.
- **published-after** (string) - Optional - Fetch job ads published after specified date and time. Accepts either datetime (format YYYY-mm-ddTHH:MM:SS) or number of minutes (e.g 60 means published in the last hour).
- **occupation-name** (array of strings) - Optional - One or more occupational codes according to the taxonomy.
- **occupation-group** (array of strings) - Optional - One or more occupational group codes according to the taxonomy.
- **occupation-field** (array of strings) - Optional - One or more occupational area codes according to the taxonomy.
- **occupation-collection** (array of strings) - Optional - One or more occupational collections according to the taxonomy.

#### Headers
- **x-feature-freetext-bool-method** (string) - Optional - Boolean method to use for unclassified freetext words. Defaults to "or". Enum: ["and", "or"]
- **x-feature-disable-smart-freetext** (boolean) - Optional - Disables machine learning enriched queries. Freetext becomes traditional freetext query according to the setting of "x-feature-freetext-bool-method".
- **x-feature-enable-false-negative** (boolean) - Optional - Enables extra search for the current known term in free text to avoid false negatives.

### Response
#### Success Response (200)
- **(TypeaheadResults)** - Description of the typeahead results.
```

--------------------------------

### Search Jobs

Source: https://jobsearch.api.jobtechdev.se/swagger.json

Allows users to search for job listings with a wide range of filtering options. This endpoint is designed to be flexible for various job search criteria.

```APIDOC
## GET /jobs

### Description
Searches for job listings based on a variety of criteria including skills, location, employment type, and more.

### Method
GET

### Endpoint
/jobs

### Parameters
#### Query Parameters
- **occupation** (array) - Optional - Excludes not matching occupations, groups, fields
- **skill** (array) - Optional - One or more competency codes according to the taxonomy
- **language** (array) - Optional - One or more language codes according to the taxonomy
- **worktime-extent** (array) - Optional - One or more codes for worktime extent, code according to the taxonomy
- **parttime.min** (number) - Optional - For part-time jobs, minimum extent in percent (for example 50 for 50%)
- **parttime.max** (number) - Optional - For part-time jobs, maximum extent in percent (for example 100 for 100%)
- **driving-license-required** (boolean) - Optional - Set to true if driving licence required, false if not
- **driving-license** (array) - Optional - One or more types of demanded driving licenses, code according to the taxonomy
- **employment-type** (array) - Optional - Employment type, code according to the taxonomy
- **experience** (boolean) - Optional - Input 'false' to filter jobs that don't require experience
- **municipality** (array) - Optional - One or more municipality codes, code according to the taxonomy
- **region** (array) - Optional - One or more region codes, code according to the taxonomy
- **country** (array) - Optional - One or more country codes, code according to the taxonomy
- **unspecified-sweden-workplace** (boolean) - Optional - True will return all ads with unspecified workplace in Sweden. False does nothing
- **abroad** (boolean) - Optional - True will return ads for work outside of Sweden even when searching for places matching Swedish municipality/region/country. False does nothing
- **remote** (boolean) - Optional - True will return ads which are likely to allow remote work based on phrase matching, False will only return ads that do not match these phrases
- **open_for_all** (boolean) - Optional - True will return all ads matching the phrase 'Öppen för alla'
- **trainee** (boolean) - Optional - True will return ads which are likely to allow trainee work based on phrase matching, False will only return ads that do not match these phrases
- **larling** (boolean) - Optional - True will return ads which are likely to allow larling work based on phrase matching, False will only return ads that do not match these phrases
- **franchise** (boolean) - Optional - True will return ads which are likely to allow franchise work based on phrase matching, False will only return ads that do not match these phrases
- **hire-work-place** (boolean) - Optional - True will return ads which are likely concern rental of a place / chair to work from based on phrase matching, False will only return ads that do not match these phrases
- **position** (array) - Optional - Latitude and longitude in the format "59.329,18.068" (latitude,longitude)
- **position.radius** (array) - Optional - Radius from the specified position (latitude,longitude) in kilometers (km)
- **employer** (array) - Optional - Name or organisation number (numbers only, no dashes or spaces) of employer
- **q** (string) - Optional - Freetext query.
```

--------------------------------

### Search Jobs

Source: https://jobsearch.api.jobtechdev.se/swagger.json

Allows searching for job postings with a wide range of filtering options. You can filter by occupation, skills, languages, work location, employment type, experience requirements, and more.

```APIDOC
## GET /jobs

### Description
Searches for job postings based on various criteria.

### Method
GET

### Endpoint
/jobs

### Parameters
#### Query Parameters
- **occupation** (array) - Optional - Excludes not matching occupations, groups, fields
- **skill** (array) - Optional - One or more competency codes according to the taxonomy
- **language** (array) - Optional - One or more language codes according to the taxonomy
- **worktime-extent** (array) - Optional - One or more codes for worktime extent, code according to the taxonomy
- **parttime.min** (number) - Optional - For part-time jobs, minimum extent in percent (for example 50 for 50%)
- **parttime.max** (number) - Optional - For part-time jobs, maximum extent in percent (for example 100 for 100%)
- **driving-license-required** (boolean) - Optional - Set to true if driving licence required, false if not
- **driving-license** (array) - Optional - One or more types of demanded driving licenses, code according to the taxonomy
- **employment-type** (array) - Optional - Employment type, code according to the taxonomy
- **experience** (boolean) - Optional - Input 'false' to filter jobs that don't require experience
- **municipality** (array) - Optional - One or more municipality codes, code according to the taxonomy
- **region** (array) - Optional - One or more region codes, code according to the taxonomy
- **country** (array) - Optional - One or more country codes, code according to the taxonomy
- **unspecified-sweden-workplace** (boolean) - Optional - True will return all ads with unspecified workplace in Sweden. False does nothing
- **abroad** (boolean) - Optional - True will return ads for work outside of Sweden even when searching for places matching Swedish municipality/region/country. False does nothing
- **remote** (boolean) - Optional - True will return ads which are likely to allow remote work based on phrase matching, False will only return ads that do not match these phrases
- **open_for_all** (boolean) - Optional - True will return all ads matching the phrase 'Öppen för alla'
- **trainee** (boolean) - Optional - True will return ads which are likely to allow trainee work based on phrase matching, False will only return ads that do not match these phrases
- **larling** (boolean) - Optional - True will return ads which are likely to allow larling work based on phrase matching, False will only return ads that do not match these phrases
- **franchise** (boolean) - Optional - True will return ads which are likely to allow franchise work based on phrase matching, False will only return ads that do not match these phrases
- **hire-work-place** (boolean) - Optional - True will return ads which are likely concern rental of a place / chair to work from based on phrase matching, False will only return ads that do not match these phrases
- **position** (array) - Optional - Latitude and longitude in the format "59.329,18.068" (latitude,longitude)
- **position.radius** (array) - Optional - Radius from the specified position (latitude,longitude) in kilometers (km)
- **employer** (array) - Optional - Name or organisation number (numbers only, no dashes or spaces) of employer
- **q** (string) - Optional - Freetext query.
```
Tokens:
Raw