{"openapi":"3.0.3","info":{"title":"API Feed Vagas","version":"1.0.0","description":"O Feed de vagas é um link configurável, disponível para que os clientes possam incluir em sua intranet ou site as vagas veiculadas no sistema Vagas for business por meio de uma chamada HTTP para a API Vagas.\n\n## Token para autenticação\nPara ter acesso as rotas da API é necessário um token de autenticação, fornecido pela equipe do Vagas.\n"},"servers":[{"url":"https://feed-vagas.vagas.com.br"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Feed de Vagas","description":"Consulta das vagas publicadas no Vagas for business."}],"paths":{"/api/v1/vacancy_feed.json":{"get":{"tags":["Feed de Vagas"],"operationId":"getVacancyFeed","summary":"Feed de Vagas","description":"Retorna um json com as informações das vagas publicadas no Vagas for business.\n\nO Token de autenticação é passado pelo cabeçalho HTTP `Authorization` com o prefixo `Bearer` seguido por espaço.\n","parameters":[{"name":"vacancy_ids","in":"query","required":false,"description":"Filtra uma ou mais vagas específicas por ID","schema":{"type":"string"},"example":"1111111"},{"name":"limit","in":"query","required":false,"description":"Número de vagas a serem retornadas por página","schema":{"type":"integer","default":10,"minimum":1},"example":10},{"name":"page","in":"query","required":false,"description":"Página da listagem","schema":{"type":"integer","default":1,"minimum":1},"example":1},{"name":"order","in":"query","required":false,"description":"Ordem de exibição:\n\n- `most_recent` - Vagas mais recentes\n- `less_recent` - Vagas mais antigas\n- `prc_first` - PRC antes de PETs\n- `pet_first` - PETs antes de PRCs\n","schema":{"type":"string","enum":["most_recent","less_recent","prc_first","pet_first"]},"example":"most_recent"},{"name":"division_id[]","in":"query","required":false,"description":"Código(s) da divisão. Ex.: `division_id[]=11111\u0026division_id[]=22222`","style":"form","explode":true,"schema":{"type":"array","items":{"type":"integer"}},"example":[11111,22222]},{"name":"add_confidential","in":"query","required":false,"description":"Incluir vagas confidenciais (privadas) ou não","schema":{"type":"boolean","default":false},"example":true},{"name":"time_period","in":"query","required":false,"description":"Listagem das vagas criadas com base no período de tempo recebido","schema":{"type":"string","enum":["today","yesterday","week","month"]},"example":"today"},{"name":"area[]","in":"query","required":false,"description":"Códigos das áreas de atuação relacionadas à vaga. Ex.: `area[]=15`\n\n| Códigos | Descrição |\n|---|---|\n| `1` | Administração de Empresas |\n| `2` | Advocacia/Jurídica |\n| `3` | Agronomia |\n| `4` | Arquitetura/Urbanismo |\n| `5` | Auditoria |\n| `9` | Comércio Exterior |\n| `10` | Contabilidade |\n| `11` | Controladoria |\n| `12` | Comunicação |\n| `14` | Ecologia/Meio Ambiente |\n| `15` | Economia |\n| `16` | Enfermagem |\n| `17` | Engenharia - Outras |\n| `18` | Ensino - Outros |\n| `19` | Esportes |\n| `20` | Farmácia |\n| `21` | Finanças |\n| `22` | Geografia |\n| `23` | Geologia |\n| `24` | Informática/T.I. |\n| `25` | Jornalismo |\n| `26` | Logística |\n| `27` | Marketing |\n| `28` | Medicina/Hospitalar |\n| `29` | Nutrição |\n| `30` | Odontologia |\n| `31` | Produção/Fabricação |\n| `32` | Propaganda |\n| `33` | Psicologia |\n| `34` | Organização e Métodos |\n| `35` | Qualidade |\n| `36` | Química |\n| `37` | Recursos Humanos |\n| `38` | Relações Públicas |\n| `39` | Secretariado |\n| `40` | Serviços Gerais |\n| `41` | Serviço Social |\n| `42` | Serviços Técnicos - Outros |\n| `43` | Suprimentos |\n| `44` | Atend. a cliente - Telemarketing/Call Center |\n| `45` | Vendas |\n| `46` | Vendas Técnicas |\n| `47` | Veterinária |\n| `48` | Moda |\n| `49` | Desenho Industrial |\n| `50` | Física |\n| `51` | Bancos |\n| `52` | Biomedicina |\n| `53` | Fisioterapia |\n| `54` | Turismo |\n| `55` | Fonoaudiologia |\n| `56` | Biblioteconomia |\n| `57` | Transporte Aéreo |\n| `58` | Organização de Eventos/Produção Cultural |\n| `59` | Design Gráfico |\n| `60` | Web Design |\n| `62` | Arquivologia |\n| `63` | Manutenção Industrial |\n| `64` | Gestão Empresarial |\n| `65` | Segurança e Saúde no Trabalho |\n| `66` | Terapia Ocupacional |\n| `67` | Internet |\n| `68` | Telecomunicações |\n| `69` | Artes Cênicas |\n| `70` | Artes Gráficas |\n| `71` | Engenharia Eletrotécnica |\n| `80` | Artes Plásticas |\n| `81` | Atend. a cliente - Bares e Restaurantes |\n| `82` | Vendas - Varejo |\n| `83` | Atend. a cliente - Telefonistas/Recepcionistas |\n| `84` | Atend. a cliente |\n| `85` | Biologia/Ciências Biológicas |\n| `86` | Ciências Sociais |\n| `87` | Cinema |\n| `88` | Construção Civil |\n| `89` | Culinária/Gastronomia |\n| `90` | Design de Interiores |\n| `91` | Engenharia de Alimentos |\n| `92` | Engenharia Civil |\n| `93` | Engenharia Eletrônica |\n| `94` | Engenharia Mecânica |\n| `95` | Engenharia de Produção |\n| `96` | Engenharia Química |\n| `97` | Ensino Superior e Pesquisa |\n| `98` | Filosofia |\n| `99` | História |\n| `100` | Hotelaria |\n| `101` | Letras |\n| `102` | Matemática/Estatística |\n| `103` | Meteorologia |\n| `104` | Museologia |\n| `105` | Música |\n| `106` | Oceanografia |\n| `107` | Radialismo e Televisão |\n| `108` | Relações Internacionais |\n| `109` | Segurança Patrimonial |\n| `110` | Seguros |\n| `111` | Serviços Administrativos |\n| `112` | Serviços Domésticos |\n| `113` | Serviços Técnicos - Elétricos |\n| `114` | Serviços Técnicos - Mecânicos |\n| `115` | Tradução/Interpretação |\n| `116` | Transporte Marítimo |\n| `117` | Transporte Terrestre |\n| `118` | Zootecnia |\n| `119` | Zoologia |\n| `120` | Entretenimento |\n| `121` | Terceiro Setor/Responsabilidade Social |\n| `122` | Manutenção Predial |\n| `123` | Mineração |\n| `124` | Administração Comercial/Vendas |\n| `125` | Administração Pública |\n| `126` | Compras |\n| `127` | Engenharia Metalúrgica e de Materiais |\n| `128` | Engenharia de Minas |\n| `129` | Estética |\n| `130` | Fiscal |\n| `131` | Serviços Técnicos - Eletrônicos |\n| `132` | Tributária |\n| `133` | Serviços Especializados - Açougue |\n| `134` | Serviços Especializados - Padaria/Confeitaria |\n| `135` | Serviços Especializados - Peixaria |\n| `136` | Pesquisa de Mercado |\n| `137` | Petrolífera |\n","style":"form","explode":true,"schema":{"type":"array","items":{"type":"integer","enum":[1,2,3,4,5,9,10,11,12,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,62,63,64,65,66,67,68,69,70,71,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137]}},"example":[15]},{"name":"city[]","in":"query","required":false,"description":"Nome(s) da(s) cidade(s) das vagas em exibição. Ex.: `city[]=Rio de Janeiro\u0026city[]=São Paulo`","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"}},"example":["Rio de Janeiro","São Paulo"]},{"name":"country[]","in":"query","required":false,"description":"Nome(s) do(s) país(es) das vagas em exibição. Ex.: `country[]=Brasil\u0026country[]=México`","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"}},"example":["Brasil","México"]},{"name":"hierarchy[]","in":"query","required":false,"description":"Códigos das hierarquias escolhidas. Ex.: `hierarchy[]=30`\n\n| Códigos | Descrição |\n|---|---|\n| `22` | Auxiliar/Operacional |\n| `26` | Técnico |\n| `28` | Estágio |\n| `30` | Júnior/Trainee |\n| `40` | Pleno |\n| `50` | Sênior |\n| `60` | Supervisão/Coordenação |\n| `70` | Gerência |\n| `80` | Diretoria |\n","style":"form","explode":true,"schema":{"type":"array","items":{"type":"integer","enum":[22,26,28,30,40,50,60,70,80]}},"example":[30]},{"name":"pet","in":"query","required":false,"description":"Retornar apenas as vagas para programas de estágio/trainee","schema":{"type":"boolean","default":false},"example":true},{"name":"pcd","in":"query","required":false,"description":"Retornar apenas as vagas para pessoas com deficiência","schema":{"type":"boolean","default":false},"example":true},{"name":"gptw","in":"query","required":false,"description":"Retornar apenas as vagas com selo GPTW","schema":{"type":"boolean"}},{"name":"gptwbenef","in":"query","required":false,"description":"Retornar apenas as vagas com benefícios GPTW","schema":{"type":"boolean"}},{"name":"q","in":"query","required":false,"description":"Termo de busca textual para a descrição/nome da vaga","schema":{"type":"string"},"example":"analista"}],"responses":{"200":{"description":"Lista paginada de vagas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VacancyResponseOk"}}}},"401":{"description":"Usuário não autenticado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VagasResponseUnauthorized"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Token fornecido pela equipe do Vagas, enviado no cabeçalho `Authorization: Bearer \u003cauth_token\u003e`."}},"schemas":{"VacancyResponseOk":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","description":"Lista de vagas","items":{"$ref":"#/components/schemas/Vacancy"}},"facets":{"$ref":"#/components/schemas/Facets"}}},"Pagination":{"type":"object","description":"Informações de paginação","properties":{"current_page":{"type":"integer","description":"Página atual","example":1},"total_pages":{"type":"integer","description":"Total de páginas","example":1},"total":{"type":"integer","description":"Total de vagas","example":2}}},"Vacancy":{"type":"object","properties":{"id":{"type":"integer","description":"ID da vaga","example":1111111},"cargo":{"type":"string","description":"Cargo","example":"4440 - Analista 1"},"abertura":{"type":"string","description":"Data de abertura da vaga","example":"2000-12-31","format":"date"},"posicoes":{"type":"integer","description":"Número de posições abertas","example":3},"empresa":{"type":"string","description":"Empresa","example":"Empresa Modelo"},"descricao":{"type":"string","description":"Descrição","example":"Descrição da vaga"},"localizacao":{"type":"string","description":"Localização","example":"São Paulo / SP / BR"},"cidade":{"type":"string","description":"Cidade","example":"São Paulo"},"hierarquia":{"type":"string","description":"Hierarquia","example":"Sênior"},"divisao_id":{"type":"integer","description":"ID da divisão","example":55555},"exclusiva_para_deficiente":{"type":"boolean","description":"Indica se a vaga é exclusiva para pessoas com deficiência","example":true},"descricao_html":{"type":"string","description":"Descrição da vaga em formato HTML","example":"\u003cp\u003e Descrição da vaga \u003c/p\u003e"},"latitude":{"type":"number","format":"double","example":12.3456789},"longitude":{"type":"number","format":"double","example":12.3456789},"url_navegacao_vagascombr":{"type":"string","description":"URL de navegação no vagas.com.br","example":"https://www.vagas.com.br/vagas/v1234567","format":"uri"},"url_navegacao_exclusiva":{"type":"string","description":"URL de navegação exclusiva","example":"https://site.vagas.com.br/PagVagaDirSS.asp?v=1234567\u0026pp=https%3A%2F%2Fsite.vagas.com.br%2FGoHome.asp%3Fv%3D1234567%26j%3Dt%26ne%3D1","format":"uri"},"url":{"type":"string","description":"URL da vaga","example":"https://www.vagas.com.br/vagas/v1234567","format":"uri"},"areas_da_vaga":{"type":"array","description":"Códigos das áreas da vaga","items":{"type":"integer"},"example":[14,24,11]}}},"Term":{"type":"object","properties":{"term":{"type":"string","description":"Valor do termo","example":"parameter"},"descricao":{"type":"string","description":"Descrição do termo","example":"description"},"count":{"type":"integer","description":"Quantidade de vagas","example":2}}},"FacetTerms":{"type":"object","properties":{"terms":{"type":"array","items":{"$ref":"#/components/schemas/Term"}}}},"Facets":{"type":"object","description":"Facetas (agregações) dos resultados","properties":{"p":{"$ref":"#/components/schemas/FacetTerms"},"pcd":{"description":"Pessoas com deficiência","allOf":[{"$ref":"#/components/schemas/FacetTerms"}]},"a":{"$ref":"#/components/schemas/FacetTerms"},"b":{"$ref":"#/components/schemas/FacetTerms"},"c":{"$ref":"#/components/schemas/FacetTerms"},"gptwbenef":{"description":"Benefícios Great Place to Work","allOf":[{"$ref":"#/components/schemas/FacetTerms"}]},"e":{"$ref":"#/components/schemas/FacetTerms"},"h":{"$ref":"#/components/schemas/FacetTerms"},"gptw":{"description":"Great Place to Work","allOf":[{"$ref":"#/components/schemas/FacetTerms"}]},"m":{"$ref":"#/components/schemas/FacetTerms"},"v10m":{"$ref":"#/components/schemas/FacetTerms"}}},"VagasResponseUnauthorized":{"type":"object","properties":{"error":{"type":"string","description":"Mensagem de erro","example":"Usuário não autenticado"}}}}}}