feeddevagas-en

Jobs Feed

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-en/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "feeddevagas-en MCP server": {
    "url": "https://apifeedvagas.vag.as/doc/feeddevagas-en/mcp"
  }
}
Close
GET /api/v1/vacancy_feed.json
Bearer auth

Returns a json with the job information published in Vagas for Business.

The authentication token is passed in the Authorization HTTP header with the Bearer prefix followed by a space.

Query parameters

  • vacancy_ids string

    Filter one or more specific job IDs

  • limit integer

    Number of jobs per page

    Minimum value is 1. Default value is 10.

  • page integer

    Requested page

    Minimum value is 1. Default value is 1.

  • order string

    List order:

    • most_recent - Most recent jobs
    • less_recent - Less recent jobs
    • prc_first - PRC before PETs
    • pet_first - PETs before PRCs

    Values are most_recent, less_recent, prc_first, or pet_first.

  • division_id[] array[integer]

    Division code(s). E.g. division_id[]=11111&division_id[]=22222

  • add_confidential boolean

    Include confidential (private) jobs

    Default value is false.

  • time_period string

    List jobs created within the given time period

    Values are today, yesterday, week, or month.

  • area[] array[integer]

    Job area codes. E.g. area[]=15

    Codes Description
    1 Administração de Empresas (Business Administration)
    2 Advocacia/Jurídica (Law/Legal)
    3 Agronomia (Agronomy)
    4 Arquitetura/Urbanismo (Architecture/Urban Planning)
    5 Auditoria (Audit)
    9 Comércio Exterior (Foreign Trade)
    10 Contabilidade (Accounting)
    11 Controladoria (Controller's Office)
    12 Comunicação (Communication)
    14 Ecologia/Meio Ambiente (Ecology/Environment)
    15 Economia (Economics)
    16 Enfermagem (Nursing)
    17 Engenharia - Outras (Other Engineering)
    18 Ensino - Outros (Teaching - Others)
    19 Esportes (Sports)
    20 Farmácia (Pharmacy)
    21 Finanças (Finance)
    22 Geografia (Geography)
    23 Geologia (Geology)
    24 Informática/T.I. (Information Technology/IT)
    25 Jornalismo (Journalism)
    26 Logística (Logistics)
    27 Marketing (Marketing)
    28 Medicina/Hospitalar (Medicine/Hospital)
    29 Nutrição (Nutrition)
    30 Odontologia (Dentistry)
    31 Produção/Fabricação (Production/Manufacturing)
    32 Propaganda (Advertising)
    33 Psicologia (Psychology)
    34 Organização e Métodos (Organization and Methods)
    35 Qualidade (Quality)
    36 Química (Chemistry)
    37 Recursos Humanos (Human Resources)
    38 Relações Públicas (Public Relations)
    39 Secretariado (Secretarial)
    40 Serviços Gerais (General Services)
    41 Serviço Social (Social Services)
    42 Serviços Técnicos - Outros (Other Technical Services)
    43 Suprimentos (Supplies)
    44 Atend. a cliente - Telemarketing/Call Center (Customer Service - Telemarketing/Call Center)
    45 Vendas (Sales)
    46 Vendas Técnicas (Technical Sales)
    47 Veterinária (Veterinary)
    48 Moda (Fashion)
    49 Desenho Industrial (Industrial Design)
    50 Física (Physics)
    51 Bancos (Banking)
    52 Biomedicina (Biomedicine)
    53 Fisioterapia (Physiotherapy)
    54 Turismo (Tourism)
    55 Fonoaudiologia (Speech Therapy)
    56 Biblioteconomia (Library Science)
    57 Transporte Aéreo (Air Transport)
    58 Organização de Eventos/Produção Cultural (Event Organization/Cultural Production)
    59 Design Gráfico (Graphic Design)
    60 Web Design (Web Design)
    62 Arquivologia (Archival Science)
    63 Manutenção Industrial (Industrial Maintenance)
    64 Gestão Empresarial (Business Management)
    65 Segurança e Saúde no Trabalho (Occupational Health and Safety)
    66 Terapia Ocupacional (Occupational Therapy)
    67 Internet (Internet)
    68 Telecomunicações (Telecommunications)
    69 Artes Cênicas (Performing Arts)
    70 Artes Gráficas (Graphic Arts)
    71 Engenharia Eletrotécnica (Electrotechnical Engineering)
    80 Artes Plásticas (Plastic Arts)
    81 Atend. a cliente - Bares e Restaurantes (Customer Service - Bars and Restaurants)
    82 Vendas - Varejo (Retail Sales)
    83 Atend. a cliente - Telefonistas/Recepcionistas (Customer Service - Telephone Operators/Receptionists)
    84 Atend. a cliente (Customer Service)
    85 Biologia/Ciências Biológicas (Biology/Biological Sciences)
    86 Ciências Sociais (Social Sciences)
    87 Cinema (Cinema/Film)
    88 Construção Civil (Civil Construction)
    89 Culinária/Gastronomia (Culinary/Gastronomy)
    90 Design de Interiores (Interior Design)
    91 Engenharia de Alimentos (Food Engineering)
    92 Engenharia Civil (Civil Engineering)
    93 Engenharia Eletrônica (Electronic Engineering)
    94 Engenharia Mecânica (Mechanical Engineering)
    95 Engenharia de Produção (Production Engineering)
    96 Engenharia Química (Chemical Engineering)
    97 Ensino Superior e Pesquisa (Higher Education and Research)
    98 Filosofia (Philosophy)
    99 História (History)
    100 Hotelaria (Hospitality)
    101 Letras (Literature/Letters)
    102 Matemática/Estatística (Mathematics/Statistics)
    103 Meteorologia (Meteorology)
    104 Museologia (Museology)
    105 Música (Music)
    106 Oceanografia (Oceanography)
    107 Radialismo e Televisão (Radio and Television)
    108 Relações Internacionais (International Relations)
    109 Segurança Patrimonial (Asset Security)
    110 Seguros (Insurance)
    111 Serviços Administrativos (Administrative Services)
    112 Serviços Domésticos (Domestic Services)
    113 Serviços Técnicos - Elétricos (Electrical Technical Services)
    114 Serviços Técnicos - Mecânicos (Mechanical Technical Services)
    115 Tradução/Interpretação (Translation/Interpretation)
    116 Transporte Marítimo (Maritime Transport)
    117 Transporte Terrestre (Land Transport)
    118 Zootecnia (Zootechnics)
    119 Zoologia (Zoology)
    120 Entretenimento (Entertainment)
    121 Terceiro Setor/Responsabilidade Social (Third Sector/Social Responsibility)
    122 Manutenção Predial (Building Maintenance)
    123 Mineração (Mining)
    124 Administração Comercial/Vendas (Commercial Administration/Sales)
    125 Administração Pública (Public Administration)
    126 Compras (Purchasing)
    127 Engenharia Metalúrgica e de Materiais (Metallurgical and Materials Engineering)
    128 Engenharia de Minas (Mining Engineering)
    129 Estética (Aesthetics)
    130 Fiscal (Fiscal)
    131 Serviços Técnicos - Eletrônicos (Electronic Technical Services)
    132 Tributária (Tax)
    133 Serviços Especializados - Açougue (Specialized Services - Butcher Shop)
    134 Serviços Especializados - Padaria/Confeitaria (Specialized Services - Bakery/Confectionery)
    135 Serviços Especializados - Peixaria (Specialized Services - Fish Market)
    136 Pesquisa de Mercado (Market Research)
    137 Petrolífera (Oil and Gas)

    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]

    City name(s) of the jobs. E.g. city[]=Rio de Janeiro&city[]=São Paulo

  • country[] array[string]

    Country name(s) of the jobs. E.g. country[]=Brasil&country[]=México

  • hierarchy[] array[integer]

    Chosen hierarchy codes. E.g. hierarchy[]=30

    Codes Description
    22 Auxiliar/Operacional (Assistant/Operational)
    26 Técnico (Technician)
    28 Estágio (Internship)
    30 Júnior/Trainee (Junior/Trainee)
    40 Pleno (Mid-level)
    50 Sênior (Senior)
    60 Supervisão/Coordenação (Supervision/Coordination)
    70 Gerência (Management)
    80 Diretoria (Directorship)

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

  • pet boolean

    Return only internship/trainee jobs

    Default value is false.

  • pcd boolean

    Return only jobs for people with disabilities

    Default value is false.

  • gptw boolean

    Return only jobs with the GPTW seal

  • gptwbenef boolean

    Return only jobs with GPTW benefits

  • q string

    Free-text search for job description/name

