Feed de Vagas

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://apifeedvagas.vag.as/doc/feeddevagas-pt/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "feeddevagas-pt MCP server": {
    "url": "https://apifeedvagas.vag.as/doc/feeddevagas-pt/mcp"
  }
}

Close
GET /api/v1/vacancy_feed.json

Retorna um json com as informações das vagas publicadas no Vagas for business.

O Token de autenticação é passado pelo cabeçalho HTTP Authorization com o prefixo Bearer seguido por espaço.

Query parameters

  • vacancy_ids string

    Filtra uma ou mais vagas específicas por ID

  • limit integer

    Número de vagas a serem retornadas por página

    Minimum value is 1. Default value is 10.

  • page integer

    Página da listagem

    Minimum value is 1. Default value is 1.

  • order string

    Ordem de exibição:

    • most_recent - Vagas mais recentes
    • less_recent - Vagas mais antigas
    • prc_first - PRC antes de PETs
    • pet_first - PETs antes de PRCs

    Values are most_recent, less_recent, prc_first, or pet_first.

  • division_id[] array[integer]

    Código(s) da divisão. Ex.: division_id[]=11111&division_id[]=22222

  • add_confidential boolean

    Incluir vagas confidenciais (privadas) ou não

    Default value is false.

  • time_period string

    Listagem das vagas criadas com base no período de tempo recebido

    Values are today, yesterday, week, or month.

  • area[] array[integer]

    Códigos das áreas de atuação relacionadas à vaga. Ex.: area[]=15

    Códigos Descrição
    1 Administração de Empresas
    2 Advocacia/Jurídica
    3 Agronomia
    4 Arquitetura/Urbanismo
    5 Auditoria
    9 Comércio Exterior
    10 Contabilidade
    11 Controladoria
    12 Comunicação
    14 Ecologia/Meio Ambiente
    15 Economia
    16 Enfermagem
    17 Engenharia - Outras
    18 Ensino - Outros
    19 Esportes
    20 Farmácia
    21 Finanças
    22 Geografia
    23 Geologia
    24 Informática/T.I.
    25 Jornalismo
    26 Logística
    27 Marketing
    28 Medicina/Hospitalar
    29 Nutrição
    30 Odontologia
    31 Produção/Fabricação
    32 Propaganda
    33 Psicologia
    34 Organização e Métodos
    35 Qualidade
    36 Química
    37 Recursos Humanos
    38 Relações Públicas
    39 Secretariado
    40 Serviços Gerais
    41 Serviço Social
    42 Serviços Técnicos - Outros
    43 Suprimentos
    44 Atend. a cliente - Telemarketing/Call Center
    45 Vendas
    46 Vendas Técnicas
    47 Veterinária
    48 Moda
    49 Desenho Industrial
    50 Física
    51 Bancos
    52 Biomedicina
    53 Fisioterapia
    54 Turismo
    55 Fonoaudiologia
    56 Biblioteconomia
    57 Transporte Aéreo
    58 Organização de Eventos/Produção Cultural
    59 Design Gráfico
    60 Web Design
    62 Arquivologia
    63 Manutenção Industrial
    64 Gestão Empresarial
    65 Segurança e Saúde no Trabalho
    66 Terapia Ocupacional
    67 Internet
    68 Telecomunicações
    69 Artes Cênicas
    70 Artes Gráficas
    71 Engenharia Eletrotécnica
    80 Artes Plásticas
    81 Atend. a cliente - Bares e Restaurantes
    82 Vendas - Varejo
    83 Atend. a cliente - Telefonistas/Recepcionistas
    84 Atend. a cliente
    85 Biologia/Ciências Biológicas
    86 Ciências Sociais
    87 Cinema
    88 Construção Civil
    89 Culinária/Gastronomia
    90 Design de Interiores
    91 Engenharia de Alimentos
    92 Engenharia Civil
    93 Engenharia Eletrônica
    94 Engenharia Mecânica
    95 Engenharia de Produção
    96 Engenharia Química
    97 Ensino Superior e Pesquisa
    98 Filosofia
    99 História
    100 Hotelaria
    101 Letras
    102 Matemática/Estatística
    103 Meteorologia
    104 Museologia
    105 Música
    106 Oceanografia
    107 Radialismo e Televisão
    108 Relações Internacionais
    109 Segurança Patrimonial
    110 Seguros
    111 Serviços Administrativos
    112 Serviços Domésticos
    113 Serviços Técnicos - Elétricos
    114 Serviços Técnicos - Mecânicos
    115 Tradução/Interpretação
    116 Transporte Marítimo
    117 Transporte Terrestre
    118 Zootecnia
    119 Zoologia
    120 Entretenimento
    121 Terceiro Setor/Responsabilidade Social
    122 Manutenção Predial
    123 Mineração
    124 Administração Comercial/Vendas
    125 Administração Pública
    126 Compras
    127 Engenharia Metalúrgica e de Materiais
    128 Engenharia de Minas
    129 Estética
    130 Fiscal
    131 Serviços Técnicos - Eletrônicos
    132 Tributária
    133 Serviços Especializados - Açougue
    134 Serviços Especializados - Padaria/Confeitaria
    135 Serviços Especializados - Peixaria
    136 Pesquisa de Mercado
    137 Petrolífera

    Values are 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, or 137.

  • city[] array[string]

    Nome(s) da(s) cidade(s) das vagas em exibição. Ex.: city[]=Rio de Janeiro&city[]=São Paulo

  • country[] array[string]

    Nome(s) do(s) país(es) das vagas em exibição. Ex.: country[]=Brasil&country[]=México

  • hierarchy[] array[integer]

    Códigos das hierarquias escolhidas. Ex.: hierarchy[]=30

    Códigos Descrição
    22 Auxiliar/Operacional
    26 Técnico
    28 Estágio
    30 Júnior/Trainee
    40 Pleno
    50 Sênior
    60 Supervisão/Coordenação
    70 Gerência
    80 Diretoria

    Values are 22, 26, 28, 30, 40, 50, 60, 70, or 80.

  • pet boolean

    Retornar apenas as vagas para programas de estágio/trainee

    Default value is false.

  • pcd boolean

    Retornar apenas as vagas para pessoas com deficiência

    Default value is false.

  • gptw boolean

    Retornar apenas as vagas com selo GPTW

  • gptwbenef boolean

    Retornar apenas as vagas com benefícios GPTW

  • q string

    Termo de busca textual para a descrição/nome da vaga

