{"uid":"cap_F6TZNc1Xq4DuelxTKzgbQ","slug":"vivareal-brazilian-real-estate-listings-scraper-02fa6965","name":"VivaReal Brazilian Real Estate Listings Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/vivareal?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"location":{"type":"string","description":"Brazilian city name, such as São Paulo, or a VivaReal city sale or rental URL."},"maxItems":{"type":"integer","default":100,"minimum":0,"description":"Stop after this many unique properties. Zero continues until the source ends or the 500-page safety limit."},"maxPrice":{"type":"integer","minimum":0,"description":"Optional maximum listing price in Brazilian reais."},"minPrice":{"type":"integer","minimum":0,"description":"Optional minimum listing price in Brazilian reais."},"transaction":{"enum":["auto","sale","rental"],"type":"string","default":"auto","description":"Use the URL sale or rental path automatically, or override it. City names default to sale."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"url":null,"title":null,"externalId":null,"description":null,"listingType":null,"propertyType":null,"sourceListingType":null}],"product":"vivareal"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-UGWqV00zn3SGBIuB9KCb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured property listing data from VivaReal (Brazil's major real estate portal) by city name or listing URL, supporting both sale and rental transactions with optional price filtering.","exampleAgentPrompt":"Search VivaReal for up to 200 apartments for sale in São Paulo priced between 300000 and 800000 BRL and give me the structured listing data including titles, URLs, and property types.","exampleUseCases":[{"title":"Brazilian rental market price research","prompt":"Scrape VivaReal for rental listings in Rio de Janeiro with a maximum price of 5000 BRL — I want up to 150 results with all the property details you can get."},{"title":"Real estate investment property search","prompt":"Find all houses and apartments for sale in Curitiba on VivaReal, priced between 200000 and 600000 BRL, and return up to 100 listings with their IDs and descriptions."},{"title":"City property listing data pipeline","prompt":"Pull the full set of property sale listings from VivaReal for Belo Horizonte — no price filter, just get up to 500 results with structured data on each property type and listing URL."}],"resultDescription":"Returns a JSON object with a count of results and an array of property listing items, each containing fields such as id, url, title, externalId, description, listingType, propertyType, and sourceListingType. Failed or empty runs are not billed.","failureModes":["Invalid or unrecognized city name returns empty result set","VivaReal URL path mismatch causes incorrect transaction type detection","maxItems set to 0 may result in very large responses hitting the 500-page safety limit","Rate limiting or changes to VivaReal's site structure may cause empty or partial results","Non-Brazilian city names or non-VivaReal URLs will not return valid data"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable real estate listing data from VivaReal specifically — Brazil's major property portal — without managing browser automation or scraping infrastructure yourself. Ideal for market research, price monitoring, or building property datasets focused on the Brazilian market. Best when you need to query by Brazilian city name or a direct VivaReal URL with optional price range filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:25.799Z","isFirstParty":false,"canonicalSlug":"vivareal-brazilian-real-estate-listings-scraper-02fa6965"}