Skip to content
Scrappa Get API key
PropertyGuru API 1 credit/request

PropertyGuru Agent API Documentation

GET https://scrappa.co/api/propertyguru/v1/agent

PropertyGuru Agent API returns the public profile of an agent: name, license, verified flag, photo, agency with license and logo, about text, rating with distribution, years of service, transactions in the last 3 years, specialities, skills, operating regions and public social links. Phone numbers and WhatsApp links are never returned. Get the agent id from the agent profile URL on a search item.

PropertyGuru Agent API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/propertyguru/v1/agent
Auth header
x-api-key
Cost
1 credit/request
market = US id = 1234567890
Response preview
200 OK
{
    "data": {
        "id": 901720421,
        "url": "https://propertyguru.com.sg/agent/eng-ong-901720421",
        "name": "Eng Ong",
        "about": "A great floor plan helps you visualise a home today; a data-backed strategy ensures it supports your future. I look beyo...",
        "clips": [],
        "photo": "https://sg1-cdn.pgimgs.com/agent/901720421/APHO.160706328.165139518.R550X550.png",
        "agency": {
            "logo": "https://sg1-cdn.pgimgs.com/agency/2/CLOGO.126945345.R550X550.png",
            "name": "ERA REALTY NETWORK PTE LTD",
            "license": "L3002382K"
        },
        "rating": {
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

2 required parameters needed before sending a request.

1 optional filter available.

market string Required

Market to search: sg (Singapore) or my (Malaysia). Example: sg.

Example value US
id string Required

Numeric agent id. Example: 901720421.

Example value 1234567890
slug string Optional

Optional profile slug (lowercase letters, digits and dashes). Without it the id is resolved first. Example: eng-ong.

Example value example

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "id": 901720421,
        "url": "https://propertyguru.com.sg/agent/eng-ong-901720421",
        "name": "Eng Ong",
        "about": "A great floor plan helps you visualise a home today; a data-backed strategy ensures it supports your future. I look beyo...",
        "clips": [],
        "photo": "https://sg1-cdn.pgimgs.com/agent/901720421/APHO.160706328.165139518.R550X550.png",
        "agency": {
            "logo": "https://sg1-cdn.pgimgs.com/agency/2/CLOGO.126945345.R550X550.png",
            "name": "ERA REALTY NETWORK PTE LTD",
            "license": "L3002382K"
        },
        "rating": {
            "count": 4,
            "average": 5,
            "breakdown": {
                "service": 5,
                "knowledge": 5,
                "marketing": 5,
                "reliability": 5
            },
            "distribution": {
                "1": 0,
                "2": 0,
                "3": 0,
                "4": 0,
                "5": 4
            }
        },
        "skills": [
            "Digital Marketing",
            "Sales & Negotiation",
            "Time Management"
        ],
        "license": "R074328A",
        "verified": true,
        "operates_in": [
            "Serangoon / Thomson (D19-20)",
            "North (D25-28)",
            "Newton / Bt. Timah (D11, 21)",
            "Orchard / Holland (D09-10)"
        ],
        "social_links": {
            "website": "https://thewinningmove.sg"
        },
        "specialities": [
            "Apartment Rental",
            "Apartment Sales",
            "Landed House Rental",
            "Landed House Sales",
            "HDB Sales",
            "HDB Rental"
        ],
        "years_of_service": 0,
        "transactions_last_3_years": 0
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agent"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required parameter or a range is invalid. This response is not billable.

{
    "errors": {
        "id": [
            "The id field is required."
        ]
    },
    "message": "The request validation failed"
}
404

Not Found

The agent does not exist. 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
}
503

Upstream Unavailable

PropertyGuru 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": "agent"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "PropertyGuru 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.