OrbTop

Gupy Brazil Jobs Scraper

JOBSLEAD GENERATION
Try on Apify

Gupy Brazil Jobs Scraper

Scrape job listings from Gupy — Brazil's #1 ATS (Applicant Tracking System) used by 3,000+ enterprises including Itaú, Petrobras, Magalu, PagBank, and Ambev. Extract job title, company name, location, remote/hybrid status, disability eligibility (PCD flag), full HTML description, and direct apply URL.

What it does

This actor queries the Gupy public portal API directly, returning structured job data for any keyword search. Each run produces clean, flat records ready for analysis, recruitment pipelines, or lead generation.

Fields returned per job:

Field Description
id Gupy job ID
companyId Gupy company ID
company_name Company or career page name
company_logo_url Company logo URL
title Job title
description_html Full job description (HTML)
city City
state Brazilian state (full name)
country Country
is_remote_work Fully remote position
workplace_type Modality: remote, hybrid, on-site
disabled_eligible Open to candidates with disabilities (PCD)
published_at Publication date (ISO-8601)
application_deadline Deadline (ISO-8601, null if open)
apply_url Direct apply URL
career_page_url Company career page on Gupy
job_type Vacancy type (e.g. vacancy_type_talent_pool)

How to use

Basic search

Enter a search keyword in Job Search Keyword. The Gupy API requires a keyword — it does not support open-ended browsing.

Common keywords:

  • desenvolvedor — software developers
  • analista — analysts (data, systems, business)
  • engenheiro — engineers
  • designer — UX/UI designers
  • gerente — managers
  • cientista de dados — data scientists

Filters

  • Workplace Type — filter by remote, hybrid, or on-site. Applied client-side after fetching.
  • State Filter — filter by Brazilian state abbreviation (e.g. SP, RJ, MG, RS). Applied server-side.
  • Max Items — cap the number of records returned. Default 100.

Example inputs

Search for remote developer jobs in São Paulo:

{
  "jobName": "desenvolvedor",
  "stateFilter": "SP",
  "workplaceType": "remote",
  "maxItems": 200
}

Search for data analysts nationwide:

{
  "jobName": "analista de dados",
  "maxItems": 500
}

API source

Data comes from https://portal.api.gupy.io/api/v1/jobs — Gupy's public portal API. No authentication or proxy is required. The API is paginated (10 results/page) with offset-based pagination.

Use cases

  • Talent sourcing — build candidate pipeline from Brazil's largest job board aggregator
  • Market research — track hiring trends at Brazilian enterprises by role, city, or company
  • Lead generation — identify companies actively hiring in specific tech stacks
  • Job alerts — run on a schedule to track new postings for specific keywords
  • PCD hiring analysis — filter disabled_eligible: true to find inclusive employers

Notes

  • The Gupy API requires jobName to be non-empty. Use broad terms to maximize coverage.
  • salary_* and seniority_level fields are not available in the portal API response.
  • state values are returned as full Portuguese names (e.g. "São Paulo", "Paraná") not abbreviations.
  • All results come from active, public Gupy job postings. Closed or internal postings are not returned.
Try on Apify