{"uid":"cap_E5Bmd2TaFx-lmTo-H8rxs","slug":"gupy-job-listings-scraper-eb55c520","name":"Gupy Job Listings Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/gupy?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"state":{"type":"string","default":"","description":"Filter by Brazilian state name, for example São Paulo. Empty searches all states."},"cities":{"type":"array","items":{"type":"string"},"default":[],"description":"City names as shown in listings. Empty includes every city."},"sortBy":{"enum":["newest","oldest"],"type":"string","default":"newest","description":"Return newest or oldest publication dates first."},"jobTypes":{"type":"array","items":{"enum":["vacancy_type_effective","vacancy_type_apprentice","vacancy_type_internship","vacancy_legal_entity","vacancy_type_trainee","vacancy_type_temporary","vacancy_type_freelancer","vacancy_type_outsource","vacancy_type_talent_pool","vacancy_type_volunteer","vacancy_type_parter","vacancy_type_summer","vacancy_type_intermittent"],"type":"string","enumTitles":["Full-time","Apprentice","Internship","Legal entity","Trainee","Temporary","Freelancer","Outsourced","Talent pool","Volunteer","Partner","Summer","Intermittent"]},"default":[],"description":"Filter by Gupy vacancy type codes. Empty includes all types."},"companies":{"type":"array","items":{"type":"string"},"default":[],"description":"Exact career-page names to search, one per line. Empty searches every career page."},"maxResults":{"type":"integer","default":100,"maximum":100000,"minimum":0,"description":"Stop after this many full job records. Set 0 to continue until the source has no more jobs or the run budget is reached."},"searchTerm":{"type":"string","default":"","description":"Find vacancies containing this term. Empty searches all public jobs."},"workplaceTypes":{"type":"array","items":{"enum":["remote","hybrid","on-site"],"type":"string","enumTitles":["Remote","Hybrid","On-site"]},"default":[],"description":"Include remote, hybrid, and/or on-site vacancies. Empty includes all types."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"code":null,"name":null,"jobUrl":null,"description":null,"prerequisites":null,"responsibilities":null,"descriptionPlainText":null}],"product":"gupy"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TfRH_NUDb9EFejkHdE09B","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes and returns structured job vacancy data from the Gupy platform, filterable by Brazilian state, city, company, job type, and workplace type.","exampleAgentPrompt":"Search Gupy for the 50 newest remote or hybrid software engineering jobs in São Paulo, sorted by newest first, across all companies.","exampleUseCases":[{"title":"Tech talent sourcing in Brazil","prompt":"Pull the 100 most recent software developer job listings from Gupy across all Brazilian states, including remote and hybrid positions, and sort them newest first so I can review what's currently available."},{"title":"Monitoring internship openings at top companies","prompt":"Check Gupy for any new internship vacancies posted by Nubank, iFood, or Mercado Livre — include all Brazilian cities and show me the newest ones first."},{"title":"Freelance and temporary work search in Rio","prompt":"Find all freelance and temporary job vacancies currently listed on Gupy in Rio de Janeiro, up to 200 results, sorted by newest publication date."}],"resultDescription":"Returns a JSON object with a count of matching jobs and an array of job records, each containing the job ID, code, name, URL, description, prerequisites, responsibilities, and plain-text description scraped from Gupy career pages.","failureModes":["Empty results if no jobs match the given filters — call is not charged","Timeout or partial results if maxResults is very large and source has many listings","Invalid city or state names may silently return zero results","Unknown company career-page names will be ignored with no matches","Rate or budget limits may truncate results before maxResults is reached"],"whenToPreferThis":"Use this endpoint when you specifically need structured job data from the Gupy platform, which hosts career pages for a large number of Brazilian companies. Prefer this over generic web scrapers when you need clean, schema-normalized vacancy records with filtering by Brazilian geography, job type, and workplace modality without building your own scraper.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:13.571Z","isFirstParty":false,"canonicalSlug":"gupy-job-listings-scraper-eb55c520"}