Gupy.io Jobs Scraper: Extract Brazilian Job Listings Instantly

---

What Is Gupy.io?

Gupy.io is one of Brazil's largest talent acquisition and recruitment platforms, hosting thousands of active job postings across industries and regions. Companies use Gupy to post roles and manage applicants; HR professionals and researchers need automated access to this data for market analysis, competitive intelligence, and career tracking. The Gupy.io Jobs Scraper automates extraction from Gupy's job detail pages, delivering clean, structured datasets instantly.

---

Overview

The Gupy Jobs Scraper extracts comprehensive job detail pages from Gupy.io portal URLs, converting individual listings into machine-readable records. It is designed for:

• Recruitment agencies tracking available positions and market trends
• HR analysts building Brazilian labor market datasets
• Career platforms aggregating Gupy listings alongside other sources
• Researchers studying employment patterns in Brazil
• Talent intelligence teams monitoring competitor hiring activity

The scraper handles URL failures gracefully and delivers 30+ structured fields per job, including location, skills, workplace type, and company metadata.

---

Input Format

The scraper accepts a minimal JSON configuration:

{
  "urls": [
    "https://lennycarreiras.gupy.io/job/eyJqb2JJZCI6MTE2MjkyNjAsInNvdXJjZSI6Imd1cHlfcG9ydGFsIn0=?jobBoardSource=gupy_portal"
  ],
  "ignore_url_failures": true
}

Field	Description
urls	Direct links to Gupy job detail pages (e.g., company career portal URLs)
ignore_url_failures	If true, the scraper continues running even if some URLs fail, avoiding interruptions on large batches

Important: Use full job detail URLs from Gupy portals. These typically follow the pattern https://[company].gupy.io/job/[encoded_id]?jobBoardSource=gupy_portal.

---

Output Format

Sample output

