get/offer/{offerId}

Returns the detail of the offer identified by the {offerId} provided in the URL.


Request

Resource URL

https://api.infojobs.net/api/1/offer/{offerId}

Security

  • User Role: public
  • Scope: none

Parameters

Name Description

offerId

Required

String

Identifier of the offer.

Example values: eb371a01c14f97838d790d19d606ce

Maximum length: 100

Response

Response fields

Fields related to Offer entity
Name Description

id

String

The Offer unique identifier.

Maximum length: 100

title

String

Title of the offer.

Maximum length: 150

category

DictionaryItem

The job offer category. The operation /dictionary/category returns all the allowed values.

subcategories

List(DictionaryItem)

The job offer subcategories. The operation /dictionary/subcategory returns all available values.

link

String

URL of the offer published at Infojobs portal.

Maximum length: 1000

city

String

Name of the city where the job is offered. It's an open field, and can be filled with anything.

Maximum length: 200

cityPD

DictionaryItem

The city where the job is offered, identified in our list of cities. The operation /dictionary/city returns all available values.

province

DictionaryItem

The job offer province. The operation /dictionary/province returns all available values.

zipCode

String

The job offer zip code.

Maximum length: 10

description

String

The job offer full description.

Maximum length: 3500

profile

Profile

The company that publishes the offer.

creationDate

 

Date

Date of job offer's creation.

updateDate

 

Date

Date of job offer's last modification.

applications

Long

Number of applications received for the job post.

upsellings

Upselling

Characteristics of job offer to highlight it over others. (Bold, urgent, ...)

showPay

Boolean

true if the pay data is filled, false otherwise.

minPay

Pay

Minimum value of the job offer salary range.

maxPay

Pay

Maximum value of the job offer salary range.

contractType

DictionaryItem

Contract type of the job offer. The operation /dictionary/contract-type returns all available values.

journey

DictionaryItem

The job offer working day type. The operation /dictionary/workday returns all available values.

studiesMin

DictionaryItem

