# PropertyGuru Agent API Documentation

<p><strong>PropertyGuru Agent API</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/propertyguru-api/propertyguru_agent](https://scrappa.co/docs/propertyguru-api/propertyguru_agent)
- **API group:** PropertyGuru API
- **Endpoint:** `GET https://scrappa.co/api/propertyguru/v1/agent`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `market` | string | Yes | Market to search: sg (Singapore) or my (Malaysia). Example: sg. |
| `id` | string | Yes | Numeric agent id. Example: 901720421. |
| `slug` | string | No | Optional profile slug (lowercase letters, digits and dashes). Without it the id is resolved first. Example: eng-ong. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a range is invalid. This response is not billable. |
| 404 | Not Found | The agent does not exist. This response is not billable. |
| 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. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)