{
  "id": 11629260,
  "name": "Designer JR | Marketing",
  "description": "<p>Com o DNA diretamente ligado à moda e à arte, acreditamos em inspirações que acompanham a evolução do comportamento humano.</p><p>&nbsp;</p><p>E com isso, buscamos para fazer parte da nossa equipe de talentos pessoas diversas, encantadoras e que sejam fonte de energia e ideias.</p><p><br></p><p>Se identificou?&nbsp;Venha fazer parte!</p><p>&nbsp;</p><p>Há 30 anos LENNY NIEMEYER representa a moda praia brasileira.&nbsp;O&nbsp;<em style=\"color: black;\">lifestyle</em>&nbsp;carioca é característica marcante das&nbsp;peças que vão além dos biquínis e maiôs, com moda pós-praia como roupas, bolsas e sapatos.</p><p>&nbsp;</p><p>A sede está localizada em São Cristóvão, no Rio de Janeiro. Atualmente existem mais de 20 lojas distribuídas pelo país. A marca também exporta para diversos países, como Estados Unidos, Inglaterra, França, Espanha, Itália, Japão, Turquia, Portugal e Dubai.</p>",
  "prerequisites": "<ul><li>Formação completa ou em andamento em Design Gráfico, Design Digital, Comunicação Visual ou&nbsp;áreas correlatas.</li><li>Domínio do pacote Adobe (Photoshop, Illustrator e InDesign);</li><li>Conhecimento em Figma;</li><li>Noções de edição de vídeo (Premiere ou CapCut) serão consideradas um diferencial;</li><li>Organização, atenção aos detalhes e boa gestão de prioridades;</li><li>Interesse por moda, branding, design e tendências visuais.</li></ul>",
  "handicapped": true,
  "url_picture": "https://attachments.gupy.io/production/companies/61450/images/jobs/11629107/20260713080256319_picture.png",
  "address_line": "Rua Major Fonseca, 21, Rio de Janeiro, Rio de Janeiro, Brasil, 20920-040",
  "address_city": "Rio de Janeiro",
  "address_state": "Rio de Janeiro",
  "address_state_short_name": "RJ",
  "address_country": "Brasil",
  "job_language": null,
  "job_type": "vacancy_type_effective",
  "job_steps": [
    {
      "id": 68937959,
      "name": "Cadastro",
      "order": 0,
      "type": "register",
      "category": "registration"
    },
    {
      "id": 68937958,
      "name": "Entrevista com RH",
      "order": 1,
      "type": "offline",
      "category": "interview"
    },
    {
      "id": 68937962,
      "name": "Entrevista com Gerente",
      "order": 2,
      "type": "offline",
      "category": "interview"
    },
    {
      "id": 68937961,
      "name": "Etapa de teste",
      "order": 3,
      "type": "offline",
      "category": "evaluation"
    },
    {
      "id": 68937960,
      "name": "Contratação",
      "order": 100,
      "type": "final",
      "category": "hiring"
    }
  ],
  "responsibilities": "<ul><li>&nbsp;Desenvolver peças para mídias digitais (Instagram, Facebook, Pinterest, LinkedIn, CRM e mídia paga);</li><li> Criar materiais para e-commerce, aplicativo e website;</li><li>Desenvolver materiais de comunicação para lojas (VM, vitrines, sinalização e PDV);</li><li>Apoiar a criação de apresentações institucionais, comerciais e de projetos especiais;</li><li>Adaptar campanhas para diferentes formatos e canais de comunicação;</li><li>Produzir materiais gráficos para eventos, ativações, lançamentos e parcerias;</li><li>Apoiar na organização e manutenção dos arquivos criativos da marca;</li><li>Garantir a correta aplicação da identidade visual da Lenny Niemeyer em todos os materiais;</li><li>Realizar tratamento básico de imagens e preparação de arquivos para impressão e produção;</li><li>Trabalhar em parceria com as áreas de Marketing, Branding, CRM, E-commerce, VM e Trade&nbsp;Marketing para atender às demandas do calendário comercial.</li></ul><p><br></p>",
  "relevant_experiences": "",
  "url_smartphone_picture": null,
  "url_social_picture": "https://attachments.gupy.io/production/companies/61450/images/jobs/11629107/20260713080332851_socialPicture.png",
  "status": "published",
  "code": "61450-11629260",
  "reason": "staff_replacement",
  "published_at": "2026-07-13T20:07:00.018Z",
  "question_form": null,
  "quick_apply": false,
  "expires_at": "2026-08-07",
  "workplace_type": "hybrid",
  "publication_type": "external",
  "video_section_title": null,
  "video_url": null,
  "skills": null,
  "address_country_short_name": "BR",
  "register_end_date": "2026-08-07",
  "is_job_posted_on_google": true,
  "is_internal_mobility": false,
  "company": {
    "id": 61450,
    "timezone": "America/Sao_Paulo",
    "subdomain": "lennyniemeyer",
    "language": "pt"
  },
  "required_fields": null,
  "career_page": {
    "name": "LENNY NIEMEYER",
    "url_logo": "https://attachments.gupy.io/production/companies/61450/career/138412/images/2023-02-24_16-21_companyLogoUrl.png",
    "url_site": "",
    "company_description_title": "SOBRE NÓS: ",
    "about": "<p>Lenny Niemeyer iniciou sua carreira de estilista em 1979 produzindo biquínis para grifes como Fiorucci, Bee, Richards e Andrea Saletto. Em 1991, Lenny decidiu criar sua própria marca, e no mesmo ano abriu sua primeira loja em Ipanema, no Rio de Janeiro.</p><p><br></p><p>A marca, que leva seu próprio nome, nasceu para fazer <em>resortwear </em>para uma mulher elegante, que quer se sentir confortável e feminina sem se prender a tendências, tendo o lifestyle carioca como característica marcante das suas peças.</p><p>&nbsp;</p><p>A sede está localizada em São Cristóvão, no Rio de Janeiro. Atualmente existem mais de 20 lojas distribuídas pelo país. A marca também exporta para diversos países, como Estados Unidos, Inglaterra, França, Espanha, Itália, Japão, Turquia, Portugal e Dubai.</p><p><br></p><p>Lenny Niemeyer vem representando a moda praia brasileira nas semanas de moda mais expressivas do país, e comemorou os 30 anos da marca em um desfile icônico no São Paulo Fashion Week.</p><p><br></p><p class=\"ql-align-justify\">Para conhecer mais sobre o mundo da Lenny, acesse o nosso Blog:</p><p class=\"ql-align-justify\"><br></p><p class=\"ql-align-justify\"><a target=\"_blank\" rel=\"noreferrer noopener\" key=\"link1\" href=https://www.mundolenny.com.br/>https://www.mundolenny.com.br/</a></p>",
    "subdomain": "lennycarreiras",
    "url_main_image": "https://attachments.gupy.io/production/companies/61450/career/138412/images/2025-12-17_19-59_bannerUrl.jpg",
    "social_picture_url": "https://attachments.gupy.io/production/companies/61450/career/138412/images/2023-03-24_21-15_sharingMetadataImage.jpg",
    "social_links": {
      "type": "social_links_section",
      "section_title": "Conheça mais sobre nós",
      "url_site": "https://www.lennyniemeyer.com.br/",
      "url_linkedin": "https://www.linkedin.com/company/lennyniemeyer",
      "url_instagram": "https://www.instagram.com/lennyniemeyer"
    },
    "visibility": "public",
    "appearances": {
      "id": 26467,
      "career_page_id": 138412,
      "company_logo_url": "https://attachments.gupy.io/production/companies/61450/career/138412/images/2023-02-24_16-21_companyLogoUrl.png",
      "banner_url": "https://attachments.gupy.io/production/companies/61450/career/138412/images/2025-12-17_19-59_bannerUrl.jpg",
      "colors_config": {
        "link_color": "#13335f",
        "button_font_color": "#ffffff",
        "button_background_color": "#3A3A3A"
      }
    }
  },
  "company_integrations": {
    "ga_tracking_code": ""
  }
}

