# Gupy Jobs Scraper — Brazil Jobs (portal.gupy.io) (`hipersoft/gupy-jobs-scraper`) Actor

Scrape Brazilian job listings from Gupy (portal.gupy.io): title, company, full description, job type (CLT, internship, PJ, trainee…), remote/hybrid/on-site, city, state, publish date and application deadline. Filter by keyword, state, city and type. Export CSV/JSON.

- **URL**: https://apify.com/hipersoft/gupy-jobs-scraper.md
- **Developed by:** [hiper soft](https://apify.com/hipersoft) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.00075 / job

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Gupy Jobs Scraper: Brazil Job Listings from portal.gupy.io (Vagas Gupy)

**Gupy Jobs Scraper** extracts job listings from **Gupy (portal.gupy.io)**, Brazil's largest recruiting platform, used by thousands of employers such as Ambev, Vivara, Itaú, Magazine Luiza and Localiza. Every job includes the **title, company, company logo and career page, full job description, contract type (CLT/efetivo, estágio, jovem aprendiz, trainee, PJ, temporário…), workplace (remoto, híbrido, presencial), city, state, publish date and application deadline**. Search **vagas** by keyword, state or city and export to **CSV, Excel or JSON**.

### What does Gupy Jobs Scraper do?

Gupy powers the career pages of a large share of Brazilian companies, and the Gupy job portal lists their open positions in one place. This scraper turns any Gupy search into a clean dataset:

- 🇧🇷 **Search any keyword** in Portuguese or English: analista, vendedor, desenvolvedor, estágio, python, enfermeiro.
- 📍 **Filter by state and city**: São Paulo, Rio de Janeiro, Minas Gerais, Curitiba, Campinas and more.
- 🏠 **Remote, hybrid or on-site** jobs (vagas remotas, híbridas, presenciais).
- 📄 **Contract type**: CLT/efetivo, internship (estágio), apprentice (jovem aprendiz), trainee, temporary, PJ/associate, freelancer, talent pool.
- 📝 **Full job description** with responsibilities, requirements and benefits.
- 🏢 **Company name, logo and Gupy career page** for every job.
- 📅 **Publish date and application deadline** for fresh-job monitoring.
- ♿ **PcD flag**: whether the job is open to people with disabilities.

### What data can you scrape from Gupy?

| Field | Description |
|---|---|
| Job ID, title, link | Gupy job identifier and application page |
| Company | Company name, slug, logo and career page |
| Description | Full job description |
| Job type | CLT, estágio, jovem aprendiz, trainee, temporário, PJ… |
| Workplace | Remote, hybrid or on-site |
| City and state | Job location in Brazil |
| PcD | Open to people with disabilities |
| Published | Publish date |
| Deadline | Application deadline |

### Use cases for Brazilian job data

- **Recruiters and staffing agencies (recrutamento e seleção)**: find companies hiring for specific roles and states.
- **Labor-market research**: track demand for analysts, developers, sales and healthcare roles across Brazil.
- **B2B sales prospecting**: hiring companies are growing companies, which makes them good leads for HR tech, benefits and services.
- **Job aggregators and Telegram/WhatsApp channels**: publish fresh vagas automatically every day.
- **Internship and trainee programs**: collect every open estágio and trainee program in one sheet.
- **HR analytics**: compare remote vs on-site share and contract types by region.

### How to scrape Gupy jobs

1. Click **Try for free** to open Gupy Jobs Scraper in Apify Console.
2. Enter **search keywords** (or leave empty for all jobs).
3. Optionally add **states**, **cities**, **workplace** and **job type** filters.
4. Set **Max jobs** and click **Start**.
5. Download the jobs as **CSV, Excel or JSON**.

### Input

#### Example input

```json
{
  "keywords": ["analista de dados", "vendedor"],
  "states": ["São Paulo", "Paraná"],
  "workplaceTypes": ["remote", "hybrid"],
  "jobTypes": ["vacancy_type_effective", "vacancy_type_internship"],
  "maxItems": 500
}
```

| Field | Description |
|---|---|
| **Search keywords** | Job titles or skills. One search each. Leave empty for all jobs. |
| **States** | Brazilian states by full name. One search each. |
| **Cities** | Cities. One search each. |
| **Workplace** | Remote, hybrid, on-site. |
| **Job type** | CLT, internship, apprentice, trainee, temporary, PJ, freelancer, outsourced, talent pool, lecturer. |
| **Company name contains** | Keep only jobs from matching companies. |
| **Max jobs** | Stop after this many jobs (0 = no limit). |

### Output

#### Job example

```json
{
  "jobId": "12617093",
  "title": "Vendedor(a) Life By Vivara - Itu Plaza Shopping - Itu/SP",
  "company": "Vivara Lojas",
  "companySlug": "vivaralojas",
  "companyLogo": "https://attachments.gupy.io/production/companies/456/career/183263/images/2024-08-15_13-55_companyLogoUrl.png",
  "companyCareerPage": "https://vivaralojas.gupy.io/",
  "url": "https://vivaralojas.gupy.io/job/eyJqb2JJZCI6MTI2MTcwOTMsInNvdXJjZSI6Imd1cHlfcG9ydGFsIn0=",
  "description": "Venha brilhar com a maior rede de joalherias da América Latina! Com mais de 60 anos de história…",
  "jobType": "Full-time (CLT)",
  "jobTypeCode": "vacancy_type_effective",
  "workplaceType": "on-site",
  "city": "Itu",
  "state": "São Paulo",
  "acceptsPwd": false,
  "publishedAt": "2026-10-05T21:15:54.095Z",
  "applicationDeadline": "2026-11-27T00:00:00.000Z",
  "searchTerm": "vendedor"
}
```

#### Output schema

| Field | Type | Description |
|---|---|---|
| `jobId` | string | Gupy job ID. |
| `title` | string | Job title. |
| `company` | string | Company name. |
| `companySlug` | string | Company's Gupy subdomain. |
| `companyLogo` | string (URL) | Company logo. |
| `companyCareerPage` | string (URL) | Company's Gupy career page. |
| `url` | string (URL) | Job application page. |
| `description` | string | Full job description. |
| `jobType` | string | Contract type in English. |
| `jobTypeCode` | string | Gupy contract type code. |
| `workplaceType` | string | remote, hybrid or on-site. |
| `city`, `state` | string | Job location. |
| `acceptsPwd` | boolean | Open to people with disabilities (PcD). |
| `publishedAt` | string (ISO date) | Publish date. |
| `applicationDeadline` | string (ISO date) | Application deadline. |
| `searchTerm` | string | Keyword that found the job. |
| `scrapedAt` | string (ISO date) | When the row was collected. |

### How much does it cost to scrape Gupy?

Gupy Jobs Scraper uses **pay-per-job** pricing: a small fixed price per job, with automatic discounts on higher Apify plans. See the **Pricing** tab for the exact price. A run of 1,000 jobs takes a few minutes.

### More job data

- [LinkedIn Jobs Scraper](https://apify.com/hipersoft/linkedin-jobs-scraper): jobs from LinkedIn, including Brazil.
- [Indeed Scraper](https://apify.com/hipersoft/indeed-scraper): jobs from Indeed.
- [Brazil CNPJ Scraper](https://apify.com/hipersoft/brazil-cnpj-scraper): enrich hiring companies with Brazilian company registry data.

### FAQ

**Can I search in Portuguese?**
Yes. Portuguese and English keywords both work, and job texts are returned exactly as published.

**Does it include the full job description?**
Yes. Every job includes the full description as plain text.

**How many jobs can I get?**
Everything that matches your search. Leave keywords empty and set **Max jobs** to 0 to collect all listed jobs; add several states or cities to split very large searches.

**Can I get only remote jobs (vagas remotas)?**
Yes. Set **Workplace** to Remote.

**Can I get only internships (estágio) or jovem aprendiz?**
Yes. Pick those under **Job type**.

**How fresh is the data?**
Every run reads the live job portal, and `publishedAt` shows when each job was posted.

**What formats can I export?**
CSV, Excel, JSON, XML, HTML and RSS, or read the results through the Apify API.

**Can I integrate Gupy Jobs Scraper with other apps?**
Gupy Jobs Scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). It works with [Make](https://apify.com/integrations/make), [Zapier](https://apify.com/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Airbyte](https://docs.apify.com/platform/integrations/airbyte), [GitHub](https://docs.apify.com/platform/integrations/github), [Google Drive](https://docs.apify.com/platform/integrations/drive) and [many more](https://apify.com/integrations), plus the [Apify API](https://docs.apify.com/api/v2), JS/Python clients and MCP. Or use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to trigger an action whenever a run finishes.

**Is it legal to scrape Gupy?**
The scraper only collects publicly listed job offers. You are responsible for using the data in line with Gupy's terms and the LGPD (Brazil's data protection law).

### Related Actors

- [LinkedIn Jobs Scraper](https://apify.com/hipersoft/linkedin-jobs-scraper)
- [Indeed Scraper](https://apify.com/hipersoft/indeed-scraper)
- [Brazil CNPJ Scraper](https://apify.com/hipersoft/brazil-cnpj-scraper)

### Notes

Original clean-room implementation. Returns only public data; you are responsible for compliance with Gupy's terms. Not affiliated with Gupy.

# Actor input Schema

## `keywords` (type: `array`):

Job titles or skills, e.g. analista, vendedor, desenvolvedor python, estágio. Each keyword is a separate search. Leave empty for all jobs.

## `states` (type: `array`):

Brazilian states by full name, e.g. São Paulo, Minas Gerais, Rio de Janeiro. Each state is a separate search. Leave empty for all of Brazil.

## `cities` (type: `array`):

Cities, e.g. Curitiba, Campinas, Belo Horizonte. Each city is a separate search.

## `workplaceTypes` (type: `array`):

Only remote, hybrid or on-site jobs. Leave empty for all.

## `jobTypes` (type: `array`):

Only these contract types. Leave empty for all.

## `companyContains` (type: `string`):

Only keep jobs whose company name contains this text (case-insensitive).

## `maxItems` (type: `integer`):

Stop after this many jobs. 0 means no limit.

## `proxyConfiguration` (type: `object`):

Not required for normal use.

## Actor input object example

```json
{
  "keywords": [
    "analista de dados"
  ],
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

The results as dataset items.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "analista de dados"
    ],
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("hipersoft/gupy-jobs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": ["analista de dados"],
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/gupy-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "analista de dados"
  ],
  "maxItems": 50
}' |
apify call hipersoft/gupy-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hipersoft/gupy-jobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/y74xgjtXAyjh5BAof/builds/qZzzZ3JUDmneiphrO/openapi.json