Gupy.io Jobs Scraper

What does Gupy.io Jobs Scraper do?

Gupy.io Jobs Scraper collects public job listings from the Gupy jobs portal for recruitment research, Brazilian hiring-market analysis, and recurring vacancy monitoring. Each record can include the job title, employer, city, state, description, employment type, workplace model, publication date, application deadline, and direct vacancy link.

Paste a Gupy search URL to reuse its filters, or enter a keyword and optional location. If you leave the search inputs empty, the Actor collects the latest available jobs. Download the dataset as JSON, CSV, Excel, or XML, or connect it to a spreadsheet, database, or notification workflow through Apify.

Why use Gupy.io Jobs Scraper?

• Monitor employer hiring - Track which companies advertise roles in your target cities, industries, or job categories.
• Research Brazilian job demand - Compare vacancy titles, publication dates, locations, employment types, and workplace models.
• Reuse prepared searches - Copy a public Gupy search URL when you have already selected filters on the portal.
• Read job requirements at scale - Use description text for role classification, skills research, and search indexing.
• Keep application links attached - Preserve the direct vacancy URL alongside the employer and job information.
• Control collection size - Set a result target and page cap for a small sample or a larger hiring snapshot.
• Automate recurring reports - Schedule searches in Apify Console and connect completed runs to your reporting tools.

What data can you extract from Gupy?

The main fields help you identify a vacancy, understand its work conditions, and find the original listing.

Field	Description
jobId	Gupy's identifier for the vacancy.
title	Published job title, preserved in its original language.
company	Employer or career page name.
location	Combined city, state, and country text when available.
jobTypeLabel	Readable employment category, such as Apprentice, Internship, or Temporary.
workplaceTypeLabel	Workplace model, such as On-site, Hybrid, or Remote.
publishedDate	Job publication timestamp.
applicationDeadline	Application closing date when published.
descriptionText	Plain-text vacancy description.
jobUrl	Direct link to the vacancy.
acceptsDisabilities	Disability-inclusion flag supplied by Gupy.

Fields depend on what the source publishes. Optional values are omitted when unavailable. This Actor does not provide a structured salary field, applicant contact details, or candidate profiles.

How to use Gupy.io Jobs Scraper

1. Open the Actor in Apify Console.
2. Paste a public portal.gupy.io/job-search URL, or enter a keyword and optional city/state.
3. Set results_wanted and max_pages. Start with 20 results and one page.
4. Run the Actor and review the dataset preview.
5. Download the results or connect the dataset to your reporting workflow.

For keyword/location searches, clear the URL field in Console to make your choice explicit. You do not need a Gupy account for the public portal search.

How search inputs are selected

• Custom URL - A URL other than the default latest-jobs URL takes priority. The Actor uses its filters alone and ignores separate keyword/location inputs.
• Keyword or location - These inputs override the default latest-jobs URL. You can use a keyword, a location, or both together.
• No search supplied - The default search collects the latest available jobs, sorted by publication date.

The URL field has one prefilled example with the same runtime default. Result and page limits retain their own defaults; they are not additional search examples.

Input Parameters

Parameter	Type	Required	Default	Description
url	String	No	https://portal.gupy.io/job-search/sortBy=publishedDate	Public Gupy search URL. A custom URL takes priority; keyword/location overrides the default latest-jobs URL.
keyword	String	No	None	Job title or search phrase used when no custom URL is selected.
location	String	No	None	City, state, or city/state combination, such as Recife, Pernambuco, or Recife - PE. Can be combined with a keyword.
sortBy	String	No	publishedDate	Sort order for keyword/location searches. The supported selection is publishedDate.
results_wanted	Integer	No	20	Maximum number of jobs to save. Minimum: 1.
max_pages	Integer	No	1	Maximum number of result pages to process. Minimum: 1.
proxyConfiguration	Object	No	{"useApifyProxy": false}	Optional Apify Proxy or custom proxy settings. Proxy routing is disabled by default.

The result limit is a maximum, not a guarantee. A run can save fewer jobs when the search has fewer matches or the page cap is reached. Increase both controls when collecting a larger dataset; increasing results_wanted alone does not remove the page cap.

Output Data

Each dataset item represents one Gupy vacancy. Field names stay consistent across URL, keyword, and location searches.

