{"openapi":"3.1.0","info":{"title":"Rentcast (BYOK) API","version":"0.1.0","description":"Rentcast (BYOK) lets an AI assistant read your own Rentcast data through the Rentcast API with a key you supply (Rentcast API key). Read-only: 7 tools (search_properties, get_property, estimate_value, estimate_rent, list_sale_listings, list_rental_listings, get_market_statistics). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-rentcast.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-rentcast/docs"},"termsOfService":"https://connectorbay.com/byok-rentcast/terms"},"servers":[{"url":"https://byok-rentcast.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-rentcast/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_properties":{"post":{"operationId":"search_properties","summary":"Search Rentcast property records by address, city and state, ZIP code or a radius: type, size, year built, last sale, ta","description":"Search Rentcast property records by address, city and state, ZIP code or a radius: type, size, year built, last sale, tax history. Owner details are not returned. Each call counts as one request on your Rentcast plan. Use for \"Which single-family homes does Rentcast have on record in ZIP 78244\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Full address as 'Street, City, State, Zip'. Alone it targets one property; with radius it searches around it.","title":"Address"},"city":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"City name (case-sensitive), used with state.","title":"City"},"state":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter state abbreviation in capitals, for example 'TX'.","title":"State"},"zip_code":{"anyOf":[{"maxLength":5,"type":"string"},{"type":"null"}],"default":null,"description":"Five-digit ZIP code.","title":"Zip Code"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Latitude of a circular search centre; use with longitude and radius.","title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Longitude of a circular search centre; use with latitude and radius.","title":"Longitude"},"radius":{"anyOf":[{"maximum":100,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Search radius in miles (maximum 100), used with latitude and longitude or with address.","title":"Radius"},"property_type":{"anyOf":[{"enum":["Single Family","Condo","Townhouse","Manufactured","Multi-Family","Apartment","Land"],"type":"string"},{"type":"null"}],"default":null,"description":"Property type. One of Single Family, Condo, Townhouse, Manufactured, Multi-Family, Apartment, Land.","title":"Property Type"},"bedrooms":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Bedrooms: a number (0 is studio), a range like '2-3' or several values like '2,3'.","title":"Bedrooms"},"bathrooms":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Bathrooms: a number, a range like '1-2' or several values.","title":"Bathrooms"},"square_footage":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Living area in square feet: a number, a range like '1500-2500' or several values.","title":"Square Footage"},"year_built":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Year built: a number, a range like '1990-2010' or several values.","title":"Year Built"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 500).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first record to return, for paging (0 for the first page).","title":"Offset"}},"title":"search_propertiesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_property":{"post":{"operationId":"get_property","summary":"Get one Rentcast property record by its Rentcast id: address, attributes, last sale, assessments, taxes and sale history","description":"Get one Rentcast property record by its Rentcast id: address, attributes, last sale, assessments, taxes and sale history. Owner details are not returned. Use for \"Show the Rentcast record for property id 5500-Grand-Lake-Dr,-San-Antonio,-TX-78244\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Rentcast property id (case-sensitive), as returned by search_properties.","maxLength":120,"title":"Id","type":"string"}},"required":["id"],"title":"get_propertyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/estimate_value":{"post":{"operationId":"estimate_value","summary":"Estimate the market value of a property from comparable sale listings: value, low and high range, subject details and th","description":"Estimate the market value of a property from comparable sale listings: value, low and high range, subject details and the comparables used. Use for \"What is 5500 Grand Lake Dr, San Antonio, TX 78244 worth\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Full address as 'Street, City, State, Zip'. Give this or latitude and longitude.","title":"Address"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, as an alternative to address.","title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Longitude, as an alternative to address.","title":"Longitude"},"property_type":{"anyOf":[{"enum":["Single Family","Condo","Townhouse","Manufactured","Multi-Family","Apartment","Land"],"type":"string"},{"type":"null"}],"default":null,"description":"Property type of the subject. One of Single Family, Condo, Townhouse, Manufactured, Multi-Family, Apartment, Land.","title":"Property Type"},"bedrooms":{"anyOf":[{"maximum":50,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Bedroom count of the subject (0 means studio).","title":"Bedrooms"},"bathrooms":{"anyOf":[{"maximum":50,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Bathroom count of the subject (fractions allowed).","title":"Bathrooms"},"square_footage":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Living area of the subject in square feet.","title":"Square Footage"},"max_radius":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Largest distance in miles from the subject to comparable listings.","title":"Max Radius"},"days_old":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Largest number of days since a comparable was last seen on the market (at least 1).","title":"Days Old"},"comp_count":{"anyOf":[{"maximum":25,"minimum":5,"type":"integer"},{"type":"null"}],"default":null,"description":"Number of comparable listings to use (5 to 25).","title":"Comp Count"},"lookup_subject_attributes":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to let the service look up the subject's own attributes for better comparables.","title":"Lookup Subject Attributes"}},"title":"estimate_valueArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/estimate_rent":{"post":{"operationId":"estimate_rent","summary":"Estimate the long-term monthly rent of a property from comparable rental listings: rent, low and high range, subject det","description":"Estimate the long-term monthly rent of a property from comparable rental listings: rent, low and high range, subject details and the comparables. Use for \"What rent could 5500 Grand Lake Dr, San Antonio, TX 78244 fetch per month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Full address as 'Street, City, State, Zip'. Give this or latitude and longitude.","title":"Address"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Latitude, as an alternative to address.","title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Longitude, as an alternative to address.","title":"Longitude"},"property_type":{"anyOf":[{"enum":["Single Family","Condo","Townhouse","Manufactured","Multi-Family","Apartment"],"type":"string"},{"type":"null"}],"default":null,"description":"Property type of the subject. One of Single Family, Condo, Townhouse, Manufactured, Multi-Family, Apartment.","title":"Property Type"},"bedrooms":{"anyOf":[{"maximum":50,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Bedroom count of the subject (0 means studio).","title":"Bedrooms"},"bathrooms":{"anyOf":[{"maximum":50,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Bathroom count of the subject (fractions allowed).","title":"Bathrooms"},"square_footage":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Living area of the subject in square feet.","title":"Square Footage"},"max_radius":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Largest distance in miles from the subject to comparable listings.","title":"Max Radius"},"days_old":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Largest number of days since a comparable was last seen on the market (at least 1).","title":"Days Old"},"comp_count":{"anyOf":[{"maximum":25,"minimum":5,"type":"integer"},{"type":"null"}],"default":null,"description":"Number of comparable listings to use (5 to 25).","title":"Comp Count"},"lookup_subject_attributes":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to let the service look up the subject's own attributes for better comparables.","title":"Lookup Subject Attributes"}},"title":"estimate_rentArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_sale_listings":{"post":{"operationId":"list_sale_listings","summary":"List properties listed for sale, newest seen first, filtered by place, radius, type, bedrooms, price and status, with da","description":"List properties listed for sale, newest seen first, filtered by place, radius, type, bedrooms, price and status, with days on market and listing office name. Use for \"Which houses are for sale in Austin, TX under 500000\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Full address as 'Street, City, State, Zip'. Alone it targets one property; with radius it searches around it.","title":"Address"},"city":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"City name (case-sensitive), used with state.","title":"City"},"state":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter state abbreviation in capitals, for example 'TX'.","title":"State"},"zip_code":{"anyOf":[{"maxLength":5,"type":"string"},{"type":"null"}],"default":null,"description":"Five-digit ZIP code.","title":"Zip Code"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Latitude of a circular search centre; use with longitude and radius.","title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Longitude of a circular search centre; use with latitude and radius.","title":"Longitude"},"radius":{"anyOf":[{"maximum":100,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Search radius in miles (maximum 100), used with latitude and longitude or with address.","title":"Radius"},"property_type":{"anyOf":[{"enum":["Single Family","Condo","Townhouse","Manufactured","Multi-Family","Apartment","Land"],"type":"string"},{"type":"null"}],"default":null,"description":"Property type. One of Single Family, Condo, Townhouse, Manufactured, Multi-Family, Apartment, Land.","title":"Property Type"},"bedrooms":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Bedrooms: a number (0 is studio), a range like '2-3' or several values like '2,3'.","title":"Bedrooms"},"bathrooms":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Bathrooms: a number, a range like '1-2' or several values.","title":"Bathrooms"},"price":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Listed price or rent: a number, a range like '1000-2000' or several values.","title":"Price"},"status":{"anyOf":[{"enum":["Active","Inactive"],"type":"string"},{"type":"null"}],"default":null,"description":"Listing status: Active or Inactive (the service defaults to Active).","title":"Status"},"days_old":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Days since listing: a number of at least 1 or a range like '1-30'.","title":"Days Old"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 500).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first record to return, for paging (0 for the first page).","title":"Offset"}},"title":"list_sale_listingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_rental_listings":{"post":{"operationId":"list_rental_listings","summary":"List long-term rental listings, newest seen first, filtered by place, radius, type, bedrooms, rent and status, with days","description":"List long-term rental listings, newest seen first, filtered by place, radius, type, bedrooms, rent and status, with days on market and listing office name. Use for \"Which apartments are for rent in ZIP 78701 for under 2500 a month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Full address as 'Street, City, State, Zip'. Alone it targets one property; with radius it searches around it.","title":"Address"},"city":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"City name (case-sensitive), used with state.","title":"City"},"state":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter state abbreviation in capitals, for example 'TX'.","title":"State"},"zip_code":{"anyOf":[{"maxLength":5,"type":"string"},{"type":"null"}],"default":null,"description":"Five-digit ZIP code.","title":"Zip Code"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Latitude of a circular search centre; use with longitude and radius.","title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Longitude of a circular search centre; use with latitude and radius.","title":"Longitude"},"radius":{"anyOf":[{"maximum":100,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Search radius in miles (maximum 100), used with latitude and longitude or with address.","title":"Radius"},"property_type":{"anyOf":[{"enum":["Single Family","Condo","Townhouse","Manufactured","Multi-Family","Apartment"],"type":"string"},{"type":"null"}],"default":null,"description":"Property type. One of Single Family, Condo, Townhouse, Manufactured, Multi-Family, Apartment.","title":"Property Type"},"bedrooms":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Bedrooms: a number (0 is studio), a range like '2-3' or several values like '2,3'.","title":"Bedrooms"},"bathrooms":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Bathrooms: a number, a range like '1-2' or several values.","title":"Bathrooms"},"price":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Listed price or rent: a number, a range like '1000-2000' or several values.","title":"Price"},"status":{"anyOf":[{"enum":["Active","Inactive"],"type":"string"},{"type":"null"}],"default":null,"description":"Listing status: Active or Inactive (the service defaults to Active).","title":"Status"},"days_old":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Days since listing: a number of at least 1 or a range like '1-30'.","title":"Days Old"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 500).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first record to return, for paging (0 for the first page).","title":"Offset"}},"title":"list_rental_listingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_market_statistics":{"post":{"operationId":"get_market_statistics","summary":"Get sale and rental market statistics for one US ZIP code: average and median price or rent, price per square foot, days","description":"Get sale and rental market statistics for one US ZIP code: average and median price or rent, price per square foot, days on market, listing counts, breakdowns by property type and bedrooms, and monthly history. Use for \"What are the median home price and rent in ZIP 29611\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zip_code":{"description":"Five-digit US ZIP code.","maxLength":5,"title":"Zip Code","type":"string"},"data_type":{"anyOf":[{"enum":["All","Sale","Rental"],"type":"string"},{"type":"null"}],"default":null,"description":"Which statistics: All, Sale or Rental (the service defaults to All).","title":"Data Type"},"history_range":{"anyOf":[{"maximum":120,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Number of months of history to include (at least 1).","title":"History Range"}},"required":["zip_code"],"title":"get_market_statisticsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}