Responses

  • 200 application/json

    Lista paginada de vagas

    Hide response attributes Show response attributes object
    • pagination object

      Informações de paginação

      Hide pagination attributes Show pagination attributes object
      • current_page integer

        Página atual

      • total_pages integer

        Total de páginas

      • total integer

        Total de vagas

    • data array[object]

      Lista de vagas

      Hide data attributes Show data attributes object
      • id integer

        ID da vaga

      • cargo string

        Cargo

      • abertura string(date)

        Data de abertura da vaga

      • posicoes integer

        Número de posições abertas

      • empresa string

        Empresa

      • descricao string

        Descrição

      • localizacao string

        Localização

      • cidade string

        Cidade

      • hierarquia string

        Hierarquia

      • divisao_id integer

        ID da divisão

      • exclusiva_para_deficiente boolean

        Indica se a vaga é exclusiva para pessoas com deficiência

      • descricao_html string

        Descrição da vaga em formato HTML

      • latitude number(double)
      • longitude number(double)
      • url_navegacao_vagascombr string(uri)

        URL de navegação no vagas.com.br

      • url_navegacao_exclusiva string(uri)

        URL de navegação exclusiva

      • url string(uri)

        URL da vaga

      • areas_da_vaga array[integer]

        Códigos das áreas da vaga

    • facets object

      Facetas (agregações) dos resultados

      Hide facets attributes Show facets attributes object
      • p object
        Hide p attribute Show p attribute object
        • terms array[object]
          Hide terms attributes Show terms attributes object
          • term string

            Valor do termo

          • descricao string

            Descrição do termo

          • count integer

            Quantidade de vagas

      • pcd object

        Pessoas com deficiência

        Hide pcd attribute Show pcd attribute object
        • terms array[object]
          Hide terms attributes Show terms attributes object
          • term string

            Valor do termo

          • descricao string

            Descrição do termo

          • count integer

            Quantidade de vagas

      • a object
        Hide a attribute Show a attribute object
        • terms array[object]
          Hide terms attributes Show terms attributes object
          • term string

            Valor do termo

          • descricao string

            Descrição do termo

          • count integer

            Quantidade de vagas

      • b object
        Hide b attribute Show b attribute object
        • terms array[object]
          Hide terms attributes Show terms attributes object
          • term string

            Valor do termo

          • descricao string

            Descrição do termo

          • count integer

            Quantidade de vagas

      • c object
        Hide c attribute Show c attribute object
        • terms array[object]
          Hide terms attributes Show terms attributes object
          • term string

            Valor do termo

          • descricao string

            Descrição do termo

          • count integer

            Quantidade de vagas

      • gptwbenef object

        Benefícios Great Place to Work

        Hide gptwbenef attribute Show gptwbenef attribute object
        • terms array[object]
          Hide terms attributes Show terms attributes object
          • term string

            Valor do termo

          • descricao string

            Descrição do termo

          • count integer

            Quantidade de vagas

      • e object
        Hide e attribute Show e attribute object
        • terms array[object]
          Hide terms attributes Show terms attributes object
          • term string

            Valor do termo

          • descricao string

            Descrição do termo

          • count integer

            Quantidade de vagas

      • h object
        Hide h attribute Show h attribute object
        • terms array[object]
          Hide terms attributes Show terms attributes object
          • term string

            Valor do termo

          • descricao string

            Descrição do termo

          • count integer

            Quantidade de vagas

      • gptw object

        Great Place to Work

        Hide gptw attribute Show gptw attribute object
        • terms array[object]
          Hide terms attributes Show terms attributes object
          • term string

            Valor do termo

          • descricao string

            Descrição do termo

          • count integer

            Quantidade de vagas

      • m object
        Hide m attribute Show m attribute object
        • terms array[object]
          Hide terms attributes Show terms attributes object
          • term string

            Valor do termo

          • descricao string

            Descrição do termo

          • count integer

            Quantidade de vagas

      • v10m object
        Hide v10m attribute Show v10m attribute object
        • terms array[object]
          Hide terms attributes Show terms attributes object
          • term string

            Valor do termo

          • descricao string

            Descrição do termo

          • count integer

            Quantidade de vagas

  • 401 application/json

    Usuário não autenticado

    Hide response attribute Show response attribute object
    • error string

      Mensagem de erro

