Executing a job search

Request with tokens

The endpoint /jobboards/{channelID}/jobs allows for search operations.

with TOKEN being either a client access token or a user access token and {channelID} corresponding to the desired channel. The other two query parameters define the search. They may be empty respectively left out. When using a geolocation to limit the result, please take notice of the following. The geolocation refers to the position, not to the job advertisement rubrification. And of course the geolocation has to be set in the positions data.

The system will attempt to localize the search’s results, the locale is extracted from the header. In the curl example you can manipulate the header by adding -H “Accept-Language:{locale}”, whereat locale can be en, de and so on.

Request with basic authorization

As an alternative, you can use here the basic authorization method. Just write

{clientId} is the ID for your application to develop given to you by softgarden. The colon seen in the example is obligatory.

Path parameters

Path parameters

Name Description Data Type
channelID ID of the channel to search through. String

Query parameters

Name Description Data Type Default Value
search A string with the search content. String empty string
geoLocation Demanded geographic location, format ‘LatitudeAsRealNumber::LongitudeAsRealNumber::DistanceInKilometers‘. For more information see Wikipedia or a a tool for determining such a geotag. An example would be 52.520014::13.373006::50 for a radius of 50 kilometers around the German Bundestag building in Berlin. String empty string

Response values

Upon Returned value Description
success JSON-encoded JobSearchResult-object Results of the search.
failure 500 – INTERNAL SERVER ERROR When an error appears while processing your request.
authorization error 401 / 403 See here for details.

Example return value:


Comments are closed.