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/9/offer
Security
- User Role: public
- Scope: none
Parameters
| Name | Description |
|---|---|
|
q String Optional |
Keyword to search for. Example values: java |
|
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. In order to filter by multiple cities you can send this parameter more than once. Example values: city=barcelona&city=donostia-san-sebastian |
|
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 |
|
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. In order to filter by multiple studies you can send this parameter more than once. Example values: ingeniero-tecnico |
|
contractType String Optional |
Searches for Offers published with specified contract type. The operation /dictionary/contract-type returns all available values. In order to filter by multiple contract types you can send this parameter more than once. Example values: indefinido |
|
experienceMin String Optional |
Searches for Offers published with specified minimum experience. The operation /dictionary/experience-min returns all available values. In order to filter by multiple experiences you can send this parameter more than once, and will work as a mix of a filter and a range. If a single value is sent (for example no-requerida), it will filter out only the offers for which the minimum experience is not required. If two or more values are sent (for example, no-requerida, al-menos-1-anos, al-menos-3-ano), it will use range as a filter, (in this example, offers range from no minimum experience to at least 3 years will be returned). Example values: no-requerida |
|
workday String Optional |
Searches for Offers published with specified workday type. The operation /dictionary/workday returns all available values. In order to filter by multiple workdays you can send this parameter more than once. Example values: completa |
|
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 "bold" offers. Any other value is ignored. Allowed values: bold Example values: bold |
|
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 | relevancia-desc | applicants-asc Example values: relevancia-desc |
|
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. We strongly recommend limiting to 50 or fewer maximum results for an optimal request performance. The default value is 20. 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 |
|
sinceDate String Optional |
Setting this parameter will filter by the antiquity of the offers to display from today. Allowed values: _24_HOURS | _7_DAYS | _15_DAYS | ANY (default)
Example values: _24_HOURS |
|
teleworking String Optional |
Search job positions that have job types working remotely or not. The operation /dictionary/teleworking returns all available values. Example values: solo-teletrabajo Example of multiple values: teleworking=teletrabajo-posible&teleworking=solo-teletrabajo |
|
countryIds Integer Optional |
Searches for Offers with this country id. If a province parameter is present then the country will be ignored. The operation /dictionary/country returns all available values. In order to filter by multiple countries you can send this parameter with more than one value. Example value: 17 Example of multiple country ids: countryIds=1,17 |
|
provinceIds Integer Optional |
Searches for Offers with this province id. The operation /dictionary/province returns all available values. In order to filter by multiple provinces you can send this parameter more than one value. Example value: 9 Example of multiple province ids: provinceIds=9,33 |
|
cityIds Integer Optional |
The id of a city used as center of a geosearch. The operation /dictionary/city returns all available values. In order to filter by multiple cities you can send this parameter with more than one value. Example value: cityIds=17 Example of multiple country ids: cityIds=1,17 |
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 |
|
availableSortingMethods List(String) |
The list of available sorting methods on the search done. |
|
sortBy String |
The sorting method that was applied to the search. |
|
sinceDate String |
The sinceDate option that was applied to the search. |
|
queryParameters |
The parameters that was applied to the search. |
| 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. |
|
multiProvince Boolean |
The offer is available in several provinces. |
|
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 String |
Number of applications received for the job post. |
|
bold Boolean |
True if the job offer was published as a highlighted offer. |
|
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. |
|
salaryDescription String |
The salary summary description. Adapted and translated based on the tenant request. |
|
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 |
|
teleworking |
Jop position working type. The operation /dictionary/teleworking returns all available values. |
|
priority Boolean |
The recruitment process is online. |
| 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. |
| 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. |
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": 35,
"currentResults": 2,
"totalPages": 18,
"availableSortingMethods": [
"relevancia-desc",
"updated-desc"
],
"sortBy": "updated-desc",
"sinceDate": "_24_HOURS",
"facets": [
{
"key": "province",
"name": "Provincia",
"values": [
{
"key": "madrid",
"value": "Madrid",
"count": 39
},
{
"key": "barcelona",
"value": "Barcelona",
"count": 35
},
{
"key": "illes-balears",
"value": "Islas Baleares/Illes Balears",
"count": 26
}
]
},
{
"key": "city",
"name": "Población",
"values": [
{
"key": "barcelona",
"value": "Barcelona",
"count": 26
},
{
"key": "montcada-i-reixac",
"value": "Montcada i Reixac",
"count": 2
}
]
},
{
"key": "teleworking",
"name": "Presencial/Teletrabajo",
"values": [
{
"key": "trabajo-solo-presencial",
"value": "Presencial",
"count": 35
}
]
},
{
"key": "category",
"name": "Categoría",
"values": [
{
"key": "turismo-restauracion",
"value": "Turismo y restauración",
"count": 32
},
{
"key": "atencion-a-cliente",
"value": "Atención a clientes",
"count": 1
},
{
"key": "otros",
"value": "Otros",
"count": 1
},
{
"key": "administracion-publica",
"value": "Administración Pública",
"count": 1
}
]
},
{
"key": "study",
"name": "Estudios",
"values": [
{
"key": "educacion-secundaria-obligatoria",
"value": "Educación Secundaria Obligatoria",
"count": 14
},
{
"key": "sin-estudios",
"value": "Sin estudios",
"count": 8
}
]
},
{
"key": "contractType",
"name": "Tipo de contrato",
"values": [
{
"key": "indefinido",
"value": "Indefinido",
"count": 22
},
{
"key": "de-duracion-determinada",
"value": "De duración determinada",
"count": 10
},
{
"key": "otros-contratos",
"value": "Otros contratos",
"count": 2
},
{
"key": "fijo-discontinuo",
"value": "Fijo discontinuo",
"count": 1
}
]
},
{
"key": "workDay",
"name": "Jornada laboral",
"values": [
{
"key": "completa",
"value": "Completa",
"count": 24
},
{
"key": "parcial-indiferente",
"value": "Parcial - Indiferente",
"count": 5
},
{
"key": "indiferente",
"value": "Indiferente",
"count": 3
},
{
"key": "parcial-manana",
"value": "Parcial - Mañana",
"count": 1
},
{
"key": "parcial-tarde",
"value": "Parcial - Tarde",
"count": 1
},
{
"key": "intensiva-manana",
"value": "Intensiva - Mañana",
"count": 1
}
]
},
{
"key": "experienceMin",
"name": "Experiencia",
"values": [
{
"key": "al-menos-1-ano",
"value": "Al menos 1 año",
"count": 14
},
{
"key": "al-menos-2-anos",
"value": "Al menos 2 años",
"count": 10
},
{
"key": "no-requerida",
"value": "No Requerida",
"count": 4
},
{
"key": "al-menos-3-anos",
"value": "Al menos 3 años",
"count": 4
},
{
"key": "mas-de-5-anos",
"value": "Más de 5 años",
"count": 2
},
{
"key": "al-menos-4-anos",
"value": "Al menos 4 años",
"count": 1
}
]
},
{
"key": "country",
"name": "País",
"values": [
{
"key": "espana",
"value": "España",
"count": 226
},
{
"key": "alemania",
"value": "Alemania",
"count": 1
}
]
}
],
"queryParameters": {
"study": [],
"province": [
"barcelona"
],
"salaryPeriod": "seleccionar",
"city": [],
"contractType": [],
"query": "camarero",
"experienceMin": [],
"category": [
"-"
],
"workDay": [],
"teleworking": []
},
"offers": [
{
"id": "258eae420249ffa67cf64681a2ef80",
"title": "Camareros/as y 2º de Sala Zona Penedès",
"province": {
"id": 9,
"value": "Barcelona"
},
"city": "Vilafranca del Penedès",
"link": "https://www.infojobs.net/vilafranca-del-penedes/camareros-2-sala-zona-penedes/of-i258eae420249ffa67cf64681a2ef80",
"category": {
"id": 160,
"value": "Turismo y restauración"
},
"contractType": {
"id": 5,
"value": "Otros contratos"
},
"subcategory": {
"id": 3116,
"value": "Restauración"
},
"salaryMin": {
"id": 10,
"value": "12 ?"
},
"salaryMax": {
"id": 10,
"value": "12 ?"
},
"salaryPeriod": {
"id": 1,
"value": "Bruto/hora"
},
"experienceMin": {
"id": 6,
"value": "Al menos 2 años"
},
"workDay": {
"id": 1,
"value": "Completa"
},
"study": {
"id": 50,
"value": "Bachillerato"
},
"teleworking": {
"id": 1,
"value": "Presencial"
},
"published": "2023-05-09T14:04:02.000Z",
"updated": "2023-05-09T14:04:02.000Z",
"author": {
"id": "8275252453610761051133485087",
"privateId": 968194760,
"name": "ADECCO",
"uri": "https://adecco.ofertas-trabajo.infojobs.net",
"logoUrl": "https://multimedia.infojobs.net/api/v1/tenants/c7e2b9c1-8480-43b0-ad9e-000c17aa2cbb/domains/718302b6-5343-43d3-a8a3-829dc3da0893/buckets/6f3ab1cc-5920-4f4e-b131-46a4587a0e1f/images/06/065e27e3-7d83-402c-8da5-514eb31c4b2d?jwt=eyJhbGciOiJSUzI1NiJ9.eyJpYXQiOjE1NTI0NzU4MTUsInJxcyI6IkdFVFxcL3RlbmFudHMvYzdlMmI5YzEtODQ4MC00M2IwLWFkOWUtMDAwYzE3YWEyY2JiL2RvbWFpbnMvNzE4MzAyYjYtNTM0My00M2QzLWE4YTMtODI5ZGMzZGEwODkzL2J1Y2tldHMvNmYzYWIxY2MtNTkyMC00ZjRlLWIxMzEtNDZhNDU4N2EwZTFmL2ltYWdlcy8wNi8wNjVlMjdlMy03ZDgzLTQwMmMtOGRhNS01MTRlYjMxYzRiMmQiLCJtZXRhZGF0YSI6eyJydWxlIjp7InZlcnNpb24iOiIyMDE2LTEwIiwiYWN0aW9ucyI6W119fX0.hhKyy9MdL2-xst0DbHeeB0pz6fO3UvLSmf5syxGW4Pu1enugBcEj9wvLiwqm-7H9E23RL38iUzDC9m1KiEhepZVHLMYwnlhPlV-kD8LolmMS9ALxIicuUSjfhRrLe_LBux-Z_BfNUZFKePLyT1L9HGjKVG6-_hqf9efrMgRABAwExUjdu_iBXyFvrd1EpPPH19yrBhT8NWdkNV6iYmcp2_kCSWLazyXn8CU1dz76Oh16GwWpJ5_OWCIy_7ytljwWzr5ypt1yyA4JWtakkH1tNJDM-trSC02oaM4DWmx0t36RmsL4FQYynVx0lU0aIpaEchzChdoIPHbgR_lSWOva7w&AccessKeyId=d724d9a53d95a810",
"corporateResponsive": false,
"showCorporativeHeader": false
},
"requirementMin": "-Experiencia como camarero/a o segundo de Sala.\r\n- Nivel de Inglés alto valorable.\r\n- Valorable tener conocimientos del mundo del vino.\r\n- Disponibilidad para trabajar fines de semana y festivos.",
"bold": false,
"applications": "0",
"executive": false,
"salaryDescription": "12? - 12? Bruto/hora",
"multiProvince": false
}
]
}
