Data Feeds & API
For AI agents, search engines, and partner integrations
Quick start: organization.json lists all available feeds. openapi.json provides full API documentation.
Search API
Query properties with filters. Returns JSON with matching listings.
GET https://maymonthomes.com/api/search?city=atlanta&beds=3&maxRent=2500&petFriendly=trueParameters
| Parameter | Type | Description |
|---|---|---|
| city | string | Filter by city name or slug |
| state | string | Filter by state (e.g., GA, TX) |
| market | string | Filter by market name or slug |
| beds | integer | Exact bedroom count |
| baths | number | Minimum bathroom count |
| minRent | integer | Minimum monthly rent in USD |
| maxRent | integer | Maximum monthly rent in USD |
| petFriendly | boolean | Only pet-friendly homes |
| availableNow | boolean | Only currently available homes |
| availableBefore | date | Available before date (YYYY-MM-DD) |
| availableAfter | date | Available after date (YYYY-MM-DD) |
Example Response
{
"meta": {
"query": { "city": "atlanta", "beds": 3, "maxRent": 2500 },
"count": 42,
"generated": "2026-06-10T12:00:00Z"
},
"results": [
{ "id": "sfr:12345", "url": "...", "address": {...}, ... }
]
}Single Property Lookup
Get full details for a specific property by its ID.
GET https://maymonthomes.com/api/feed/properties/12345Example Listing Object
{
"id": "sfr:12345",
"url": "https://maymontrentals.com/properties/12345",
"address": {
"street": "123 Main Street",
"city": "Atlanta",
"state": "GA",
"zip": "30301",
"country": "US"
},
"specs": {
"beds": 3,
"baths": 2,
"sqft": 1850,
"propertyType": "single-family"
},
"rent": {
"amount": 2100,
"currency": "USD"
},
"availability": {
"status": "available",
"date": "2026-06-15"
},
"petFriendly": true,
"selfTourAvailable": true
}Available Feeds
Single Property
Get details for a specific property by ID
JSON
Organization
Company information and feed directory
Markets
Geographic markets with rent statistics
Cities
Cities with listing counts and rent ranges
Neighborhoods
Neighborhood-level inventory data
Help & FAQ
Knowledge base with common questions
OpenAPI Spec
Full API documentation (OpenAPI 3.1)
Data Format
- All dates are ISO 8601 format (YYYY-MM-DD or full timestamp)
- Prices are in whole USD dollars (e.g., 2100 = $2,100/month)
- Coordinates use WGS84 (standard lat/lng)
- IDs are prefixed by type (e.g.,
sfr:12345for single-family) - Missing data returns
null, never invented values
Update Frequency
- Properties feed: Real-time (on request, cached 5 min)
- Search API: Real-time (on request, cached 5 min)
- Geographic feeds: Hourly aggregation
- Help/Organization: Daily