Job feed
for companies, recruiting platforms and agencies
How it works
- Publish one address with every open job, in one of the formats below. If your recruiting platform already makes one for Indeed or Jooble, the same one works.
- Register the company and send that address in Your careers site.
- We read the feed every night. Once the company is verified, its jobs reach search within one or two days. If it was verified only by its website's domain, we review the feed before the first read.
- Free, and outside the monthly ad limit: a feed counts as your careers site, not as ads posted here.
- The feed is the whole list: a job that stops appearing leaves search. An empty or failing feed removes nothing.
- Jobs in other countries and open applications are left out.
- Jobs are ranked like every other: nothing here buys a place in the results.
Formats
- XML in Indeed's format (
<source><job>…); Jooble's tags work too. - JSON with schema.org
JobPostingobjects (Google for Jobs'), as a list or underjobs. - Personio: the link to your Personio page is enough; we read its
/xml.
XML example:
<?xml version="1.0" encoding="UTF-8"?>
<source>
<publisher>Acme, Lda</publisher>
<job>
<referencenumber>REQ-101</referencenumber>
<title><![CDATA[Técnico/a de Manutenção Industrial]]></title>
<url>https://www.acme.pt/vagas/101</url>
<city>Leiria</city>
<postalcode>2400-001</postalcode>
<country>PT</country>
<date>2026-11-14</date>
<expirationdate>2026-12-31</expirationdate>
<description><![CDATA[<p>Manutenção preventiva e corretiva das linhas de produção.</p>]]></description>
<contract>sem_termo</contract>
<jobtype>fulltime</jobtype>
<salary_min>1100</salary_min>
<salary_max>1300</salary_max>
</job>
</source>
The same in JSON:
{
"jobs": [
{
"@context": "https://schema.org",
"@type": "JobPosting",
"identifier": "REQ-102",
"title": "Enfermeiro/a",
"url": "https://www.acme.pt/vagas/102",
"description": "<p>Unidade de cuidados continuados, turnos rotativos.</p>",
"datePosted": "2026-11-14",
"validThrough": "2026-12-31",
"employmentType": "FULL_TIME",
"hiringOrganization": {
"@type": "Organization",
"name": "Acme"
},
"jobLocation": {
"@type": "Place",
"address": {
"@type": "PostalAddress",
"addressLocality": "Viseu",
"postalCode": "3500-001",
"addressCountry": "PT"
}
},
"baseSalary": {
"@type": "MonetaryAmount",
"currency": "EUR",
"value": {
"@type": "QuantitativeValue",
"minValue": 1400,
"maxValue": 1650,
"unitText": "MONTH"
}
}
}
]
}
Fields
| XML | JSON | ||
|---|---|---|---|
| id * | <referencenumber> | identifier | the job's code, stable between reads |
| title * | <title> | title | the ad's title |
| link * | <url> | url | the ad's page, where people apply |
| description * | <description> | description | the ad's text; plain HTML accepted |
| place * | <city>, <concelho>, <postalcode> | jobLocation.address | municipality or town, and the postcode |
| country | <country> | addressCountry | PT; jobs in other countries are left out |
| remote | <remotetype> | jobLocationType: TELECOMMUTE | remote or hybrid work |
| dates | <date>, <expirationdate> | datePosted, validThrough | posted and closing (YYYY-MM-DD); at the closing date the job is taken down |
| salary | <salary_min>, <salary_max> ou <salary> | baseSalary | gross per month, in euros |
| contract | <contract>, <jobtype> | employmentType | sem_termo, termo_certo, termo_incerto, temporario, estagio, prestacao_servicos; and the hours (fulltime, parttime) |
* expected on every job; without an id, the link stands in. The rest is optional, but the municipality, salary and contract make the job easier to find with the filters.
Rules
- A public http(s) address on the usual ports that answers with XML or JSON (not a web page).
- Up to 5 addresses per company, each up to 10 MB.
- Jobs always show the registered company's name; a name or NIF inside the feed is not used.
- Nobody reviews a feed's jobs before they go out, so we leave out any with links, emails or addresses on other domains (besides the company's and the feed's), code, signs of a scam, or a title in capitals.
- Dates as YYYY-MM-DD (the RSS form, "Fri, 14 Nov 2026", works too); text in UTF-8.