{"uid":"cap_ybwx3T2RG16ycwYfxeoZg","slug":"real-estate-listing-search-c4786f17","name":"Real Estate Listing Search","description":"Search public home and rental listings by market, listing type, price, beds, amenities, URL, address, or property id. Uses managed fulfillment for Zillow, Apartments, and realtor-compatible requests.","url":"https://agentbodega.store/api/real-estate/listings/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"body":{"fields":[{"name":"source","type":"string","required":false},{"name":"mode","type":"string","required":false},{"name":"market","type":"string","required":false},{"name":"listingType","type":"string","required":false},{"name":"priceMin","type":"integer","required":false},{"name":"priceMax","type":"integer","required":false},{"name":"bedsMin","type":"integer","required":false},{"name":"bedsMax","type":"integer","required":false},{"name":"bathsMin","type":"number","required":false},{"name":"bathsMax","type":"number","required":false},{"name":"homeTypes","type":"array","required":false},{"name":"propertyType","type":"string","required":false}],"required":[],"fieldCount":38,"contentType":"application/json","requirements":"Choose one mode and provide its required selector: search requires market or zipCode; url requires searchUrls; lookup requires addresses, zpids, or propertyIds. Search filters are rechecked against normalized rows before results are returned.","optionalPreview":["source","mode","market","listingType","priceMin","priceMax","bedsMin","bedsMax","bathsMin","bathsMax","homeTypes","propertyType"],"omittedFieldCount":26},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}}},"output":{"type":"object","properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":null,"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_kKPrXCb3ZiPRpVuFyKOjn","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":"Searches Zillow-backed real estate listings using price, bed/bath, square footage, location, and home type filters, returning structured results with prices, addresses, photos, and agent details.","exampleAgentPrompt":"Can you search for 3-bedroom, 2-bathroom single-family homes for sale in Austin, TX between $400k and $650k and at least 1,500 square feet? I'd like to see prices, addresses, and agent info.","exampleUseCases":[{"title":"First-time buyer home search assistant","prompt":"I'm looking to buy my first home in Seattle and have a budget of $550k. Can you find me some 2 or 3 bedroom condos or townhomes that are move-in ready? I'd like to see the photos and get the agent's contact info so I can schedule viewings."},{"title":"Investment property portfolio expansion","prompt":"Help me find single-family rental properties in Denver and surrounding areas under $450k with at least 3 bedrooms. I want to compare square footage and see which ones might have good rental income potential. Show me the agent details too."},{"title":"Relocation housing options finder","prompt":"My family is moving to Austin and we need a place with 4 or more bedrooms and at least 2,500 square feet. Can you search listings in good school districts under $750k and pull up the photos and agent information so we can start reaching out?"}],"resultDescription":"A structured list of matching real estate listings including property address, listing price, number of bedrooms and bathrooms, square footage, home type, listing photos, and agent contact details sourced via Zillow.","failureModes":["Invalid or unrecognized location returns empty results or an error","Price range with min greater than max causes a validation error","Overly restrictive filters (e.g. very high sqft in a small market) return zero results","Malformed request body (missing required fields) returns a 400 error","Zillow backend unavailability may cause upstream errors or timeouts"],"whenToPreferThis":"Use this endpoint when an agent needs to search active real estate listings with structured filter criteria (price, beds, baths, square footage, home type, location) and requires structured output including photos and agent details, particularly when Zillow data coverage is acceptable. Prefer over manual web scraping or general web search when structured, filterable listing data is needed programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:38:24.942Z","isFirstParty":false}