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/7/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
| Name | Description |
|---|---|
|
id String |
The Offer unique identifier. Maximum length: 100 |
|
title String |
Title of the offer. Maximum length: 150 |
|
category |
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 |
The city where the job is offered, identified in our list of cities. The operation /dictionary/city returns all available values. |
|
province |
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 |
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 |
Characteristics of job offer to highlight it over others. (Bold, urgent, ...) |
|
showPay Boolean |
true if the pay data is filled, false otherwise. |
|
minPay |
Minimum value of the job offer salary range. |
|
maxPay |
Maximum value of the job offer salary range. |
|
contractType |
Contract type of the job offer. The operation /dictionary/contract-type returns all available values. |
|
journey |
The job offer working day type. The operation /dictionary/workday returns all available values. |
|
studiesMin |
Level of education of the job seeker (Bachelor's degree, Masters, etc.). The operation /dictionary/study returns all available values. |
|
experienceMin |
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 |
Indicates if required residence somewhere. (Province of vacancy, country of vacancy, etc..) |
|
country |
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 |
Type of job (trainee, employee, management...). The operation /dictionary/employer-type returns all available values. |
|
staffInCharge |
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. |
|
subSegment Long |
|
|
skillsList List(SkillItem) |
The job offer skills. The operation /dictionary/type/skills returns all available values. |
|
epreselec Boolean |
true indicates if the job offer its published from epreselec |
|
fiscalAddress String |
Fiscal address of the publisher company matrix. Only showed if the value epreselec is true. May be empty. |
| 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 |
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 |
|
websiteUrl String |
The company website URL. Maximum length: 200 |
|
hidden Boolean |
true if the company wants to remain anonymous, false otherwise. |
|
country |
The profile country. The operation /dictionary/country returns all available values. |
|
typeIndustry |
The profile industry type. The operation /dictionary/industry returns all available values. |
|
corporateResponsive Boolean |
Whether the company corporate site is responsive or not. |
|
showCorporativeHeader Boolean |
Whether to show the company corporate header or not. |
|
clientId Number |
client id. Identifies a company. |
|
reviewSummary Optional |
Summary of the profile's review. |
| 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. |
| 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 |
| 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. |
| Name | Description |
|---|---|
|
skill String |
Skill name. |
| Name | Description |
|---|---|
|
profileId String |
The profile's Id. |
|
profileName String |
The name of the profile. |
|
rating Double |
The rating of the profile. |
|
totalReviews Integer |
The number of the reviews. |
|
worstRating Integer |
The lowest value allowed in this rating system. |
|
bestRanking Integer |
The highest value allowed in this rating system. |
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/6/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,
"typeIndustry": {
"id": 75,
"value": "Ingeniería"
},
"country": {
"id": 17,
"value": "España"
},
"corporateResponsive": false,
"showCorporativeHeader": false,
"clientId": 2391690986
},
"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,
"subsegment": 23,
"skillsList": {
"skill": "Java",
"skill": "JSP"
},
"epreselec": true,
"fiscalAddress": "C/. XXXX, 28XXX Madrid, MADRID, España"
}
