{"uid":"cap_2gaGpHKRUUtBQ8EAqpRJC","slug":"vivareal-property-listings-scraper-x402-6811a7e1","name":"VivaReal Property Listings Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/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_ZkzO1a4SwWb_ibN7a9QqL","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 Brazilian real estate listings from VivaReal by city or URL, returning property details with pay-per-call USDC micropayment via x402.","exampleAgentPrompt":"Scrape up to 200 apartment listings for sale in São Paulo from VivaReal, filtering for properties priced between 300000 and 800000 BRL.","exampleUseCases":[{"title":"Rental market survey in Curitiba","prompt":"Pull up to 150 rental property listings in Curitiba from VivaReal, with a maximum price of 4000 BRL, so I can analyze the rental market there."},{"title":"Investment property search in Rio","prompt":"Get me up to 100 properties for sale in Rio de Janeiro on VivaReal, priced between 500000 and 1500000 BRL, so I can compare investment options."},{"title":"Bulk listing data from a VivaReal URL","prompt":"Scrape all available listings from this VivaReal search URL I have — https://www.vivareal.com.br/venda/sp/sao-paulo/ — and return the structured data, up to 300 items."}],"resultDescription":"Returns a JSON object with a count of results and an array of property items, each containing fields such as id, url, title, externalId, description, listingType, propertyType, and sourceListingType. Also includes a product identifier ('vivareal'). Failed or empty runs are not charged.","failureModes":["Empty result set if location is invalid or no listings match filters (not charged)","Scraper blocked by VivaReal anti-bot measures returning empty results","Invalid URL format for VivaReal city/listing URL causing a failed run","maxItems set to 0 may trigger very long runs hitting the 500-page safety limit","Network timeout on large result sets"],"whenToPreferThis":"Use this endpoint when you need structured Brazilian real estate listing data from VivaReal specifically, with price filtering and transaction type control. Prefer it over generic web scrapers because it returns typed property fields, handles VivaReal's pagination automatically, and only charges on successful non-empty results — making it cost-efficient for iterative searches.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:36.023Z","isFirstParty":false,"canonicalSlug":"vivareal-property-listings-scraper-x402-6811a7e1"}