Each scraped job returns a comprehensive record with 34 fields covering job details, location, media, dates, and company information:

Job Identification & Core Info

Field	Meaning
ID	Unique job identifier in the Gupy system
Name	Job title as displayed on the listing
Code	Internal job reference or posting code
Description	Full HTML job description
URL Picture	Primary job listing image URL
URL Smartphone Picture	Mobile-optimized image URL
URL Social Picture	Social media preview image URL

Job Requirements & Details

Field	Meaning
Prerequisites	Baseline qualifications required
Responsibilities	Main duties and tasks for the role
Relevant Experiences	Previous experience expected or preferred
Skills	List of required and nice-to-have competencies
Required Fields	Mandatory application form fields from the employer
Job Language	Language(s) in which the job is posted
Handicapped	Whether the role is open to persons with disabilities
Question Form	Custom questions applicants must answer

Location & Workplace

Field	Meaning
Address Line	Street address of the job location
Address City	City name (e.g., São Paulo, Rio de Janeiro)
Address State	State name (e.g., São Paulo State)
Address State Short Name	State abbreviation (e.g., SP, RJ)
Address Country	Country name (typically Brazil)
Address Country Short Name	Country code (e.g., BR)
Workplace Type	Work arrangement (e.g., on-site, hybrid, remote)

Employment Details

Field	Meaning
Job Type	Contract type (e.g., full-time, temporary, CLT)
Job Steps	Hiring process stages and timelines
Publication Type	How the job was published (internal mobility, external, etc.)
Is Internal Mobility	Whether the role is open only to current employees

Dates & Availability

Field	Meaning
Published At	When the listing was published
Expires At	Application deadline or listing expiration date
Register End Date	Final date to register/apply

Company & Career Details

Field	Meaning
Company	Employer name and company metadata
Career Page	Link to the company's career page on Gupy
Company Integrations	External integrations linked to the company profile

Status & Media

Field	Meaning
Status	Current listing status (active, closed, archived)
Reason	Reason for status (e.g., filled, expired)
Quick Apply	Whether one-click application is enabled
Is Job Posted On Google	Whether the listing appears in Google Jobs
Video Section Title	Title of any embedded video (if present)
Video URL	URL to a video overview of the role

---

How to Use

1. Find job URLs — Visit Gupy.io or a company's Gupy career portal and open individual job detail pages. Copy the full URL including the encoded job ID and query parameters.
2. Prepare your list — Add URLs to the urls array, one per line or as a comma-separated list.
3. Enable error tolerance — Set ignore_url_failures: true to skip broken or removed listings without stopping the entire run.
4. Execute — Launch the scraper and monitor progress in the run log.
5. Retrieve results — Download the output as JSON, CSV, or Excel for analysis or import.

Troubleshooting:

• Verify URLs are job detail pages, not search results or career page home URLs.
• If a URL fails, check that it is still active on Gupy (the listing may have expired).
• Use ignore_url_failures: true for batch runs to ensure completion even with broken links.

---

Use Cases & Business Value

• Market intelligence: Monitor hiring activity by industry, region, and company size across Brazil
• Competitive analysis: Track competitor job postings, titles, salary ranges, and required skills
• Career aggregation: Feed Gupy listings into multi-source job boards or career apps
• Academic research: Analyze employment trends, skill demands, and workplace flexibility in Brazil
• Recruitment metrics: Build datasets for candidate sourcing and funnel analysis

The Gupy Jobs Scraper eliminates manual copying and pasting, delivering clean, actionable data ready for spreadsheets, databases, or business intelligence tools.

---

Conclusion

The Gupy.io Jobs Scraper is your automated solution for accessing Brazil's richest source of job listings. With 34 structured output fields and resilient error handling, it transforms recruitment research from hours of manual work into seconds. Start scraping today and unlock data-driven insights into the Brazilian job market.