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 |
The date the offer was last promoted to the top of the list. If there are no promotions, this is the date the offer was last reused, which can be the creation date, the extension date, or the date the expired offer was reactivated. |
|
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"
}
