DDProperty APIddproperty.com ↗
Search Thailand property listings for sale and rent, get listing details, look up MRT/BTS stations, and calculate mortgage payments via the DDProperty API.
What is the DDProperty API?
The DDProperty API exposes 5 endpoints covering Thailand's largest property portal, letting you search sales and rental listings, retrieve full listing details, look up MRT/BTS transit stations, and run mortgage amortization calculations. The search_properties_for_sale endpoint alone returns paginated results with fields including price in THB, bedroom/bathroom counts, agent details, and address — all filterable by property type, price range, and keyword.
curl -X GET 'https://api.parse.bot/scraper/7daa3631-0833-4aa5-b97e-c09547f619ea/search_properties_for_sale?page=1&bedrooms=2&freetext=Bangkok&max_price=10000000&min_price=1000000&property_type=N' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ddproperty-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.ddproperty_thailand_api import DDProperty, PropertyType
dd = DDProperty()
# Search condos for sale in Bangkok
for listing in dd.listings.search_for_sale(freetext="Bangkok", property_type=PropertyType.CONDO, limit=3):
print(listing.title, listing.price, listing.beds, listing.address)
# Search rentals in Pattaya
for rental in dd.listings.search_for_rent(freetext="Pattaya", min_price="20000", limit=2):
print(rental.title, rental.price, rental.baths)
# Get property details by slug
detail = dd.properties.get(slug="chivani-pattaya-for-rent-500302429")
print(detail.title, detail.price, detail.floor_area, detail.listing_type)
print(detail.address.district, detail.address.region)
# Search MRT/BTS stations
for station in dd.stations.search(query="Ari"):
print(station.name, station.line, station.location.latitude, station.location.longitude)
# Calculate mortgage
mortgage = dd.mortgages.calculate(price=5000000, downpayment_pct=20, tenure_years=25)
print(mortgage.monthly_payment, mortgage.loan_amount, mortgage.total_interest)
Search properties for sale in Thailand. Supports free-text location search, property type filtering, price range, and bedroom count. Returns paginated listings ordered by recency. Each listing includes price, location, bedroom/bathroom count, and agent contact. Pagination via page number; total_pages in the response indicates the last available page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| bedrooms | string | Number of bedrooms filter |
| freetext | string | Search keyword such as location name or property name |
| max_price | string | Maximum price filter in THB |
| min_price | string | Minimum price filter in THB |
| property_type | string | Property type group code |
{
"type": "object",
"fields": {
"page": "integer current page number",
"total": "integer total number of matching listings",
"listings": "array of property listing objects with id, title, address, price, beds, baths, area, agent, and url",
"total_pages": "integer total number of pages"
},
"sample": {
"data": {
"page": 1,
"total": 80503,
"listings": [
{
"id": 60125081,
"mrt": "",
"url": "https://www.ddproperty.com/en/property/project/the-pavilion-pinklao-sai-4-bangkok-for-sale-60125081#3856",
"area": "",
"beds": 3,
"agent": {
"id": 900766919,
"name": "Agent Name",
"avatar": "https://th1-cdn.pgimgs.com/agent/900766919/APHO.134252107.V120B.jpg",
"description": "Private and in the best location"
},
"baths": 4,
"price": "฿12,900,000",
"title": "The Pavilion Pinklao-Sai 4, Bangkok",
"images": [],
"address": "265 Thawi Watthana, Bangkok",
"currency": "THB",
"property": {
"id": 15730,
"typeCode": "SALE",
"typeText": "For Sale",
"typeGroup": "B",
"newProject": false,
"isPremiumProjectListing": true
},
"posted_on": "10 Jun 2026",
"price_raw": 12900000,
"property_type": "For Sale",
"price_per_area": "฿40,952 / sqm"
}
],
"total_pages": 4026
},
"status": "success"
}
}About the DDProperty API
Search and Filter Listings
Both search_properties_for_sale and search_properties_for_rent accept overlapping filter sets: freetext for keyword or location search (e.g., 'Sukhumvit', 'Pattaya'), bedrooms, min_price/max_price in THB, and page for pagination. The sale endpoint adds a property_type filter using single-letter codes — N for condo, B for house, T for townhouse, V for villa, and L for land. Each response includes total, total_pages, and a listings array whose objects carry id, title, address, price, beds, baths, area, agent, and url.
Listing Detail
get_property_detail accepts a slug — the URL path segment that identifies a specific listing, formatted like <property-name>-for-sale-<listing-id>. The response adds fields not present in search results: images (array of image URLs), tenure (e.g., F for freehold), a structured address object with street, district, region, area, and postcode, and an agent object that includes id, name, and badges.
Transit Station Lookup and Mortgage Calculator
get_location_suggestions takes a query string and returns matching MRT/BTS station objects with id, name, type, line, line_color, and geographic coordinates — useful for filtering or tagging listings by transit proximity. calculate_mortgage accepts price, tenure_years, interest_rate, and downpayment_pct, and returns loan_amount, monthly_payment, total_interest, total_repayment, and total_downpayment — all in THB.
Coverage Notes
All listings and data reflect the Thai market only. Prices in search results are returned as formatted strings; the mortgage calculator expects a raw numeric price value. Pagination is cursor-free — use the integer page parameter alongside total_pages to walk result sets.
The DDProperty API is a managed, monitored endpoint for ddproperty.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ddproperty.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ddproperty.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Aggregate Bangkok condo listings filtered by BTS station proximity using coordinates from
get_location_suggestions. - Build a rental price comparison tool for specific districts using
freetextandmin_price/max_pricefilters. - Display full listing pages including images, tenure, and agent badges by resolving slugs via
get_property_detail. - Embed a mortgage calculator widget that shows monthly payment, total interest, and total repayment for any listed property.
- Scrape market-level data by paginating
search_properties_for_salewithproperty_type=Nto track condo price trends. - Cross-reference rental and sale prices for the same area by running parallel queries on both search endpoints.
- Populate a property recommendation engine using bedroom count, area, and address fields from paginated search results.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does DDProperty have an official developer API?+
What does `get_property_detail` return beyond what search results include?+
get_property_detail returns several fields absent from search listings: an images array of photo URLs, a tenure code (e.g., F for freehold), a structured address object broken into street, district, region, area, and postcode, and agent badges. You need the listing's URL slug to call this endpoint.Does the sale search support filtering by specific Bangkok districts or provinces beyond keyword search?+
search_properties_for_sale endpoint filters by freetext, property_type, bedrooms, and price range. It does not expose a dedicated district or province filter parameter — location scoping goes through the freetext field. You can fork this API on Parse and revise it to add a structured location parameter if your use case requires it.Does the API cover properties outside Thailand?+
How does pagination work across the search endpoints?+
page (current page), total (total matching listings), and total_pages. Pass the integer page parameter to step through results. There is no cursor-based pagination — you iterate by incrementing page up to the value of total_pages.