Como funciona
- 1 · vocêPublica o feedUma URL HTTPS com todas as vagas abertas dos clientes que divulgam na Remotar.
- 2 · RemotarLê a URLA cada poucas horas, sem nenhuma ação sua.
- 3 · RemotarCura e publicaVaga nova entra na curadoria. Vaga que sumiu do feed é encerrada.
- 4 · pessoa candidataCandidata-se no seu ATSO botão leva ao
applyUrlda vaga. A candidatura acontece no seu sistema.
O feed é sempre uma fotografia completa, não uma lista de alterações. Não é preciso marcar vaga como nova, alterada ou removida: basta o feed refletir o estado atual.
Requisitos da URL
- HTTPS, respondendo
GETcom status200eContent-Type: application/xml. - Codificação UTF-8.
- URL estável. Se precisar de chave de acesso, coloque-a na própria URL (
?token=…). Não suportamos cabeçalhos de autenticação. - Resposta completa em menos de 60 segundos. Recomendamos manter o arquivo abaixo de 20 MB.
Estrutura
<?xml version="1.0" encoding="UTF-8"?> <remotarFeed version="1.0"> <generatedAt>2026-09-21T09:00:00-03:00</generatedAt> <companies> <company> <id>acme</id> <name>Acme Pagamentos</name> <logoUrl>https://acme.example/logo.png</logoUrl> <description><![CDATA[<p>Quem é a empresa… (300+ caracteres)</p>]]></description> </company> </companies> <jobs> <job> <id>vaga-10482</id> <companyId>acme</companyId> <title>Pessoa Desenvolvedora Back-end Python Sênior</title> <description><![CDATA[<p>Descrição da vaga… (300+ caracteres)</p>]]></description> <applyUrl>https://vagas.ats.example/acme/vaga-10482</applyUrl> <workplace>remote</workplace> </job> </jobs> </remotarFeed>
versioné obrigatório e deve ser1.0nesta versão do formato.generatedAté obrigatório: o momento em que o arquivo foi gerado (ISO 8601 com fuso).- O feed tem dois blocos.
<companies>declara cada empresa uma única vez.<jobs>traz as vagas, e cada uma aponta para a sua empresa porcompanyId. - Dentro de
<job>e de<company>, os elementos podem vir em qualquer ordem. - Use
<![CDATA[ … ]]>em textos com HTML ou com os caracteres<e&.
Campos da vaga
Obrigatórios
| Campo | Formato | Regra |
|---|---|---|
id | Letras, números e . _ : -, até 100 caracteres | Identificador estável e único da vaga no seu ATS. Veja Identificadores. |
companyId | O id de uma empresa em <companies> | Empresa que contrata. Veja Empresas. |
title | Texto, até 255 caracteres | Título da vaga, sem código interno nem nome da empresa. |
description | HTML, mínimo de 300 caracteres de texto | Descrição completa: responsabilidades, requisitos e o que mais houver. As tags não contam para o mínimo. |
applyUrl | URL https:// | Página de candidatura desta vaga no seu ATS. |
workplace | remote · hybrid · onsite | Modelo de trabalho. Veja Quais vagas entram. |
location | <city> e <state> | Obrigatório em vaga híbrida. Cidade e UF de 2 letras (ex.: SP) do escritório. |
Opcionais
Os opcionais melhoram a vaga na Remotar: aparecem como filtro, selo ou informação destacada. Mande sempre que tiver o dado.
| Campo | Formato | Uso |
|---|---|---|
publishedAt | Data e hora ISO 8601 | Data em que a vaga foi aberta. |
contractType | clt · pj · internship · temporary · freelancer · other | Tipo de contratação. |
seniority | internship · junior · mid · senior · specialist · lead | Nível da vaga. |
salary | min · max · currency · period | Faixa salarial. Veja Salário. |
category | Texto, até 255 caracteres | Área da vaga no seu ATS (ex.: "Tecnologia"). |
pcd | true · false | true quando a vaga é exclusiva ou afirmativa para pessoas com deficiência. |
confidential | true · false | true quando a empresa não quer aparecer. Veja Vaga confidencial. |
benefits | Lista de <benefit>, até 50 | Benefícios oferecidos, um por item. |
Empresas
Cada empresa aparece uma vez em <companies>, com dados reais, e as vagas apontam para ela. Empresa sem nenhuma vaga no feed é ignorada.
| Campo | Obrigatório | Regra |
|---|---|---|
id | sim | Identificador estável e único do seu cliente. É o valor que as vagas usam em companyId. |
name | sim | Nome público da empresa, até 255 caracteres. |
logoUrl | sim | URL https:// do logo em PNG, JPG ou SVG. Prefira imagem quadrada, com pelo menos 200 px. |
description | sim | Apresentação da empresa em texto ou HTML, com mínimo de 300 caracteres de texto: o que faz, para quem e como o time trabalha. |
website | recomendado | Site institucional. Ajuda a reconhecer a empresa quando ela já está na Remotar. |
Logo e descrição são o que a pessoa candidata vê sobre a empresa. Sem eles, a empresa não pode ser publicada, e as vagas dela são descartadas até o feed trazê-los.
Vaga confidencial
Marque a vaga com <confidential>true</confidential>. A empresa continua declarada normalmente, com nome, logo e descrição reais, mas a Remotar publica aquela vaga sem nenhum dado da empresa. As outras vagas do mesmo cliente seguem identificadas.
Numa vaga confidencial, não revele a empresa no título, na descrição nem no applyUrl. Isso é responsabilidade do conteúdo que você envia.
Quais vagas entram
A Remotar publica apenas vagas remotas e híbridas.
workplace | Resultado | Observação |
|---|---|---|
remote | entra | Segue para a curadoria. |
hybrid com location | entra | Segue para a curadoria. |
hybrid sem location | descartada | Sem cidade e UF, a pessoa não sabe onde fica o escritório. |
onsite | ignorada | Pode vir no feed. Assim você não precisa filtrar. |
Além do modelo de trabalho, a vaga também é descartada, com o motivo no relatório da leitura, quando:
- a descrição da vaga tem menos de 300 caracteres de texto;
- o
companyIdnão corresponde a nenhuma empresa em<companies>; - a empresa dela está fora do esquema, sem logo ou com descrição abaixo de 300 caracteres de texto.
Toda vaga passa pela curadoria da Remotar antes de aparecer no site. Na primeira vaga de uma empresa nova, também confirmamos a empresa. Por isso, a publicação não é imediata, e uma vaga pode não ser publicada se não seguir as políticas da Remotar.
Identificadores
O id da vaga e o id da empresa são o que liga o seu feed ao que está publicado na Remotar.
- Nunca mude o
idde uma vaga existente. Para nós, umidnovo é uma vaga nova, e o antigo é uma vaga encerrada. - Nunca reaproveite um
idpara outra vaga, mesmo depois de a primeira ser encerrada. - Use o identificador interno do seu banco, não o título nem a URL.
- O
idda empresa não muda entre leituras. Se o cliente mudar de nome, oidcontinua o mesmo.
Ciclo de vida da vaga
| Situação | No feed | Na Remotar |
|---|---|---|
| Vaga aberta | Presente | Publica, depois da curadoria. |
| Vaga alterada | Presente, com os dados novos | Atualiza. |
| Vaga fechada ou pausada | Ausente | Encerra a vaga. |
| Vaga reaberta | Volta, com o mesmo id | Reativa a vaga. |
| Nenhuma vaga aberta | <jobs/> vazio, num feed legível | Encerra todas as vagas do feed. |
| Vaga ou empresa fora das regras | Presente, mas inválida | Só essa vaga é ignorada; as outras seguem. Se ela já estava publicada, mantém o último estado. O motivo aparece no relatório da leitura. |
| Feed ilegível | Erro HTTP, timeout, XML malformado ou sem <remotarFeed> | Nada muda. Mantém o último estado e tenta de novo na próxima leitura. |
Um erro nunca derruba vagas publicadas. Só um feed legível e sem aquela vaga a encerra.
Descrição e salário
Descrição
- Envie HTML simples:
p,br,ul,ol,li,strong,em,h2–h4ea. Scripts, estilos, iframes, imagens e atributos de formatação são removidos. - Não inclua o link de candidatura na descrição: ele vem em
applyUrl. - O mínimo é de 300 caracteres de texto, sem contar as tags, tanto na vaga quanto na empresa. Abaixo disso, a vaga é descartada.
Salário
<salary> <min>12000</min> <max>16000</max> <currency>BRL</currency> <period>month</period> </salary>
- Valores inteiros, sem separador de milhar nem centavos.
maxé obrigatório dentro desalary. Para salário fixo, mande sómax.currency:BRL,USDouEUR.period:hour,monthouyear.- Se a vaga não divulga salário, omita o bloco inteiro. Não mande
0.
Link de candidatura e rastreamento
Ao enviar a pessoa para o applyUrl, a Remotar acrescenta utm_source=remotar à URL, a menos que ela já traga um utm_source. Assim você mede as candidaturas vindas da Remotar. Garanta que o seu ATS aceite parâmetros extras na URL de candidatura.
Validando o feed
O XSD confere estrutura e formatos. Com xmllint:
xmllint --noout --schema remotar-feed-v1.xsd seu-feed.xml
Ou em Python, com lxml:
from lxml import etree
schema = etree.XMLSchema(etree.parse("remotar-feed-v1.xsd"))
feed = etree.parse("seu-feed.xml")
schema.assertValid(feed)O XSD também confere a amarração: todo companyId precisa apontar para uma empresa declarada, e nem id de vaga nem id de empresa podem se repetir.
Três regras o XSD não consegue expressar, e nós conferimos na leitura:
- vaga
hybridprecisa delocation; - as descrições de vaga e de empresa precisam de pelo menos 300 caracteres de texto;
- o
idde cada empresa precisa ser estável entre leituras.
Na leitura, cada vaga é conferida sozinha: uma vaga fora das regras, ou de uma empresa fora delas, é descartada, e as outras seguem. O arquivo inteiro só é ignorado quando não é XML válido ou quando <remotarFeed>, version, generatedAt, <companies> ou <jobs> estão errados. Mesmo assim, valide o arquivo inteiro antes de enviar: vaga descartada é vaga que não aparece.
Se você precisa mandar um dado que o formato não prevê, escreva para contato@remotar.com.br: o formato cresce por versão.
Checklist antes de enviar a URL
- O feed valida contra
remotar-feed-v1.xsd. - A URL responde por HTTPS em menos de 60 segundos.
- O feed contém todas as vagas abertas, não só as recentes.
- Os
ids de vaga e de empresa vêm do seu banco e não mudam. - Toda empresa com vaga no feed tem logo em
https://e descrição com pelo menos 300 caracteres de texto. - Toda vaga tem descrição com pelo menos 300 caracteres de texto.
- Toda vaga híbrida tem cidade e UF.
- Nas vagas confidenciais, nem o título, nem a descrição, nem o
applyUrlrevelam a empresa. - O
applyUrlabre a candidatura da vaga certa, sem exigir login prévio. - O
applyUrlcontinua funcionando com?utm_source=remotarno final.
Próximo passo
Com o feed validado, envie para contato@remotar.com.br a URL do feed, o nome do seu ATS com um contato técnico e, se houver, a lista dos clientes que já têm vagas no feed. Fazemos uma leitura de teste, mostramos o resultado (vagas aceitas, descartadas e o motivo de cada descarte) e só então ativamos a integração.
Versionamento
- Mudanças compatíveis, como um campo opcional novo, sobem a versão menor:
1.1,1.2. Um feed1.0continua válido. - Mudanças incompatíveis geram uma versão
2.0, com novo XSD e prazo de transição combinado com cada parceiro.
XSD e exemplo
Os dois arquivos oficiais da versão 1.0: remotar-feed-v1.xsd e exemplo-v1.xml. O exemplo traz duas empresas (uma completa, outra só com o obrigatório) e três vagas: uma remota com todos os campos, uma híbrida e uma confidencial. Ele valida contra o XSD e cumpre as regras de leitura.
Exemplo de feed exemplo-v1.xml
<?xml version="1.0" encoding="UTF-8"?> <remotarFeed version="1.0"> <generatedAt>2026-09-22T09:00:00-03:00</generatedAt> <!-- Cada empresa aparece uma vez; as vagas apontam para ela por companyId --> <companies> <company> <id>acme</id> <name>Acme Pagamentos</name> <logoUrl>https://acme.example/logo.png</logoUrl> <website>https://acme.example</website> <description><![CDATA[ <p>A Acme Pagamentos é uma fintech brasileira que simplifica a vida financeira de pequenos negócios.</p> <p>Nossa plataforma processa pagamentos, emite cobranças e concilia recebíveis para mais de 40 mil lojistas em todo o país.</p> <p>Somos um time 100% remoto, com pessoas em 18 estados, e acreditamos em autonomia, documentação e decisões baseadas em dados.</p> ]]></description> </company> <!-- Só os campos obrigatórios --> <company> <id>beta-logistica</id> <name>Beta Logística</name> <logoUrl>https://beta.example/marca.svg</logoUrl> <description><![CDATA[ <p>A Beta Logística conecta indústrias e transportadoras em todo o Sudeste, com rastreamento em tempo real e roteirização inteligente.</p> <p>Com sede em Belo Horizonte, atendemos mais de 300 clientes e temos um time de tecnologia e dados que cresce a cada ano.</p> <p>Trabalhamos em modelo híbrido, com encontros presenciais semanais e flexibilidade no restante da semana.</p> ]]></description> </company> </companies> <jobs> <!-- Vaga remota, com todos os campos opcionais preenchidos --> <job> <id>vaga-10482</id> <companyId>acme</companyId> <title>Pessoa Desenvolvedora Back-end Python Sênior</title> <description><![CDATA[ <p>Buscamos uma pessoa desenvolvedora para evoluir nossa plataforma de pagamentos, que processa milhões de transações por mês.</p> <h3>Responsabilidades</h3> <ul> <li>Projetar e manter APIs em Python (FastAPI)</li> <li>Participar das decisões de arquitetura</li> <li>Acompanhar a operação em produção junto ao time</li> </ul> <h3>Requisitos</h3> <ul> <li>Experiência sólida com Python e PostgreSQL</li> <li>Vivência com filas e mensageria</li> </ul> ]]></description> <applyUrl>https://vagas.ats.example/acme/vaga-10482</applyUrl> <workplace>remote</workplace> <publishedAt>2026-09-18T14:30:00-03:00</publishedAt> <contractType>pj</contractType> <seniority>senior</seniority> <salary> <min>12000</min> <max>16000</max> <currency>BRL</currency> <period>month</period> </salary> <category>Tecnologia</category> <pcd>false</pcd> <benefits> <benefit>Auxílio home office</benefit> <benefit>Plano de saúde</benefit> </benefits> </job> <!-- Vaga híbrida: location é obrigatório --> <job> <id>vaga-10517</id> <companyId>beta-logistica</companyId> <title>Analista de Dados Pleno</title> <description><![CDATA[ <p>Apoie o time comercial com análises, indicadores e dashboards que orientam a expansão da operação.</p> <h3>Requisitos</h3> <ul> <li>SQL avançado e experiência com alguma ferramenta de BI</li> <li>Boa comunicação com áreas de negócio</li> </ul> <p>Você vai estruturar a base de indicadores da área comercial e apoiar as decisões de expansão com análises recorrentes.</p> <p>Modelo híbrido: dois dias por semana no escritório de Belo Horizonte.</p> ]]></description> <applyUrl>https://vagas.ats.example/beta/vaga-10517</applyUrl> <workplace>hybrid</workplace> <location> <city>Belo Horizonte</city> <state>MG</state> </location> <contractType>clt</contractType> </job> <!-- Vaga confidencial: publicada sem nome, logo nem descrição da empresa --> <job> <id>vaga-10533</id> <companyId>acme</companyId> <confidential>true</confidential> <title>Head de Produto</title> <description><![CDATA[ <p>Empresa de tecnologia do setor financeiro busca liderança de produto para conduzir a estratégia de uma das suas principais linhas de negócio.</p> <h3>Requisitos</h3> <ul> <li>Experiência liderando times de produto</li> <li>Vivência com produtos financeiros ou de pagamentos</li> </ul> <p>A pessoa vai liderar um time de oito pessoas, entre produto e design, e responder diretamente à diretoria.</p> ]]></description> <applyUrl>https://vagas.ats.example/v/vaga-10533</applyUrl> <workplace>remote</workplace> </job> </jobs> </remotarFeed>
Esquema remotar-feed-v1.xsd
<?xml version="1.0" encoding="UTF-8"?> <!-- Feed de vagas Remotar — versão 1.0 Esquema do XML que um ATS publica para enviar vagas à Remotar. Guia completo: https://docs.remotar.com.br/feed/ Cada empresa é declarada uma vez em <companies>; cada vaga aponta para ela por <companyId>. Os filhos de <job> e de <company> podem vir em qualquer ordem. Na leitura, cada vaga é conferida sozinha: uma vaga fora deste esquema, ou de uma empresa fora dele, é descartada e as outras seguem. Valide o arquivo inteiro antes de enviar. Campo novo: contato@remotar.com.br. --> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <xs:element name="remotarFeed"> <xs:complexType> <xs:sequence> <xs:element name="generatedAt" type="xs:dateTime"/> <xs:element name="companies"> <xs:complexType> <xs:sequence> <xs:element name="company" type="Company" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="jobs"> <xs:complexType> <xs:sequence> <xs:element name="job" type="Job" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> <xs:attribute name="version" use="required"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:pattern value="1\.[0-9]+"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:complexType> <!-- id de empresa único; toda vaga aponta para uma empresa declarada --> <xs:key name="companyIdChave"> <xs:selector xpath="companies/company"/> <xs:field xpath="id"/> </xs:key> <xs:keyref name="jobCompanyRef" refer="companyIdChave"> <xs:selector xpath="jobs/job"/> <xs:field xpath="companyId"/> </xs:keyref> <xs:unique name="jobIdUnico"> <xs:selector xpath="jobs/job"/> <xs:field xpath="id"/> </xs:unique> </xs:element> <xs:complexType name="Job"> <xs:all> <!-- Obrigatórios --> <xs:element name="id" type="Identificador"/> <xs:element name="title" type="TextoCurto"/> <xs:element name="companyId" type="Identificador"/> <!-- Mínimo de 300 caracteres de texto, conferido na leitura --> <xs:element name="description" type="TextoLongo"/> <xs:element name="applyUrl" type="UrlHttps"/> <xs:element name="workplace" type="Workplace"/> <!-- Obrigatório quando workplace = hybrid --> <xs:element name="location" type="Location" minOccurs="0"/> <!-- Opcionais --> <xs:element name="publishedAt" type="xs:dateTime" minOccurs="0"/> <xs:element name="contractType" type="ContractType" minOccurs="0"/> <xs:element name="seniority" type="Seniority" minOccurs="0"/> <xs:element name="salary" type="Salary" minOccurs="0"/> <xs:element name="category" type="TextoCurto" minOccurs="0"/> <xs:element name="pcd" type="xs:boolean" minOccurs="0"/> <xs:element name="confidential" type="xs:boolean" minOccurs="0"/> <xs:element name="benefits" type="Benefits" minOccurs="0"/> </xs:all> </xs:complexType> <xs:complexType name="Company"> <xs:all> <xs:element name="id" type="Identificador"/> <xs:element name="name" type="TextoCurto"/> <xs:element name="logoUrl" type="UrlHttps"/> <!-- Mínimo de 300 caracteres de texto, conferido na leitura --> <xs:element name="description" type="TextoLongo"/> <xs:element name="website" type="UrlHttp" minOccurs="0"/> </xs:all> </xs:complexType> <xs:complexType name="Location"> <xs:all> <xs:element name="city" type="TextoCurto"/> <xs:element name="state" type="UF"/> </xs:all> </xs:complexType> <xs:complexType name="Salary"> <xs:all> <xs:element name="min" type="xs:nonNegativeInteger" minOccurs="0"/> <xs:element name="max" type="xs:positiveInteger"/> <xs:element name="currency" type="Currency"/> <xs:element name="period" type="SalaryPeriod"/> </xs:all> </xs:complexType> <xs:complexType name="Benefits"> <xs:sequence> <xs:element name="benefit" type="TextoCurto" maxOccurs="50"/> </xs:sequence> </xs:complexType> <!-- Tipos simples --> <xs:simpleType name="Identificador"> <xs:restriction base="xs:string"> <xs:minLength value="1"/> <xs:maxLength value="100"/> <xs:pattern value="[A-Za-z0-9._:\-]+"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="TextoCurto"> <xs:restriction base="xs:string"> <xs:minLength value="1"/> <xs:maxLength value="255"/> <xs:pattern value=".*\S.*"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="TextoLongo"> <xs:restriction base="xs:string"> <xs:minLength value="1"/> <xs:maxLength value="50000"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="UrlHttps"> <xs:restriction base="xs:anyURI"> <xs:pattern value="https://.+"/> <xs:maxLength value="2000"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="UrlHttp"> <xs:restriction base="xs:anyURI"> <xs:pattern value="https?://.+"/> <xs:maxLength value="2000"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="Workplace"> <xs:restriction base="xs:string"> <xs:enumeration value="remote"/> <xs:enumeration value="hybrid"/> <xs:enumeration value="onsite"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="UF"> <xs:restriction base="xs:string"> <xs:enumeration value="AC"/><xs:enumeration value="AL"/><xs:enumeration value="AP"/> <xs:enumeration value="AM"/><xs:enumeration value="BA"/><xs:enumeration value="CE"/> <xs:enumeration value="DF"/><xs:enumeration value="ES"/><xs:enumeration value="GO"/> <xs:enumeration value="MA"/><xs:enumeration value="MT"/><xs:enumeration value="MS"/> <xs:enumeration value="MG"/><xs:enumeration value="PA"/><xs:enumeration value="PB"/> <xs:enumeration value="PR"/><xs:enumeration value="PE"/><xs:enumeration value="PI"/> <xs:enumeration value="RJ"/><xs:enumeration value="RN"/><xs:enumeration value="RS"/> <xs:enumeration value="RO"/><xs:enumeration value="RR"/><xs:enumeration value="SC"/> <xs:enumeration value="SP"/><xs:enumeration value="SE"/><xs:enumeration value="TO"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="ContractType"> <xs:restriction base="xs:string"> <xs:enumeration value="clt"/> <xs:enumeration value="pj"/> <xs:enumeration value="internship"/> <xs:enumeration value="temporary"/> <xs:enumeration value="freelancer"/> <xs:enumeration value="other"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="Seniority"> <xs:restriction base="xs:string"> <xs:enumeration value="internship"/> <xs:enumeration value="junior"/> <xs:enumeration value="mid"/> <xs:enumeration value="senior"/> <xs:enumeration value="specialist"/> <xs:enumeration value="lead"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="Currency"> <xs:restriction base="xs:string"> <xs:enumeration value="BRL"/> <xs:enumeration value="USD"/> <xs:enumeration value="EUR"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="SalaryPeriod"> <xs:restriction base="xs:string"> <xs:enumeration value="hour"/> <xs:enumeration value="month"/> <xs:enumeration value="year"/> </xs:restriction> </xs:simpleType> </xs:schema>