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.
you can get this id from author id (in the list of offers data) or the profile id (in the offer's detail data)

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

Fields related to the result
Name Description

offers

Offer

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

Fields related to Offer entity
Name Description

id

String (200)

Offer identifier.

title

String (150)

Title of the offer.

category

PD

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

subcategory

PD

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

PD

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

author

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

PD

Minimum value of the job offer salary range. The operation /dictionary/salary-quantity returns all available values.

salaryMax

PD

Maximum value of the job offer salary range. The operation /dictionary/salary-quantity returns all available values.

salaryPeriod

PD

Time range of the salary values (Year, Month, Week,...). The operation /dictionary/salary-period returns all available values.

contractType

PD

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

workDay

PD

The work day of the job offer. The operation /dictionary/workday returns all available values.

study

PD

The study required in the job offer. The operation /dictionary/study returns all available values.

experienceMin

PD

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

Fields related to PD entity
Name Description

id

Long

Identifier of the element.

value

String(100)

Human readable textual value.

Fields related to Author entity
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

ReviewSummary

Optional

Summary of the profile's review.

Fields related to Facets entity
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.

Fields related to Facet entity
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.

Fields related to ReviewSummary entity
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"
      }
   ]
}