Buy MLS Data API

API Version: v4

Welcome to the Buy MLS Data API — your comprehensive solution for accessing real estate data. Our API provides access to property listings, agent information, and detailed market data across the United States.

Available Endpoints

Core Data Endpoints

GET /v4/stats - Database statistics (no auth required)
GET /v4/get_property_list - Search properties with filters
GET /v4/get_property_details - Complete property details with all related data
GET /v4/get_agents_list - Get paginated agent list
GET /v4/get_agents_details - Get agent details by location or property ID

Additional Data Endpoints

GET /v4/get_property_attribute_lists - Lead attributes
GET /v4/get_property_attribute_details - Lead attributes for specific property
GET /v4/get_property_photos - Property photos
GET /v4/get_property_flag_list - Property flags/features
GET /v4/get_property_flag_details - Flags for specific property

🔍 Advanced Filtering

Filter by location, price range, property type, bedrooms, bathrooms, and more with our comprehensive search parameters.

📊 Rich Data

Access detailed property information including photos, agent details, flags, lead attributes, and complete property profiles.

⚡ Fast & Reliable

Built for performance with pagination support, connection pooling, optimized queries, and reliable data delivery.

🔐 Secure Access

API key authentication ensures secure access to our comprehensive real estate database.

To get started with our API, you'll need an API key. All list endpoints automatically group results into **Pages** (10 records per page). Simply specify the limit for the total records you want to retrieve. Once you have your key, you can make requests to our endpoints:

Example: Get Database Statistics

GET /v4/stats

Example: Get Property List (20 items)

GET /v4/get_property_list?api_key=YOUR_API_KEY_HERE&limit=20

Example: Search Properties

GET /v4/get_property_list?api_key=YOUR_API_KEY_HERE&city=Miami&beds=3&list_price_min=500000&list_price_max=1000000

Example: Get Property Details

GET /v4/get_property_details?api_key=YOUR_API_KEY_HERE&property_id={property_id}

Example: Search Agents by Location

GET /v4/get_agents_details?api_key=YOUR_API_KEY_HERE&city=Miami

📚 View Full Documentation

Base URL

All API requests should be made to: http://localhost:5000/v4/