Field	Type	Description
jobId	Integer	Gupy vacancy identifier.
title	String	Published job title.
company	String	Company or career page name.
companyId	Integer	Company identifier when supplied.
careerPageId	Integer	Career page identifier when supplied.
careerPageName	String	Employer career page name.
careerPageLogoUrl	String	Company logo URL when available.
careerPageUrl	String	Career page URL when available.
descriptionHtml	String	Formatted description content when available.
descriptionText	String	Plain-text description.
jobType	String	Original employment-category code.
jobTypeLabel	String	Readable employment-category label.
publishedDate	String	Source publication timestamp.
applicationDeadline	String	Application deadline when published.
isRemoteWork	Boolean	Remote-work flag when explicitly supplied by the source.
workplaceType	String	Original workplace-model value.
workplaceTypeLabel	String	Readable workplace-model label.
city	String	Vacancy city when published.
state	String	Vacancy state when published.
country	String	Country when supplied.
location	String	Combined available location fields.
jobUrl	String	Direct vacancy URL.
acceptsDisabilities	Boolean	Source-provided disability-inclusion flag.
skills	Array of strings	Separate skills list when supplied. Requirements may instead appear in the description.
sourceUrl	String	Search URL associated with the record.

Not every listing includes every field. In particular, company identifiers, career page links, country, remote-work flags, and separate skills lists may be absent. Check workplaceTypeLabel for the published work model rather than relying on isRemoteWork being present.

Usage Examples

Collect the latest Gupy jobs

Start with a 20-job sample from the default publication-date search.

{
  "url": "https://portal.gupy.io/job-search/sortBy=publishedDate",
  "results_wanted": 20,
  "max_pages": 1
}

Search by keyword

Collect up to 30 matching Developer vacancies without adding a location filter.

{
  "keyword": "Developer",
  "results_wanted": 30,
  "max_pages": 2
}

Search by location

Collect up to 25 vacancies in Recife, Pernambuco, without adding a job keyword.

{
  "location": "Recife - PE",
  "results_wanted": 25,
  "max_pages": 2
}

Combine a keyword and location

Search for sales-related vacancies in São Paulo using a Portuguese keyword.

{
  "keyword": "Vendas",
  "location": "Sao Paulo - SP",
  "results_wanted": 50,
  "max_pages": 3
}

Collect a larger hiring snapshot

Allow more pages when requesting up to 200 recent vacancies.

{
  "url": "https://portal.gupy.io/job-search/sortBy=publishedDate",
  "results_wanted": 200,
  "max_pages": 10
}

For work-model or employment-type filtering, configure the search on Gupy and copy the resulting public search URL into url. The Actor accepts one search configuration per run, not an array of independent searches.

Sample Output

This sample uses fields from a collected vacancy. The description is shortened for readability, and optional fields are left out.

{
  "jobId": 12672534,
  "title": "APRENDIZ DE ATENDENTE DE RESTAURANTE ( VILA RE - SAO PAULO/SP)",
  "company": "McDonald's Restaurante - Arcos Dorados",
  "careerPageName": "McDonald's Restaurante - Arcos Dorados",
  "descriptionText": "#A gente vai amar muito se você... 😍🍟 Faz questão de tornar as coisas mais fáceis para as pessoas e adora gerar sorrisos",
  "jobType": "vacancy_type_apprentice",
  "jobTypeLabel": "Apprentice",
  "publishedDate": "2026-10-03T03:00:21.546Z",
  "applicationDeadline": "2026-12-02T00:00:00.000Z",
  "workplaceType": "on-site",
  "workplaceTypeLabel": "On-site",
  "city": "Sao Paulo",
  "state": "São Paulo",
  "location": "Sao Paulo, São Paulo",
  "jobUrl": "https://restaurantemc.gupy.io/job/eyJqb2JJZCI6MTI2NzI1MzQsInNvdXJjZSI6Imd1cHlfcG9ydGFsIn0=?jobBoardSource=gupy_portal",
  "acceptsDisabilities": true,
  "sourceUrl": "https://portal.gupy.io/job-search/sortBy=publishedDate"
}

Tips for Best Results

