{"openapi":"3.1.0","info":{"title":"Maymont Homes API","version":"2.0.0","description":"AI-discoverable rental property API with feeds, search, and structured data.\n\n## Data Conventions\n- **Prices** are in whole USD dollars (e.g., 2100 = $2,100/month)\n- **IDs** are prefixed by type: `sfr:12345` for single-family homes\n- **Dates** are ISO 8601 format (YYYY-MM-DD or full timestamp)\n- **Missing data** returns null, never invented values","contact":{"email":"api@maymonthomes.com"}},"servers":[{"url":"https://maymonthomes.com"}],"paths":{"/feed/properties.json":{"get":{"summary":"All property listings","operationId":"getPropertiesFeed","responses":{"200":{"description":"Property feed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingFeed"}}}}}}},"/feed/organization.json":{"get":{"summary":"Organization info and feed endpoints","operationId":"getOrganizationFeed","responses":{"200":{"description":"Organization feed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationFeed"}}}}}}},"/feed/markets.json":{"get":{"summary":"Markets with statistics","operationId":"getMarketsFeed","responses":{"200":{"description":"Markets feed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketFeed"}}}}}}},"/feed/cities.json":{"get":{"summary":"Cities with listings","operationId":"getCitiesFeed","responses":{"200":{"description":"Cities feed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CityFeed"}}}}}}},"/feed/neighborhoods.json":{"get":{"summary":"Neighborhoods with listings","operationId":"getNeighborhoodsFeed","responses":{"200":{"description":"Neighborhoods feed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NeighborhoodFeed"}}}}}}},"/feed/help.json":{"get":{"summary":"FAQ and help articles","operationId":"getHelpFeed","responses":{"200":{"description":"Help feed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HelpFeed"}}}}}}},"/api/search":{"get":{"summary":"Search properties with filters","operationId":"searchProperties","parameters":[{"name":"city","in":"query","schema":{"type":"string"},"description":"Filter by city name or slug"},{"name":"state","in":"query","schema":{"type":"string"},"description":"Filter by state (e.g., GA, TX)"},{"name":"market","in":"query","schema":{"type":"string"},"description":"Filter by market name or slug"},{"name":"beds","in":"query","schema":{"type":"integer"},"description":"Exact bedroom count"},{"name":"baths","in":"query","schema":{"type":"number"},"description":"Minimum bathrooms"},{"name":"minRent","in":"query","schema":{"type":"integer"},"description":"Minimum monthly rent"},{"name":"maxRent","in":"query","schema":{"type":"integer"},"description":"Maximum monthly rent"},{"name":"petFriendly","in":"query","schema":{"type":"boolean"},"description":"Only pet-friendly"},{"name":"availableNow","in":"query","schema":{"type":"boolean"},"description":"Only currently available"},{"name":"availableBefore","in":"query","schema":{"type":"string","format":"date"},"description":"Available before date"},{"name":"availableAfter","in":"query","schema":{"type":"string","format":"date"},"description":"Available after date"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}}}}},"/api/feed/properties/{id}":{"get":{"summary":"Get single property by ID","operationId":"getPropertyById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^(sfr:)?\\d+$"},"description":"Property ID. Accepts numeric ID (12345) or prefixed (sfr:12345 or sfr%3A12345). Canonical format is sfr:12345."}],"responses":{"200":{"description":"Property details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyResponse"}}}},"404":{"description":"Property not found"}}}}},"components":{"schemas":{"FeedMeta":{"type":"object","properties":{"version":{"type":"string"},"format":{"type":"string"},"generated":{"type":"string","format":"date-time"},"generator":{"type":"string"},"ttl":{"type":"integer"},"source":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"}}}}},"ListingFeed":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/FeedMeta"},"count":{"type":"integer"},"listings":{"type":"array","items":{"$ref":"#/components/schemas/ListingEntry"}}}},"ListingEntry":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"address":{"type":"object"},"specs":{"type":"object"},"rent":{"type":"object"},"availability":{"type":"object"}}},"OrganizationFeed":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/FeedMeta"},"name":{"type":"string"},"description":{"type":"string"},"website":{"type":"string"},"contact":{"type":"object","properties":{"email":{"type":"string"},"phone":{"type":"string"}}},"marketsServed":{"type":"array","items":{"type":"string"},"description":"US state codes (e.g., GA, TX, FL)"},"feedEndpoints":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"},"format":{"type":"string"},"ttl":{"type":"integer"}}}}}},"MarketFeed":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/FeedMeta"},"count":{"type":"integer"},"markets":{"type":"array","items":{"$ref":"#/components/schemas/MarketEntry"}}}},"MarketEntry":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"listingCount":{"type":"integer"},"rentRange":{"type":"object"}}},"CityFeed":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/FeedMeta"},"count":{"type":"integer"},"cities":{"type":"array","items":{"type":"object"}}}},"NeighborhoodFeed":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/FeedMeta"},"count":{"type":"integer"},"neighborhoods":{"type":"array","items":{"type":"object"}}}},"HelpFeed":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/FeedMeta"},"count":{"type":"integer"},"articles":{"type":"array","items":{"$ref":"#/components/schemas/HelpArticle"}}}},"HelpArticle":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"faqs":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"answer":{"type":"string"}}}}}},"SearchResponse":{"type":"object","properties":{"meta":{"type":"object","properties":{"query":{"type":"object"},"count":{"type":"integer"},"generated":{"type":"string"}}},"results":{"type":"array","items":{"$ref":"#/components/schemas/ListingEntry"}}}},"PropertyResponse":{"type":"object","properties":{"meta":{"type":"object","properties":{"generated":{"type":"string"},"source":{"type":"string"}}},"property":{"$ref":"#/components/schemas/PropertyDetail"}}},"PropertyDetail":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"address":{"type":"object"},"coordinates":{"type":"object"},"specs":{"type":"object"},"features":{"type":"object"},"rent":{"type":"object"},"pricing":{"type":"object"},"availability":{"type":"object"},"petPolicy":{"type":"object"},"leaseTerms":{"type":"object"},"touring":{"type":"object"},"content":{"type":"object"},"market":{"type":"object"},"city":{"type":"object"},"neighborhood":{"type":"object"},"lastUpdated":{"type":"string"},"source":{"type":"string"}}}}}}