Responses

  • 200 application/json

    Paginated list of jobs

    Hide response attributes Show response attributes object
    • pagination object

      Pagination info

      Hide pagination attributes Show pagination attributes object
      • current_page integer

        Current page

      • total_pages integer

        Total pages

      • total integer

        Total jobs

    • data array[object]

      List of jobs

      Hide data attributes Show data attributes object
      • id integer

        Job ID

      • cargo string

        Job title

      • abertura string(date)

        Job opening date

      • posicoes integer

        Open positions

      • empresa string

        Company

      • descricao string

        Description

      • localizacao string

        Location

      • cidade string

        City

      • hierarquia string

        Hierarchy

      • divisao_id integer

        Division ID

      • exclusiva_para_deficiente boolean

        Flag to mark if job is exclusive for people with disabilities

      • descricao_html string

        Job description with html format

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

        Navigation URL

      • url_navegacao_exclusiva string(uri)

        Exclusive navigation URL

      • url string(uri)

        Job URL

      • areas_da_vaga array[integer]

        Job areas

    • facets object

      Result facets (aggregations)

      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

            Term value

          • descricao string

            Term description

          • count integer

            Number of jobs

      • pcd object

        People with disabilities

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

            Term value

          • descricao string

            Term description

          • count integer

            Number of jobs

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

            Term value

          • descricao string

            Term description

          • count integer

            Number of jobs

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

            Term value

          • descricao string

            Term description

          • count integer

            Number of jobs

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

            Term value

          • descricao string

            Term description

          • count integer

            Number of jobs

      • gptwbenef object

        Great Place to Work benefits

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

            Term value

          • descricao string

            Term description

          • count integer

            Number of jobs

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

            Term value

          • descricao string

            Term description

          • count integer

            Number of jobs

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

            Term value

          • descricao string

            Term description

          • count integer

            Number of jobs

      • 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

            Term value

          • descricao string

            Term description

          • count integer

            Number of jobs

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

            Term value

          • descricao string

            Term description

          • count integer

            Number of jobs

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

            Term value

          • descricao string

            Term description

          • count integer

            Number of jobs
  • 401 application/json

    User not authenticated

    Hide response attribute Show response attribute object
    • error string

      Error message
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 - Programer 1",
      "abertura": "2000-12-31",
      "posicoes": 3,
      "empresa": "Example company",
      "descricao": "Description of the Job",
      "localizacao": "São Paulo / SP / BR",
      "cidade": "São Paulo",
      "hierarquia": "Senior",
      "divisao_id": 55555,
      "exclusiva_para_deficiente": true,
      "descricao_html": "<p> Job description </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": "User not authenticated"
}