DDproperty Agent API returns the public profile of one agent: name, job title, agency name and logo, photo, profile text, services, public links, listing counts for sale and rent, the areas the agent works in, and the listing ids with map coordinates. Send the agent id from a listing, or the agent profile url. Phone numbers and messaging ids are not returned. An unknown agent 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.
2 optional filters available.
string
Optional
Agent id from a listing.
1234567890
string
Optional
Agent profile url (instead of id).
https://example.com/product
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": 10635723,
"url": "https://www.ddproperty.com/en/agent/ma-yuan-tao-10635723",
"name": "Ma Yuan Tao",
"links": {
"website": "https://lin.ee/EqlrFPJ",
"facebook": "https://www.facebook.com/yx.property.2024"
},
"photo": "https://th1-cdn.pgimgs.com/agent/10635723/APHO.132926932.R550X550.jpg",
"agency": {
"logo": "https://th1-cdn.pgimgs.com/agency/43020/CLOGO.82873223.R550X550.jpg",
"name": "YX PROPERTY"
},
"listings": {
"rent": [
{
"id": 500609630,
"latitude": 13.73361,
"longitude": 100.587195,
"region_code": "TH10"
},
{
"id": 11255277,
"latitude": 13.73361,
"longitude": 100.587195,
"region_code": "TH10"
}
],
"sale": [
{
"id": 500639902,
"latitude": 13.74782,
"longitude": 100.549062,
"region_code": "TH10"
},
{
"id": 500052796,
"latitude": 13.75939,
"longitude": 100.541384,
"region_code": "TH10"
}
]
},
"services": [
"Apartment Rental",
"Apartment Sales",
"Commercial Property",
"Landed House Rental",
"Landed House Sales",
"Mortgage Advisory",
"Official Valuations",
"Relocation Services"
],
"job_title": "\u0e1c\u0e39\u0e49\u0e08\u0e31\u0e14\u0e01\u0e32\u0e23\u0e1a\u0e31\u0e0d\u0e0a\u0e35",
"locations": [
{
"code": "TH10",
"name": "Bangkok",
"rent_count": 21,
"sale_count": 17
},
{
"code": "TH103902",
"name": "Khlong Tan Nua",
"rent_count": 4,
"sale_count": 0
},
{
"code": "TH103903",
"name": "Phra Kanong Nua",
"rent_count": 2,
"sale_count": 1
}
],
"description": "YX Property provides property sales, leasing and sourcing services for offices, commercial buildings, warehouses, factories, land, houses and condos.\n\nWe coordinate viewings, negotiations, contracts and handovers, with property management support available.\n\nContact us to list your property or discuss your requirements.",
"listing_counts": {
"rent": 26,
"sale": 18
}
},
"meta": {
"billable": true,
"endpoint_family": "agent"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
Neither id nor url was sent, or the id or url has the wrong shape. This response is not billable.
{
"errors": {
"id": [
"Send an agent id or the agent profile url."
]
},
"message": "The request validation failed"
}Not Found
No agent with this id exists. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "agent"
},
"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.