Gupy Jobs Search Scraper: Extract Recruitment Data Effortlessly

---

What Is Gupy?

Gupy is a leading HR tech platform in Latin America, offering recruitment and talent management solutions for companies of all sizes. The platform's job search portal (portal.gupy.io) hosts thousands of active job listings across industries and regions, particularly strong in Brazil and surrounding markets. Manually searching and extracting job data from the portal is inefficient — the Gupy Jobs Search Scraper automates this process, delivering structured recruitment intelligence at scale.

---

Overview

The Gupy Jobs Search Scraper extracts job search results from Gupy's job portal, transforming raw listings into clean, normalized records. It is ideal for:

• Recruiters monitoring competitor activity and talent market dynamics
• HR departments building recruitment databases and talent pipelines
• Data analysts studying job market trends in Latin America
• Platform developers aggregating recruitment data across multiple sources

The scraper handles search queries seamlessly, supports pagination, respects failure handling, and delivers 18+ data fields per job listing with full company and location information.

---

Input Format

The scraper accepts a JSON configuration object:

{
  "urls": [
    "https://portal.gupy.io/job-search/term=design?page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}

Input Parameters

Parameter	Type	Description
urls	Array	Job search result pages to scrape. URLs can include search terms, filters, and page numbers. Example: term=design, term=python&page=3, etc.
ignore_url_failures	Boolean	If true, the scraper continues if individual URLs fail. If false, the entire run stops on the first error. Default: true
max_items_per_url	Integer	Maximum number of job listings to extract per URL. Reduces costs and runtime. Default: 20

Examples:

• Search by keyword: https://portal.gupy.io/job-search/term=design?page=1
• Search with filters: https://portal.gupy.io/job-search/term=python%20developer&page=2
• Pagination: Automatically handle page parameters to crawl multiple result sets

Tip: Use specific search terms to target relevant roles. Combine multiple URLs with different keywords to build a comprehensive dataset.

---

Output Format

Sample output

{
  "id": 11604384,
  "company_id": 68611,
  "name": "Designer de Criativos Sênior",
  "description": "Ei, você, beleza? 💜Já pensou em fazer parte de uma empresa que está transformando os setores de beleza, saúde e cuidado com inovação e propósito? Então vem com a gente no Grupo Ei beleza 🚀✨Se você é uma pessoa criativa, estratégica e apaixonada por beleza: está no lugar certo! 💜Somos um grupo de marcas nativa digital, 100% brasileira, que entrega qualidade de tratamento capilar de referência mundial com preço que cabe na rotina da brasileira. Queremos ser a companhia favorita do dia a dia de quem cuida dos cabelos, com produtos de alta performance, resultado real e uma comunicação que desperta desejo.Aqui, a gente acredita que criatividade e performance caminham juntas. Nossa esteira de criativos desenvolve soluções orientadas por dados, com foco em construir peças que geram resultado em cada ponto de contato da marca.Buscamos uma pessoa sênior, com repertório estético forte e leitura de performance, que saiba equilibrar a linguagem autêntica que engaja com o padrão premium que constrói marca.Aqui, design não é só visual: é solução.Responsabilidades e atribuiçõesObjetivo da vagaEstamos em busca de uma pessoa para ser referência criativa dentro da nossa esteira, com foco no desenvolvimento de vídeos, motion e criativos de alta performance para ads, social e lançamentos. Essa pessoa domina motion e 3D, usa IA como parte natural do seu fluxo e sabe sustentar volume alto sem abrir mão de sofisticação, sem travar entre o \"vídeo perfeito\" e o \"no ar agora\".Procuramos alguém com olhar de marca apurado, que traduza dados de performance em peças que vendem e que ajude a elevar continuamente o padrão da nossa comunicação. Vai trabalhar em ambiente altamente colaborativo, com interface constante entre performance, criação e branding.Como será o seu dia a diaConceber e produzir criativos de alta performance para ads, social e lançamentos, com foco em vídeo e motion.Criar renders 3D e animações que valorizem o sensorial dos produtos (brilho, textura, resultado real).Sustentar o volume da esteira com agilidade: soltar, testar, analisar e iterar em ciclo rápido.Traduzir briefings de performance em variações e \"packs\" de criativos para testes A/B.Garantir consistência visual da marca em todos os canais, com base no Social Guide.Elevar o padrão estético da comunicação, equilibrando linguagem lo-fi/autêntica com peças premium.Utilizar e propor novos fluxos com IA generativa para escalar produção com consistência de marca.Requisitos e qualificaçõesQuem é vocêTem experiência sólida como designer, com domínio real de motion design e 3D (After Effects, Cinema 4D/Blender ou similares).Manda bem em edição de vídeo para redes e ads: conhece o que engaja em formato curto.Tem repertório estético forte e olhar de marca: entende a diferença entre \"varejão\" e premium.É rápido(a) e produtivo(a): entrega volume sem perder qualidade.É proativo(a), organizado(a) e confortável em ambiente dinâmico e orientado a testes.Boa comunicação e facilidade para trabalhar em equipe.O que buscamosGraduação em Design, Publicidade e Propaganda ou áreas afins.Experiência comprovada com criativos de mídia paga e vídeo para performance.Domínio de ferramentas de motion e 3D (After Effects, Cinema 4D/Blender) e do pacote de criação.Experiência com design digital e direção de peças para diferentes canais.Familiaridade com ferramentas de IA aplicadas à criação (Midjourney, Adobe Firefly, ChatGPT, Claude) já incorporada ao fluxo de trabalho.DesejávelVivência com marcas de beleza, cosméticos ou D2C.Familiaridade com métricas de criativos (win rate, ROAS) e lógica de testes de performance.Experiência com pack shots / still de produto e direção de shooting.Informações adicionais🍴 Vale alimentação/refeição no cartão de benefícios da Flash - R$30,00/dia;🚌 Você decide entre vale-transporte ou vale combustível também no cartão Flash (benefício flexível)💲 50% de desconto na compra de qualquer um dos produtos do Grupo Ei, Beleza?🎂 Um dia de folga para celebrar o seu aniversário e voucher para escolher qualquer produto! #DayOff🏥 Plano de Saúde coparticipativo🦷 Plano Odont.💪 TotalPass para se manter saudável🧠 Clude Saúde🎗 Seguro de Vida💲PLR💊 Convênio Farmácia📚 Convênio SESC👕 Dress code flexível: como você é!⏰ Horário FlexívelOferecemos também:🎓 Cultura colaborativa, permitindo um ambiente de trabalho descontraído e propício ao aprendizado e desenvolvimento!🤝 Parceria com Senac Minas e Grupo Ânima.🥧 Snacks, chás e frutas liberados durante todo o dia de trabalho presencial.\"Por que a Ei, Beleza?\"Grupo de marcas D2C que estão mudando o jogo da beleza no Brasil, com crescimento acelerado.Cultura orientada a dados, com autonomia de verdade e resultado na mesa toda semana.Ambiente colaborativo, sem burocracia e com espaço pra construir do zero.O que você faz aqui chega a milhões de pessoas e aparece no resultado.",
  "career_page_id": 165670,
  "career_page_name": "Grupo Ei Beleza",
  "career_page_logo": "https://attachments.gupy.io/production/companies/68611/career/165670/images/2026-02-06_13-13_companyLogoUrl.png",
  "career_page_url": "https://eibeleza.gupy.io/eyJzb3VyY2UiOiJndXB5X3BvcnRhbCJ9",
  "type": "vacancy_type_effective",
  "published_date": "2026-07-09T12:57:35.304Z",
  "application_deadline": "2026-09-06",
  "is_remote_work": false,
  "city": "São Paulo",
  "state": "São Paulo",
  "country": "Brasil",
  "job_url": "https://eibeleza.gupy.io/job/eyJqb2JJZCI6MTE2MDQzODQsInNvdXJjZSI6Imd1cHlfcG9ydGFsIn0=?jobBoardSource=gupy_portal",
  "workplace_type": "on-site",
  "disabilities": true,
  "skills": [],
  "from_url": "https://portal.gupy.io/job-search/term=design?page=2"
}

Each scraped job returns a structured record with 18 fields:

Job Identification

Field	Meaning	Example
ID	Unique Gupy identifier for the job listing	12345abc
Name	Official job title	Senior UX Designer
Job URL	Direct link to the full job posting	https://portal.gupy.io/job-offers/...
Type	Employment contract type	Full-time, Internship, Temporary

Job Content & Requirements

Field	Meaning	Example
Description	Full HTML job description including responsibilities	We are seeking a creative designer...
Skills	Array of required or desired technical/soft skills	["UI Design", "Figma", "Prototyping"]
Disabilities	Indicates if the position is open to people with disabilities	true / false

Work Arrangements

Field	Meaning	Example
Is Remote Work	Whether the role allows remote work	true, false, or hybrid
Workplace Type	Work environment classification	On-site, Remote, Hybrid
City	Job location city	São Paulo
State	Job location state/province	SP
Country	Job location country	Brazil

Company Information

Field	Meaning	Example
Company ID	Unique identifier for the employer	567xyz
Career Page ID	Company's career/jobs page identifier	techcorp-careers
Career Page Name	Displayed name of the company's career portal	TechCorp Careers
Career Page Logo	Logo image URL for the company	https://gupy-cdn.../logo.png
Career Page URL	Direct link to the company's Gupy career page	https://careers.techcorp.com.br

Timing Information

Field	Meaning	Example
Published Date	When the job was posted	2024-01-15
Application Deadline	Closing date for applications	2024-02-28

---

How to Use

1. Build search URLs — Visit portal.gupy.io and create job searches using keywords or filters. Copy the resulting URLs (including search terms and page numbers).
2. Configure input — Paste URLs into the urls array. Adjust max_items_per_url based on your data needs (typically 20–50).
3. Set failure handling — Keep ignore_url_failures: true for production runs to prevent interruptions.
4. Execute the scraper — Start the actor and monitor progress in the run log.
5. Retrieve and export — Download results as JSON, CSV, or Excel; integrate into your database or BI tools.

Best practices:

• Combine multiple search queries to cover different job categories
• Use pagination (e.g., ?page=1, ?page=2) to retrieve all results systematically
• Verify URLs are job search result pages, not individual job postings
• Schedule periodic runs to track hiring trends over time

---

Use Cases & Business Applications

• Recruitment intelligence: Analyze competitor hiring patterns and open roles
• Talent pipeline building: Create datasets of active job opportunities in your industry
• Salary benchmarking: Correlate job titles, skills, and location data with compensation research
• Labor market research: Track hiring demand across regions, job types, and skill sets
• Career planning: Monitor career progression paths and skill requirements in your field

By automating data collection from Gupy's portal, organizations save weeks of manual research and gain structured, actionable insights into the Latin American recruitment market.

---

Conclusion

The Gupy Jobs Search Scraper simplifies access to recruitment data from one of Latin America's largest job platforms. With flexible search configuration, comprehensive 18-field output, and reliable error handling, it empowers recruiters, analysts, and researchers to build powerful talent intelligence workflows. Start scraping today and unlock insights into your competitive recruitment landscape.