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.