Level of education of the job seeker (Bachelor's degree, Masters, etc.). The operation /dictionary/study returns all available values.

experienceMin

DictionaryItem

Minimum required experience to be considered for the job. The operation /dictionary/experience-min returns all available values.

minRequirements

String

Minimum required skills for the job post.

Maximum length: 2500

desiredRequirements

String

Desired skills for the job post.

Maximum length: 2500

state

Integer

Current offer state.

externalUrlForm

String

If it's not empty, the application to this job offer must be done in the given url.

Maximum length: 225

residence

DictionaryItem

Indicates if required residence somewhere. (Province of vacancy, country of vacancy, etc..)

country

DictionaryItem

The job offer country. The operation /dictionary/country returns all available values.

exactLocation

Boolean

true if the job offer has informed exact latitude an longitude, false otherwise. If false, longitude and latitute are tried to be calculated from the city.

latitude

Double

The job offer latitude.

longitude

Double

The job offer longitude.

department

String

The job offer department.

Maximum length: 100

vacancies

Integer

The number of vacancies in the job offer.

commissions

String

The job offer commissions.

Maximum length: 50

referenceId

String

The job offer reference.

Maximum length: 100

contractDuration

String

The job offer contract duration.

Maximum length: 50

detailedStudiesId

Long

The job offer minimum speciality of study required.

studying

Boolean

true if the job admits people who is studying the specialty informed, false otherwise.

schedule

String

The working hours needed for the job offer.

Maximum length: 100

jobLevel

DictionaryItem

Type of job (trainee, employee, management...). The operation /dictionary/employer-type returns all available values.

staffInCharge

DictionaryItem

Amount of direct or indirect reports to the position. Range.

hasKillerQuestions

Boolean

true if the job offer has prescreening questions with predefined answers, false otherwise.

hasOpenQuestions

Boolean

true if the job offer has prescreening questions with open answers, false otherwise.

active

Boolean

true if the job offer is active and fully functional, false otherwise.

archived

Boolean

true if the job offer has archived, and it's not available for apply. false otherwise.

deleted

Boolean

true if the job offer is deleted, false otherwise.

availableForVisualization

Boolean

true if the job offer is available for display, false otherwise.

disponibleForFullVisualization

Boolean

true if the job offer is available for display and for apply, false otherwise.

Fields related to Profile entity
Name Description

id

String

The company unique identifier.

Maximum length: 40

name

String

The company name.

Maximum length: 100

description

String

Detailed description about the company.

Maximum length: 4000

zipCode

String

The company zip code.

Maximum length: 10

city

String

The company city.

Maximum length: 50

province

DictionaryItem

The company province. The operation /dictionary/province returns all available values.

web

String

The company web page.

Maximum length: 200

numberWorkers

Integer

The number of workers in the company.

logoUrl

String

The url to get the company's logo.

Maximum length: 150

corporateWebsiteUrl

String

The url to go to the infojobs company's corporate website .

Maximum length: 200

hidden

Boolean

true if the company wants to remain anonymous, false otherwise.

Fields related to Upselling entity
Name Description

highlightColor

Boolean

The job offer must be highlighted with another colour.

highlightUrgent

Boolean

The job offer must be highlighted with an urgent icon.

highlightHomeMonth

Boolean

The job offer must be shown in the home for one month.

highlightHomeWeek

Boolean

The job offer must be shown in the home for one week.

highlightSubcategory

Boolean

The job offer must be shown with with de highlight offers in a offer search by subcategory.

highlightLogo

Boolean

true if the offer has the company's logo, false otherwise.

highlightStandingOffer

Boolean

The job offer don't expire during a year.

Fields related to Pay entity
Name Description

amount

Long

The amount of money in euros.

amountId

Long

The amount unique identifier. The operation /dictionary/salary-quantity returns all available values.

amountValue

String

The amount text representation in format : 36.000 €

Maximum length: 100

periodId

Long

The time range of the salary unique identifier. The operation /dictionary/salary-period returns all available values.

periodValue

String

The Time range of the salary value.

Maximum length: 100

Fields related to DictionaryItem entity
Name Description

id

Long

Identifier of the element.

key

String

Normalized textual value.

Maximum length: 100

value

String

Human readable textual value.

Maximum length: 100

order

Long

Order of the element in the list.

parent

Long

Specify the parent of each element. For example, in list dictionary/province the field parent specifies the country of each element. This field is only available in some lists of values.

Error codes

Code Description

313

The offer {offerId} is not a valid parameter

Examples

This example shows the detail of a offer.

Request

GET https://api.infojobs.net/api/1/offer/eb371a01c14f97838d790d19d606ce

Response

{
"title": "Adjunto Responsable de Tienda y Colaboradores",
"id": "8e55718e6d4282979b59a20017186d",
"state": 1,
"creationDate": "2012-03-13T23:00:00.000+0000",
"updateDate": "2012-03-14T08:43:36.000+0000",
"city": "Fuenlabrada",
"externalUrlForm": "",
"blocked": true,
"applications": 0,
"province": {
"id": 33,
"value": "Madrid"
},
"experienceMin": {
"id": 6,
"value": "Al menos 2 años"
},
"category": {
"id": 10,
"value": "Administración de empresas"
},
"subcategories": [
{
"id": 3000,
"value": "Administración",
"order": 20,
"key": "administracion",
"parent": 10
}
],
"studiesMin": {
"id": 120,
"value": "Ingeniero Técnico"
},
"residence": {
"id": 0,
"value": "(Seleccionar)"
},
"country": {
"id": 17,
"value": "España"
},
"contractType": {
"id": 1,
"value": "Indefinido"
},
"journey": {
"id": 1,
"value": "Completa"
},
"profile": {
"id": "659ee7e1-c456-4db6-980c-ed19a94eab0d",
"name": "Empresa ejemplo",
"description": "Somos una empresa multinacional alemana líder en el sector de la distribución con más de 3.500 tiendas en Europa.",
"province": {
"id": 9,
"value": "Barcelona"
},
"numberWorkers": 3000,
"url": "",
"corporateWebsiteUrl": "/gen/multisite-ij.xhtml?iCodigoPerfil=659ee7e1-c456-4db6-980c-ed19a94eab0d&perfil=empresa-oculta",
"websiteUrl": "",
"hidden": true
},
"cityPD": 3506,
"zipCode": "08800",
"latitude": 41.608213,
"longitude": 2.287789,
"exactLocation": false,
"department": "",
"vacancies": 1,
"minRequirements": "",
"description": "En dependencia del Responsable de Zona, el candidato a ADJUNTO DE RESPONSABLE DE TIENDA se responsabilizará de alcanzar en su tienda la mayor cifra de ventas y rentabilidad posibles.",
"desiredRequirements": "- Alto grado de responsabilidad y autonomía.\n- Capacidad de decisión y trabajo.",
"commissions": "",
"contractDuration": "",
"referenceId": "",
"detailedStudiesId": -11,
"studying": false,
"showPay": true,
"maxPay": {
"amount": 27000,
"amountId": 275,
"periodId": 3,
"periodValue": "Bruto/año",
"amountValue": "27.000 €"
},
"minPay": {
"amount": 24000,
"amountId": 270,
"periodId": 3,
"periodValue": "Bruto/año",
"amountValue": "24.000 €"
},
"schedule": "",
"jobLevel": {
"id": 3,
"value": "Especialista"
},
"staffInCharge": {
"id": 3,
"value": "6 - 10"
},
"hasKillerQuestions": 0,
"hasOpenQuestions": 0,
"upsellings": {
"highlightColor": true,
"highlightUrgent": true,
"highlightHomeMonth": false,
"highlightHomeWeek": false,
"highlightSubcategory": false,
"highlightLogo": false,
"highlightStandingOffer": false
},
"link": "http://www.infojobs.net/fuenlabrada/oferta-multi-color-oculta/of-i8e55718e6d4282979b59a20017186d",
"active": true,
"archived": false,
"deleted": false,
"disponibleForFullVisualization": true,
"availableForVisualization": true
}