# Gupy Jobs Search Scraper (`alexist/gupy-jobs-search-scraper`) Actor Scrape job listings from Gupy's job search portal with precision. Collect job details including titles, descriptions, company info, locations, salary ranges, job types, and skill requirements — perfect for HR analytics, recruitment intelligence, and talent pipeline building. - **URL**: https://apify.com/alexist/gupy-jobs-search-scraper.md - **Developed by:** [Alex](https://apify.com/alexist) (community) - **Categories:** Jobs, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Gupy Jobs Search Scraper: Extract Recruitment Data Effortlessly --- ### What Is Gupy? Gupy is a leading HR tech platform in Latin America, offering recruitment and talent management solutions for companies of all sizes. The platform's job search portal (portal.gupy.io) hosts thousands of active job listings across industries and regions, particularly strong in Brazil and surrounding markets. Manually searching and extracting job data from the portal is inefficient — the **Gupy Jobs Search Scraper** automates this process, delivering structured recruitment intelligence at scale. --- ### Overview The **Gupy Jobs Search Scraper** extracts job search results from Gupy's job portal, transforming raw listings into clean, normalized records. It is ideal for: - **Recruiters** monitoring competitor activity and talent market dynamics - **HR departments** building recruitment databases and talent pipelines - **Data analysts** studying job market trends in Latin America - **Platform developers** aggregating recruitment data across multiple sources The scraper handles search queries seamlessly, supports pagination, respects failure handling, and delivers 18+ data fields per job listing with full company and location information. --- ### Input Format The scraper accepts a JSON configuration object: ```json { "urls": [ "https://portal.gupy.io/job-search/term=design?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 } ```` #### Input Parameters | Parameter | Type | Description | |---|---|---| | `urls` | Array | Job search result pages to scrape. URLs can include search terms, filters, and page numbers. Example: `term=design`, `term=python&page=3`, etc. | | `ignore_url_failures` | Boolean | If `true`, the scraper continues if individual URLs fail. If `false`, the entire run stops on the first error. Default: `true` | | `max_items_per_url` | Integer | Maximum number of job listings to extract per URL. Reduces costs and runtime. Default: `20` | **Examples:** - Search by keyword: `https://portal.gupy.io/job-search/term=design?page=1` - Search with filters: `https://portal.gupy.io/job-search/term=python%20developer&page=2` - Pagination: Automatically handle page parameters to crawl multiple result sets > **Tip:** Use specific search terms to target relevant roles. Combine multiple URLs with different keywords to build a comprehensive dataset. *** ### Output Format **Sample output** ```json { "id": 11604384, "company_id": 68611, "name": "Designer de Criativos Sênior", "description": "Ei, você, beleza? 💜Já pensou em fazer parte de uma empresa que está transformando os setores de beleza, saúde e cuidado com inovação e propósito? Então vem com a gente no Grupo Ei beleza 🚀✨Se você é uma pessoa criativa, estratégica e apaixonada por beleza: está no lugar certo! 💜Somos um grupo de marcas nativa digital, 100% brasileira, que entrega qualidade de tratamento capilar de referência mundial com preço que cabe na rotina da brasileira. Queremos ser a companhia favorita do dia a dia de quem cuida dos cabelos, com produtos de alta performance, resultado real e uma comunicação que desperta desejo.Aqui, a gente acredita que criatividade e performance caminham juntas. Nossa esteira de criativos desenvolve soluções orientadas por dados, com foco em construir peças que geram resultado em cada ponto de contato da marca.Buscamos uma pessoa sênior, com repertório estético forte e leitura de performance, que saiba equilibrar a linguagem autêntica que engaja com o padrão premium que constrói marca.Aqui, design não é só visual: é solução.Responsabilidades e atribuiçõesObjetivo da vagaEstamos em busca de uma pessoa para ser referência criativa dentro da nossa esteira, com foco no desenvolvimento de vídeos, motion e criativos de alta performance para ads, social e lançamentos. Essa pessoa domina motion e 3D, usa IA como parte natural do seu fluxo e sabe sustentar volume alto sem abrir mão de sofisticação, sem travar entre o \"vídeo perfeito\" e o \"no ar agora\".Procuramos alguém com olhar de marca apurado, que traduza dados de performance em peças que vendem e que ajude a elevar continuamente o padrão da nossa comunicação. Vai trabalhar em ambiente altamente colaborativo, com interface constante entre performance, criação e branding.Como será o seu dia a diaConceber e produzir criativos de alta performance para ads, social e lançamentos, com foco em vídeo e motion.Criar renders 3D e animações que valorizem o sensorial dos produtos (brilho, textura, resultado real).Sustentar o volume da esteira com agilidade: soltar, testar, analisar e iterar em ciclo rápido.Traduzir briefings de performance em variações e \"packs\" de criativos para testes A/B.Garantir consistência visual da marca em todos os canais, com base no Social Guide.Elevar o padrão estético da comunicação, equilibrando linguagem lo-fi/autêntica com peças premium.Utilizar e propor novos fluxos com IA generativa para escalar produção com consistência de marca.Requisitos e qualificaçõesQuem é vocêTem experiência sólida como designer, com domínio real de motion design e 3D (After Effects, Cinema 4D/Blender ou similares).Manda bem em edição de vídeo para redes e ads: conhece o que engaja em formato curto.Tem repertório estético forte e olhar de marca: entende a diferença entre \"varejão\" e premium.É rápido(a) e produtivo(a): entrega volume sem perder qualidade.É proativo(a), organizado(a) e confortável em ambiente dinâmico e orientado a testes.Boa comunicação e facilidade para trabalhar em equipe.O que buscamosGraduação em Design, Publicidade e Propaganda ou áreas afins.Experiência comprovada com criativos de mídia paga e vídeo para performance.Domínio de ferramentas de motion e 3D (After Effects, Cinema 4D/Blender) e do pacote de criação.Experiência com design digital e direção de peças para diferentes canais.Familiaridade com ferramentas de IA aplicadas à criação (Midjourney, Adobe Firefly, ChatGPT, Claude) já incorporada ao fluxo de trabalho.DesejávelVivência com marcas de beleza, cosméticos ou D2C.Familiaridade com métricas de criativos (win rate, ROAS) e lógica de testes de performance.Experiência com pack shots / still de produto e direção de shooting.Informações adicionais🍴 Vale alimentação/refeição no cartão de benefícios da Flash - R$30,00/dia;🚌 Você decide entre vale-transporte ou vale combustível também no cartão Flash (benefício flexível)💲 50% de desconto na compra de qualquer um dos produtos do Grupo Ei, Beleza?🎂 Um dia de folga para celebrar o seu aniversário e voucher para escolher qualquer produto! #DayOff🏥 Plano de Saúde coparticipativo🦷 Plano Odont.💪 TotalPass para se manter saudável🧠 Clude Saúde🎗 Seguro de Vida💲PLR💊 Convênio Farmácia📚 Convênio SESC👕 Dress code flexível: como você é!⏰ Horário FlexívelOferecemos também:🎓 Cultura colaborativa, permitindo um ambiente de trabalho descontraído e propício ao aprendizado e desenvolvimento!🤝 Parceria com Senac Minas e Grupo Ânima.🥧 Snacks, chás e frutas liberados durante todo o dia de trabalho presencial.\"Por que a Ei, Beleza?\"Grupo de marcas D2C que estão mudando o jogo da beleza no Brasil, com crescimento acelerado.Cultura orientada a dados, com autonomia de verdade e resultado na mesa toda semana.Ambiente colaborativo, sem burocracia e com espaço pra construir do zero.O que você faz aqui chega a milhões de pessoas e aparece no resultado.", "career_page_id": 165670, "career_page_name": "Grupo Ei Beleza", "career_page_logo": "https://attachments.gupy.io/production/companies/68611/career/165670/images/2026-02-06_13-13_companyLogoUrl.png", "career_page_url": "https://eibeleza.gupy.io/eyJzb3VyY2UiOiJndXB5X3BvcnRhbCJ9", "type": "vacancy_type_effective", "published_date": "2026-07-09T12:57:35.304Z", "application_deadline": "2026-09-06", "is_remote_work": false, "city": "São Paulo", "state": "São Paulo", "country": "Brasil", "job_url": "https://eibeleza.gupy.io/job/eyJqb2JJZCI6MTE2MDQzODQsInNvdXJjZSI6Imd1cHlfcG9ydGFsIn0=?jobBoardSource=gupy_portal", "workplace_type": "on-site", "disabilities": true, "skills": [], "from_url": "https://portal.gupy.io/job-search/term=design?page=2" } ``` Each scraped job returns a structured record with 18 fields: #### Job Identification | Field | Meaning | Example | |---|---|---| | `ID` | Unique Gupy identifier for the job listing | `12345abc` | | `Name` | Official job title | `Senior UX Designer` | | `Job URL` | Direct link to the full job posting | `https://portal.gupy.io/job-offers/...` | | `Type` | Employment contract type | `Full-time`, `Internship`, `Temporary` | #### Job Content & Requirements | Field | Meaning | Example | |---|---|---| | `Description` | Full HTML job description including responsibilities | `We are seeking a creative designer...` | | `Skills` | Array of required or desired technical/soft skills | `["UI Design", "Figma", "Prototyping"]` | | `Disabilities` | Indicates if the position is open to people with disabilities | `true` / `false` | #### Work Arrangements | Field | Meaning | Example | |---|---|---| | `Is Remote Work` | Whether the role allows remote work | `true`, `false`, or `hybrid` | | `Workplace Type` | Work environment classification | `On-site`, `Remote`, `Hybrid` | | `City` | Job location city | `São Paulo` | | `State` | Job location state/province | `SP` | | `Country` | Job location country | `Brazil` | #### Company Information | Field | Meaning | Example | |---|---|---| | `Company ID` | Unique identifier for the employer | `567xyz` | | `Career Page ID` | Company's career/jobs page identifier | `techcorp-careers` | | `Career Page Name` | Displayed name of the company's career portal | `TechCorp Careers` | | `Career Page Logo` | Logo image URL for the company | `https://gupy-cdn.../logo.png` | | `Career Page URL` | Direct link to the company's Gupy career page | `https://careers.techcorp.com.br` | #### Timing Information | Field | Meaning | Example | |---|---|---| | `Published Date` | When the job was posted | `2024-01-15` | | `Application Deadline` | Closing date for applications | `2024-02-28` | *** ### How to Use 1. **Build search URLs** — Visit portal.gupy.io and create job searches using keywords or filters. Copy the resulting URLs (including search terms and page numbers). 2. **Configure input** — Paste URLs into the `urls` array. Adjust `max_items_per_url` based on your data needs (typically 20–50). 3. **Set failure handling** — Keep `ignore_url_failures: true` for production runs to prevent interruptions. 4. **Execute the scraper** — Start the actor and monitor progress in the run log. 5. **Retrieve and export** — Download results as JSON, CSV, or Excel; integrate into your database or BI tools. **Best practices:** - Combine multiple search queries to cover different job categories - Use pagination (e.g., `?page=1`, `?page=2`) to retrieve all results systematically - Verify URLs are job search result pages, not individual job postings - Schedule periodic runs to track hiring trends over time *** ### Use Cases & Business Applications - **Recruitment intelligence:** Analyze competitor hiring patterns and open roles - **Talent pipeline building:** Create datasets of active job opportunities in your industry - **Salary benchmarking:** Correlate job titles, skills, and location data with compensation research - **Labor market research:** Track hiring demand across regions, job types, and skill sets - **Career planning:** Monitor career progression paths and skill requirements in your field By automating data collection from Gupy's portal, organizations save weeks of manual research and gain structured, actionable insights into the Latin American recruitment market. *** ### Conclusion The **Gupy Jobs Search Scraper** simplifies access to recruitment data from one of Latin America's largest job platforms. With flexible search configuration, comprehensive 18-field output, and reliable error handling, it empowers recruiters, analysts, and researchers to build powerful talent intelligence workflows. Start scraping today and unlock insights into your competitive recruitment landscape. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the Jobs list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://portal.gupy.io/job-search/term=design?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://portal.gupy.io/job-search/term=design?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("alexist/gupy-jobs-search-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": ["https://portal.gupy.io/job-search/term=design?page=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("alexist/gupy-jobs-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "https://portal.gupy.io/job-search/term=design?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call alexist/gupy-jobs-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=alexist/gupy-jobs-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Gupy Jobs Search Scraper", "description": "Scrape job listings from Gupy's job search portal with precision. Collect job details including titles, descriptions, company info, locations, salary ranges, job types, and skill requirements — perfect for HR analytics, recruitment intelligence, and talent pipeline building.", "version": "0.0", "x-build-id": "NKZtjS4NMDPjMm6eJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alexist~gupy-jobs-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alexist-gupy-jobs-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/alexist~gupy-jobs-search-scraper/runs": { "post": { "operationId": "runs-sync-alexist-gupy-jobs-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/alexist~gupy-jobs-search-scraper/run-sync": { "post": { "operationId": "run-sync-alexist-gupy-jobs-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "URLs of the Jobs list urls to scrape", "type": "array", "description": "Add the URLs of the Jobs list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```