get/offer
Returns a list of offers that comply with the specified search parameters. This operation is useful to retrieve a set of offers posted in a specific province, category, etc. It also enables you to search offers containing a keyword. The response includes the most relevant fields of each offer. It may also return a faceted search (also called faceted navigation, guided navigation, or parametric search) that breaks up search results into multiple categories (province, category, etc.), showing counts for each. It allows the user to "drill down" or further restrict their search results based on those facets.
Request
Resource URL
https://api.infojobs.net/api/7/offer
Security
- User Role: public
- Scope: none
Parameters
Name | Description |
---|---|
q String Optional |
Keyword to search for. The same syntax and restrictions of Palabra clave in InfoJobs portal applies, as well as for results and errors. Example values: java Single word: java Single word except the last character: jav? Exact phrase search: "java developer" Single word starting by: jav* One word OR another: (java ruby) By job post name: puesto: "developer" By job post description: descripcion: "developer" By job post town: poblacion: "barcelona" By job post requirements: requisitos: "proactiveness" By job seeker: empresa: "RAC" Excluding search criteria: -puesto: "developer" |
province String Optional |
Searches for Offers in this province. The operation /dictionary/province returns all available values. In order to filter by multiple provinces you can send this parameter more than once. Example values: zamora Example of multiple provinces: province=barcelona&province=madrid |
category String Optional |
Searches for Offers published with specified categories. The operation /dictionary/category returns all available values. If a subcategory parameter is present then the category will be ignored. In order to filter by multiple categories you can send this parameter more than once. Example values: administracion-publica Example of multiple categories: category=atencion-a-cliente&category=comercial-ventas |
subcategory String Optional |
Searches for Offers published with specified subcategories. The operation /dictionary/subcategory returns all available values. In order to filter by multiple subcategories you can send this parameter more than once. Example values: administracion Example of multiple subcategories: subcategory=marketing&subcategory=industrial |
city Optional |
The name of a city used as center of a geosearch. The operation /dictionary/city returns all available values. Example values: 2012-02-14T09:00:00Z |
radius Integer Optional |
The radius of a geosearch expressed in kilometers. If the parameter city is not defined this parameter is ignored. If radius parameter is not defined then this field is ignored and it takes 0 by default, that means a city's exact match. Example values: 15 |
country Optional |
Searches for Offers in this country. If a province parameter is present then the country will be ignored. The operation /dictionary/country returns all available values. Example values: espana |
salaryMin Integer Optional |
Searches for Offers published with a salary equal or greater than the specified in this parameter. Example values: 24000 |
salaryMax Integer Optional |
Searches for Offers published with a salary equal or lower than the specified in this parameter. Example values: 30000 |
salary String Optional |
searches for offers that complies with the specified salary range. The operation /dictionary/salary-range returns all available values. Example values: entre-12.001-y-15.000 |
salaryPeriod String Optional |
searches for offers that complies with the specified salary period. The operation /dictionary/salary-period returns all available values. Example values: bruto-ano |
study String Optional |
Searches for Offers published with specified study level. The operation /dictionary/study returns all available values. Example values: ingeniero-tecnico |
contractType String Optional |
Searches for Offers published with specified contract type. The operation /dictionary/contract-type returns all available values. Example values: indefinido |
experienceMin String Optional |
Searches for Offers published with specified minimum experience. The operation /dictionary/experience-min returns all available values. Example values: no-requerida |
workday String Optional |
Searches for Offers published with specified workday type. The operation /dictionary/workday returns all available values. Example values: completa |
publishedMax Optional |
Maximum date of publication. Date format must be in RFC_3339. Example values: 2012-02-14T09:00:00Z |
publishedMin Optional |
Minimum date of publication. Date format must be in RFC_3339. Example values: 2012-02-01T09:00:00Z |
updatedMax Optional |
Maximum date of modification. Date format must be in RFC_3339 format: yyyy-MM-dd'T'HH:mm:ss'Z'. Example values: 2012-02-22T09:00:00Z |
updatedMin Optional |
Minimum date of modification. Date format must be in RFC_3339 format: yyyy-MM-dd'T'HH:mm:ss'Z'. Example values: 2012-02-02T09:00:00Z |
vip Boolean Optional |
Searches for VIP offers, very important offers, a translation of "oferta destacada". Value "true" to get only VIP-offers. Value "false" to get only non-VIP offers. If the parameter is absent means all offers. Example values: true |
selection Boolean Optional |
Includes job offers published by recruiting companies. Default value: true. Example values: false |
ett Boolean Optional |
Includes job offers published by temporary staffing agencies. Default value: true. Example values: false |
companyName String Optional |
Includes job offers published by this company. It gets the same results that adding "empresa:" to "q" parameter. Example values: InfoJobs |
employerId String Optional |
Includes job offers published by this company. EmployerId is the public profile code for these offers. Example values: RAC |
emph String Optional |
Emphasis of the offer. Show only "urgent" or "bold" offers. Any other value is ignored. Allowed values: bold | urgent Example values: RAC |
order String Optional |
Sorts results by the selected value in ascending or descending order. The default value is updated date in descending order. Allowed values: updated | updated-desc | title | title-desc | city | city-desc | author | author-desc Example values: title |
page Integer Optional |
Used for pagination. The page number of the result set. Example values: 3 |
maxResults Integer Optional |
Maximum number of results per page. Example values: 30 |
facets Boolean Optional |
By setting this parameter to true, a collection of all the filters is retrieved: the ones already applied to the search and the ones that may be applied to the search result. For each filter all the value keys allowed are returned along with the number of matching elements. This parameter is useful to show the user the number of elements he could retrieve after applying a filter without needing to perform a query. By default no facets are returning. Example values: true |
Response
Response fields
Name | Description |
---|---|
offers |
The list of job offers, see below for details. |
totalResults Integer |
The total number of offers that satisfy the query criteria. |
currentResults Integer |
The number of offers in the current page. |
totalPages Integer |
The total number of result pages. |
currentPage Integer |
The current page. |
pageSize Integer |
The maximum number of offers in a result page. |
facets List (Facets) |
The list of facets. This field is returned only if the facets are requested using the parameter facets with value 1. Available facets: province | category | subcategory | study | contractType | workDay | salary | experienceMin | country | city |
Name | Description |
---|---|
id String (200) |
Offer identifier. |
title String (150) |
Title of the offer. |
category |
The job offer category. The operation /dictionary/category returns all available values. |
subcategory |
The job offer subcategory. The operation /dictionary/sbucategory returns all available values. |
link String(1000) |
URL of the offer published at Infojobs portal. |
city String(200) |
Name of the city where the job is offered. |
province |
The job offer province. The operation /dictionary/province returns all available values. |
author |
Provides information about the company that publishes the offer. |
updated Date |
Date of job offer's last modification in RFC_3339 format: yyyy-MM-dd'T'HH:mm:ss'Z'. |
published Date |
Date the job post was published at Infojobs portal in RFC_3339 format: yyyy-MM-dd'T'HH:mm:ss'Z'. |
applications Integer |
Number of applications received for the job post. |
bold Boolean |
True if the job offer was published as a highlighted offer. |
urgent Boolean |
True if the job offer was published as an urgent offer. |
color Boolean |
True if the job offer has color upselling. |
salaryMin |
Minimum value of the job offer salary range. The operation /dictionary/salary-quantity returns all available values. |
salaryMax |
Maximum value of the job offer salary range. The operation /dictionary/salary-quantity returns all available values. |
salaryPeriod |
Time range of the salary values (Year, Month, Week,...). The operation /dictionary/salary-period returns all available values. |
contractType |
Contract type of the job offer. The operation /dictionary/contract-type returns all available values. |
workDay |
The work day of the job offer. The operation /dictionary/workday returns all available values. |
study |
The study required in the job offer. The operation /dictionary/study returns all available values. |
experienceMin |
Minimum required experience for the job offer. The operation /dictionary/experience-min returns all available values. |
requirementMin String (2500) |
Description of the minimum required skills for the job post. |
executive Boolean |
Whether the job offer is executive |
Name | Description |
---|---|
id Long |
Identifier of the element. |
value String(100) |
Human readable textual value. |
Name | Description |
---|---|
id String(40) |
The company unique identifier. |
name String(100) |
The company name. |
uri String(200) |
The url of the InfoJobs company's corporate website. |
logoUrl String(200) |
The url of the logo image of the InfoJobs company profile used to publish a featured job offer. |
corporateResponsive Boolean |
Whether the company corporate site is responsive or not. |
showCorporativeHeader Boolean |
Whether to show the company corporate header or not. |
reviewSummary Optional |
Summary of the profile's review. |
Name | Description |
---|---|
key String(100) |
The facets identifier. |
name String(100) |
The facets public name. |
facet List (Facet) |
List with the items of this Facets. For example, for the province Facets it contains the different provinces with the number of offers matching each province. |
Name | Description |
---|---|
key String(200) |
The facet item identifier. |
count Integer |
The number of offers matching this facet item. |
value String (200) |
Human readable textual value. |
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 |
---|---|
226 |
The date format must be RFC_3339: yyyy-MM-dd'T'HH:mm:ss'Z'. |
301 |
The province is not a valid parameter. |
302 |
The country is not a valid parameter. |
303 |
The category is not a valid parameter. |
304 |
The subcategory is not a valid parameter. |
305 |
The order is not a valid parameter. |
306 |
The page is not a valid parameter. |
307 |
The contract type is not a valid parameter. |
308 |
The experience is not a valid parameter. |
309 |
The workday is not a valid parameter. |
311 |
The city is not a valid parameter. |
312 |
The radius is not a valid parameter. |
318 |
The salaryMin is not a valid parameter. |
319 |
The salaryMax is not a valid parameter. |
820 |
The employerId is not a valid parameter. |
Examples
This example searches for job posts located in Madrid with indefinite contract type and within the Administración de empresas category
Request
GET https://api.infojobs.net/api/7/offer?contractType=indefinido&province=madrid&category=administracion-empresas
Response
{ "currentPage": 1, "pageSize": 2, "totalResults": 23868, "currentResults": 2, "totalPages": 114, "offers": [ { "id": "0bb014b42f407ca6e988dc789f5a5a", "title": "Offer Test", "province": { "id": 40, "value": "Pontevedra" }, "city": "Galicia", "link": "https://www.infojobs.net/galicia/offer-test/of-i0000000000000000000000000000", "category": { "id": 10, "value": "Administración de empresas" }, "contractType": { "id": 1, "value": "Indefinido" }, "subcategory": { "id": 3008, "value": "Organización de la empresa" }, "salaryMin": { "id": 0, "value": "" }, "salaryMax": { "id": 0, "value": "" }, "salaryPeriod": { "id": 0, "value": "" }, "experienceMin": { "id": 5, "value": "Más de 5 años" }, "workDay": { "id": 1, "value": "Completa" }, "study": { "id": 140, "value": "Licenciado" }, "published": "2012-09-21T10:26:23.000+0000", "updated": "2012-09-21T10:26:23.000+0000", "author": { "id": "967153524526202350563215654828", "name": "Improven Consultores", "uri": "http://www.infojobs.net/improven-consultores/em-i00000000", "corporateResponsive": false, "showCorporativeHeader": false }, "requirementMin": "El perfil se corresponde con el de un/a profesional con titulación superior en ADE, económicas o similar, con formación de postgrado en finanzas y/o gestión (MBA, PDD, etc.) y con sólida experiencia en departamentos administrativo/financieros. Se valorará positivamente experiencia en el manejo de ERP's así como un excelente nivel de idioma inglés hablado y escrito.", "bold": false, "urgent": false, "color": false, "applications": "0" }, { "id": "0bb014b42f407ca6e988dc789f5a5b", "title": "Offer Test Destacada Logo", "province": { "id": 40, "value": "Pontevedra" }, "city": "Galicia", "link": "https://www.infojobs.net/galicia/offer-test/of-i0000000000000000000000000001", "category": { "id": 10, "value": "Administración de empresas" }, "contractType": { "id": 1, "value": "Indefinido" }, "subcategory": { "id": 3008, "value": "Organización de la empresa" }, "salaryMin": { "id": 0, "value": "" }, "salaryMax": { "id": 0, "value": "" }, "salaryPeriod": { "id": 0, "value": "" }, "experienceMin": { "id": 5, "value": "Más de 5 años" }, "workDay": { "id": 1, "value": "Completa" }, "study": { "id": 140, "value": "Licenciado" }, "published": "2012-09-22T10:26:23.000+0000", "updated": "2012-09-22T10:26:23.000+0000", "author": { "id": "967153524526202350563215654829", "name": "Improven Consultores", "uri": "http://www.infojobs.net/improven-consultores/em-i00000001", "logoUrl": "http://www.infojobs.net/logo/logo/do-get.xhtml?id=00000000001", "corporateResponsive": false, "showCorporativeHeader": false }, "requirementMin": "El perfil se corresponde con el de un/a profesional con titulación superior en ADE, económicas o similar, con formación de postgrado en finanzas y/o gestión (MBA, PDD, etc.) y con sólida experiencia en departamentos administrativo/financieros. Se valorará positivamente experiencia en el manejo de ERP's así como un excelente nivel de idioma inglés hablado y escrito.", "bold": true, "urgent": false, "color": false, "applications": "0" } ] }