Gupy job listings (Brazil)

Collect public Brazilian job listings from Gupy: role, company, city, UF, remote flag, contract type, publication date and URL. Built for recruiters, job boards and growth teams who need a structured feed without maintaining their own collector.

What it does

Reads the public Gupy job listing (by role, city, state and remote flag) and optional company career pages (empresa.gupy.io), then returns normalized jobs up to maxItems.

Why

Brazilian hiring still concentrates on public career pages. This actor turns that listing into a dataset you can schedule.

Input

Parameter	Type	Required	Default	Description
cargo	Array	No*	[]	Role keywords (e.g. desenvolvedor).
cidade	String	No	""	City name.
uf	String	No	""	State abbreviation (SP, PR, …).
remoto	Boolean	No	—	true for remote-only, false to exclude remote.
empresa	String	No*	""	Career-page subdomain (e.g. cogna).
maxItems	Integer	No	50	Maximum jobs to return (cap 500).

* Provide cargo or empresa.

{
  "cargo": ["desenvolvedor"],
  "cidade": "",
  "uf": "",
  "remoto": true,
  "empresa": "",
  "maxItems": 50
}

Output

One dataset item per job.

{
  "titulo": "PESSOA DESENVOLVEDORA FULLSTACK SR",
  "empresa": "Cogna Educação",
  "cidade": "",
  "uf": "",
  "remoto": true,
  "tipo_contrato": "efetivo",
  "data_publicacao": "2026-08-28",
  "url": "https://cogna.gupy.io/job/eyJqb2JJZCI6MTIzMTUwNTgsInNvdXJjZSI6Imd1cHlfcG9ydGFsIn0=?jobBoardSource=gupy_portal",
  "descricao_resumo": "A Cogna é a maior e mais completa organização de soluções educacionais do Brasil. Com atuação dos 2 aos 100 anos, reúne negócios de Educação Básica, Ensino Superior e Educação Continuada...",
  "id": "12315058"
}

Pricing

Pay-per-event: US$ 0.001 per result (result event, one per returned job). Optional run-start event is priced at US$ 0. Failed items are not billed.

Use cases

• Watch a role across public career pages.
• Fill a job board with remote listings in a given UF.
• Snapshot one company's open roles from its career subdomain.

FAQ

Does a live run happen by default? No. Local default is plan / dry-run. Live collection needs --confirm and APIFY_TOKEN or BRAINIALL_API_KEY in the environment.

Are secrets stored in the actor? No. Keys are read at runtime from the environment and never written to files.

Login or captcha? No. Only public listings. If a source starts requiring login, the run fails cleanly.

Limits

• 500 records per run.
• About 1 request/second between pages.
• Public listings only. Empty or blank pages fail with exit code 1. A valid search with zero matches returns zero items.

Environment

• BRAINIALL_API_KEY — optional; read at runtime, never stored in files.
• APIFY_TOKEN — optional; required together with --confirm for a live Apify charge/push.

Local default is plan / dry-run:

$python3 -m src --plan --input input.json

Live collection (strategist machine with real keys):

$BRAINIALL_API_KEY=… APIFY_TOKEN=… python3 -m src --confirm --input input.json

Responsible use

Public job-listing data only. Do not use this actor to harass applicants, bypass access controls or overload public endpoints. Respect robots.txt and the source rate limits. You are responsible for how you store and share the records.

License

MIT — see LICENSE.

---

Português (PT-BR)

O que faz. Coleta vagas públicas do Gupy por cargo, cidade, UF, remoto ou página de carreira da empresa.

Por quê. Recrutamento no Brasil ainda passa pelas páginas públicas de carreira. O ator entrega essa lista em formato de dataset.

Entrada. cargo (lista) ou empresa (subdomínio); cidade, uf, remoto e maxItems opcionais.

Saída. Um item por vaga, campos normalizados (veja o JSON acima).

Preço. US$ 0,001 por resultado. Evento run-start a US$ 0. Item com erro não é cobrado.

Limites. 500 registros por execução, cerca de 1 consulta por segundo. Página em branco falha com código de saída 1.

Uso responsável. Só vagas públicas. Sem assédio, sem furar controle de acesso, sem sobrecarregar as fontes. Quem opera o ator responde pelo armazenamento e pelo envio.