DDproperty Listing API returns the record of one listing in the same shape as a search item, with all photos, floor plans, site plans and videos. Send the listing url from a search result, or a listing id with listing_type. The record carries what the site shows on the result cards: no map coordinates, description text or fee notes. A listing that is no longer on the site answers not found. Not found and other failures are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
3 optional filters available.
string
Optional
Listing url from a search result. The listing type is read from the url.
https://example.com/product
string
Optional
Listing id from a search result. Needs listing_type.
1234567890
string
Optional
sale or rent. Needed with id.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"id": 11568442,
"url": "https://www.ddproperty.com/en/property/baan-navatara-condominium-bangkok-for-sale-11568442",
"agent": {
"id": 1265048,
"name": "Aksarapak Chittara",
"avatar": "https://th1-cdn.pgimgs.com/agent/1265048/APHO.7231460.V120B.jpg",
"license": null,
"tagline": null,
"is_verified": true,
"profile_url": "https://www.ddproperty.com/en/agent/aksarapak-chittara-1265048"
},
"price": {
"per": null,
"kind": "fixed",
"text": "\u0e3f3,200,000",
"value": 3200000,
"currency": "THB"
},
"title": "Baan Navatara Condominium, Bangkok",
"agency": {
"id": 40519,
"name": "Best Property Center Co., Ltd"
},
"badges": [
"Built: 2009",
"Condo",
"Freehold"
],
"images": [
"https://th1-cdn.pgimgs.com/listing/11568442/UPHO.124641631.V800/Baan-Navatara-Condominium-Bueng-Kum-Thailand.jpg",
"https://th1-cdn.pgimgs.com/listing/11568442/UPHO.124641632.V800/Baan-Navatara-Condominium-Bueng-Kum-Thailand.jpg",
"https://th1-cdn.pgimgs.com/listing/11568442/UPHO.124641633.V800/Baan-Navatara-Condominium-Bueng-Kum-Thailand.jpg",
"https://th1-cdn.pgimgs.com/listing/11568442/UPHO.124641634.V800/Baan-Navatara-Condominium-Bueng-Kum-Thailand.jpg"
],
"status": "ACT",
"tenure": {
"code": "F",
"label": "Freehold"
},
"videos": [],
"project": {
"id": 345,
"nano_id": "lyvef0",
"is_new_project": false
},
"transit": null,
"area_sqm": 67.05,
"bedrooms": 2,
"location": {
"area": {
"code": "TH102705",
"name": "Nuan Chan"
},
"region": {
"code": "TH10",
"name": "Bangkok"
},
"district": {
"code": "TH1027",
"name": "Bueng Kum"
},
"full_address": "900 Soi Prasert Manutak 33, Kaset - Nawamin Road, Nuan Chan, Bueng Kum, Bangkok",
"short_address": "Nuan Chan, Bueng Kum, Bangkok"
},
"area_text": "67 sqm",
"bathrooms": 2,
"developer": "Baan Rajprasong - \u0e1a\u0e49\u0e32\u0e19\u0e23\u0e32\u0e0a\u0e1b\u0e23\u0e30\u0e2a\u0e07\u0e04\u0e4c \u0e08\u0e33\u0e01\u0e31\u0e14 (\u0e21\u0e2b\u0e32\u0e0a\u0e19)",
"is_studio": false,
"posted_at": "2026-09-29T07:27:00+00:00",
"thumbnail": "https://th1-cdn.pgimgs.com/listing/11568442/UPHO.124641631.V550.jpg",
"build_info": "Built: 2009",
"site_plans": [],
"floor_plans": [],
"image_count": 4,
"posted_text": "Listed on Sep 29, 2026 (3w ago)",
"listing_type": "sale",
"is_pre_launch": false,
"parking_slots": null,
"property_type": {
"code": "CONDO",
"label": "Condo"
},
"virtual_tours": [],
"price_per_area": "\u0e3f47,726 / sqm",
"is_official_listing": true,
"is_developer_listing": false
},
"meta": {
"billable": true,
"endpoint_family": "listing"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
Neither url nor id was sent, the id has the wrong shape, or the url is not a DDproperty listing link. This response is not billable.
{
"errors": {
"listing_type": [
"A listing id needs listing_type (sale or rent)."
]
},
"message": "The request validation failed"
}Not Found
The listing is not on the site any more, or the listing type does not match. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "listing"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}Upstream Unavailable
DDproperty could not be reached or returned data that does not match the request. This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "DDproperty could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.