GET /api/v1/vacancy_feed.json
curl \
 --request GET 'https://feed-vagas.vagas.com.br/api/v1/vacancy_feed.json' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "pagination": {
    "current_page": 1,
    "total_pages": 1,
    "total": 2
  },
  "data": [
    {
      "id": 1111111,
      "cargo": "4440 - Analista 1",
      "abertura": "2000-12-31",
      "posicoes": 3,
      "empresa": "Empresa Modelo",
      "descricao": "Descrição da vaga",
      "localizacao": "São Paulo / SP / BR",
      "cidade": "São Paulo",
      "hierarquia": "Sênior",
      "divisao_id": 55555,
      "exclusiva_para_deficiente": true,
      "descricao_html": "<p> Descrição da vaga </p>",
      "latitude": 12.3456789,
      "longitude": 12.3456789,
      "url_navegacao_vagascombr": "https://www.vagas.com.br/vagas/v1234567",
      "url_navegacao_exclusiva": "https://site.vagas.com.br/PagVagaDirSS.asp?v=1234567&pp=https%3A%2F%2Fsite.vagas.com.br%2FGoHome.asp%3Fv%3D1234567%26j%3Dt%26ne%3D1",
      "url": "https://www.vagas.com.br/vagas/v1234567",
      "areas_da_vaga": [
        14,
        24,
        11
      ]
    }
  ],
  "facets": {
    "p": {
      "terms": [
        {
          "term": "parameter",
          "descricao": "description",
          "count": 2
        }
      ]
    },
    "pcd": {
      "terms": [
        {
          "term": "parameter",
          "descricao": "description",
          "count": 2
        }
      ]
    },
    "a": {
      "terms": [
        {
          "term": "parameter",
          "descricao": "description",
          "count": 2
        }
      ]
    },
    "b": {
      "terms": [
        {
          "term": "parameter",
          "descricao": "description",
          "count": 2
        }
      ]
    },
    "c": {
      "terms": [
        {
          "term": "parameter",
          "descricao": "description",
          "count": 2
        }
      ]
    },
    "gptwbenef": {
      "terms": [
        {
          "term": "parameter",
          "descricao": "description",
          "count": 2
        }
      ]
    },
    "e": {
      "terms": [
        {
          "term": "parameter",
          "descricao": "description",
          "count": 2
        }
      ]
    },
    "h": {
      "terms": [
        {
          "term": "parameter",
          "descricao": "description",
          "count": 2
        }
      ]
    },
    "gptw": {
      "terms": [
        {
          "term": "parameter",
          "descricao": "description",
          "count": 2
        }
      ]
    },
    "m": {
      "terms": [
        {
          "term": "parameter",
          "descricao": "description",
          "count": 2
        }
      ]
    },
    "v10m": {
      "terms": [
        {
          "term": "parameter",
          "descricao": "description",
          "count": 2
        }
      ]
    }
  }
}
Response examples (401)
{
  "error": "Usuário não autenticado"
}