# PadMapper Agent

Returns the public agent profile: name, brokerage, phone, picture, features, and profile url. Email is never returned. Pass agent_url exactly as published in a listing or building agents list, for example /pros/blueground/blueground-us. Most agents have no profile url, and then the agent name, brokerage, and phone on the listing rows are the public data.

- **Documentation:** [https://scrappa.co/docs/padmapper-api/padmapper_agent](https://scrappa.co/docs/padmapper-api/padmapper_agent)
- **API group:** PadMapper API
- **Endpoint:** `GET https://scrappa.co/api/padmapper/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 |
| --- | --- | --- | --- |
| `agent_url` | string | Yes | The /pros/{organisation}/{name} value from an agents list. |

## Example response

```json
{
    "data": {
        "url": "/pros/blueground/blueground-us",
        "phone": "(202) 937-1689",
        "colors": "#000f80",
        "region": "[chi]",
        "user_id": 14665954,
        "features": [
            23
        ],
        "logo_url": "",
        "brokerage": null,
        "last_name": "Us",
        "long_name": "Blueground Us",
        "created_on": 1733416362,
        "first_name": "Blueground",
        "video_urls": [],
        "has_profile": true,
        "picture_url": null,
        "company_name": "BLUEGROUND",
        "background_url": null,
        "long_description": "Blueground is the world\u2019s largest operator of fully furnished, move-in-ready apartments for extended stays, offering both our own homes and a curated, professionally vetted selection of partner listings.\n\nWith thousands of homes in major cities around the world, each one is thoughtfully designed with curated furnishings, fully equipped kitchens, and premium amenities like high-speed Wi-Fi and smart home entertainment. Many buildings also include access to gyms, pools, and outdoor spaces.\n\nEnjoy a seamless renting experience \u2014 browse and book online, confirm instantly, pay securely, and move in with ease. Manage everything through the Blueground Guest App, from scheduling a cleaning to requesting maintenance or extra linens. Enhance your stay with added convenience through our trusted partners, from car rentals to grocery delivery and laundry services.\n\nRedefining how people live.\n\nAt Blueground, we believe that when your base is reliable, the world opens up. That\u2019s why we\u2019re building the world\u2019s leading platform for living.",
        "short_description": null
    },
    "meta": {
        "duration_ms": 640,
        "upstream_calls": 1,
        "endpoint_family": "agent"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested listing, building, agent, or city was not found. Rent reports exist for US cities only. This response is not billable. |
| 422 | Validation Error | A required public parameter is missing or invalid. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result. This response is not billable. |

## 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)