Gupy Jobs Scraper (Brazil)

Scrape job listings from Gupy — Brazil's #1 applicant-tracking system and public job board (portal.gupy.io) — by keyword search, with an optional Brazilian-state filter. Returns clean, structured data for each job: title, company, city/state, workplace type, application URL, published date, application deadline, description, skills and more.

Unofficial. This Actor is not affiliated with, authorized, or endorsed by Gupy (Gupy Tecnologia). It is an independent tool that retrieves publicly available data from Gupy's public job portal. Use it in compliance with Gupy's terms and all applicable laws; you are responsible for how you use the retrieved data.

What it does

• Keyword search — give one or more keywords (Portuguese works best, e.g. desenvolvedor, analista, enfermeiro); the Actor paginates Gupy's open-jobs results for each. Leave keywords empty to list all open jobs.
• State filter (optional) — restrict results to a single Brazilian state using Gupy's exact state name (e.g. São Paulo, Rio de Janeiro, Minas Gerais).

No API key is required — Gupy's job-board endpoint is public and unauthenticated.

Input

Field	Type	Default	Description
searchKeywords	string[]	["desenvolvedor"]	Keywords to search. Each is paginated independently. Leave empty to list all open jobs.
state	string	""	Optional Brazilian state, using Gupy's exact name (e.g. São Paulo). Applies to every keyword.
maxItems	integer	20	Max total jobs across all keywords.

Example input

{
  "searchKeywords": ["desenvolvedor", "analista de dados"],
  "state": "São Paulo",
  "maxItems": 200
}

Output

One dataset item per job:

{
  "id": 11427362,
  "title": "DESENVOLVEDOR SERVICENOW",
  "company": "Stefanini Group",
  "companyId": 39703,
  "url": "https://stefanini.gupy.io/jobs/11427362",
  "careerPageUrl": "https://stefanini.gupy.io",
  "careerPageName": "Stefanini Group",
  "careerPageLogo": "https://...",
  "city": "São Paulo",
  "state": "São Paulo",
  "country": "Brasil",
  "workplaceType": "remote",
  "isRemoteWork": true,
  "type": "vacancy_type_effective",
  "publishedDate": "2026-06-03T23:04:54.969Z",
  "applicationDeadline": "2026-08-02",
  "description": "Na Stefanini, acreditamos no poder da colaboração...",
  "skills": [],
  "badges": { "friendlyBadge": true, "isPWD": true },
  "disabilities": true,
  "source": "search:desenvolvedor"
}

Notes

• Data is sourced live from Gupy's public portal; the Actor retries transient blocks (rate limits / edge errors) with exponential backoff.
• Jobs are de-duplicated by id within a run.
• Pagination uses the endpoint's offset / limit and stops at the reported total.