• Use source-language keywords - Many Gupy listings use Portuguese. Try the wording employers use for the role, such as Vendas, Analista, or Desenvolvedor.
• Make locations explicit - Use a city/state combination such as Recife - PE when the state matters. A state name can support broader regional research.
• Review your search mode - Clear the URL field before switching to keyword/location mode. A custom URL otherwise takes priority.
• Test before scaling - Review a small dataset for title relevance, locations, descriptions, and application links before increasing limits.
• Keep recurring searches comparable - Use the same inputs when tracking hiring trends, and use jobId to identify repeated vacancies across runs in your own storage.
• Expect changing listings - Jobs may close or change after collection. Verify the original vacancy before applying or using its information in a decision.

Optional proxy configuration

Proxy routing is optional, not a requirement for the default setup. If your workflow needs Apify Proxy, enable it through the proxy input:

{
  "results_wanted": 20,
  "max_pages": 1,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Proxy availability and charges depend on your Apify account. Routing through a proxy does not guarantee access or prevent source-side restrictions.

Integrations

• Google Sheets - Review vacancies, filter by employer or city, and share hiring reports.
• Airtable - Organize a searchable vacancy collection with employer and location views.
• Make or Zapier - Send notifications or launch follow-up workflows after a run completes.
• Webhooks - Notify your application when a run finishes.
• Apify API - Start runs and retrieve dataset items from your own applications.
• Schedules - Refresh the same search daily, weekly, or at another interval configured in Apify Console.

Export formats

Format	Useful for
JSON	Applications, databases, and structured data pipelines.
CSV	Spreadsheet analysis and reporting.
Excel	Sharing results with recruiting and business teams.
XML	Compatible data-exchange workflows.

Frequently Asked Questions

Can I collect Gupy jobs without a login?

Yes. The Actor collects public portal job listings without Gupy credentials. It does not access candidate accounts, applications, or private employer records.

Can I search by keyword and location together?

Yes. Provide both fields without a custom URL. Keyword/location inputs override the default latest-jobs URL; another URL takes priority and uses its own filters alone.

What happens if I leave the search inputs empty?

The Actor collects the latest available jobs. The default controls request up to 20 records and limit the run to one result page.

How many jobs can I collect?

Set results_wanted to your target and max_pages to a suitable page cap. The verified 200-result search collected 200 jobs across two pages, but counts depend on the selected search and source availability.

Can I collect remote or hybrid jobs?

Yes. Select the work model on the Gupy portal and use the resulting search URL. Review workplaceType and workplaceTypeLabel in the output to confirm the source's classification.

Does the Actor provide salary information?

No structured salary field is included. A vacancy may mention compensation in its description, but salary coverage should not be assumed.

Why are some output fields missing?

The source does not publish every field for every vacancy. Unavailable values are omitted rather than replaced with guessed data. Requirements may appear in the description even when skills is absent.

Can I export Gupy jobs to CSV or Excel?

Yes. Download the dataset in CSV, Excel, JSON, or XML through Apify, or retrieve records programmatically for your own storage.

Can I schedule recurring searches?

Yes. Create a schedule in Apify Console. Compare records by jobId in your destination to track repeated vacancies across separate runs.

Is collecting Gupy job data legal?

Public availability does not remove legal obligations. You are responsible for reviewing Gupy's terms, applicable privacy requirements, and laws relevant to your collection and intended use.

Related Actors

For additional job-market sources, these Actors are also available from Shahid Irfan:

• Fast LinkedIn Job Scraper - Collect public LinkedIn vacancies for cross-source hiring research and recruitment monitoring.
• Talent Job Scraper - Collect Talent.com listings for broader job aggregation and hiring-market analysis.
• Jora Jobs Scraper - Add listings from supported Jora country sites for regional job-market comparisons.

These are separate Actors with their own inputs, output fields, coverage, and pricing. Review each Actor's documentation before combining datasets.

Support

For issues or feature requests, use the Issues tab on the Actor page or contact the developer through Apify. Include the run URL, the search input without credentials, and a short explanation of the expected result. Public job listings can change; a source URL helps reproduce collection problems.

Legal Notice

This Actor is intended for legitimate collection and analysis of publicly available Gupy job information. It is not an official Gupy product and is not affiliated with Gupy. Respect access restrictions, website terms, and applicable laws, including Brazil's LGPD where relevant. Do not use the data for unlawful discrimination, spam, harassment, or other abusive purposes.