# Zumper Location Scores

Returns the location scores Zumper shows for a place. kind=place (default) scores a place by type and name. kind=geo scores it at a geography level.

- **Documentation:** [https://scrappa.co/docs/zumper-api/zumper_location_scores](https://scrappa.co/docs/zumper-api/zumper_location_scores)
- **API group:** Zumper API
- **Endpoint:** `GET https://scrappa.co/api/zumper/location-scores`

## 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 |
| --- | --- | --- | --- |
| `kind` | string | No | place (default) or geo. Allowed: place, geo. |
| `type` | string | Yes | Place type. Allowed: city, neighborhood, zip. |
| `name` | string | Yes | Place name, for example San Francisco. |
| `lat` | number | Yes | Latitude. |
| `lng` | number | Yes | Longitude. |

## Example response

```json
{
    "data": {
        "group_id": 58607065,
        "city_state": "san-francisco-ca",
        "created_on": 1614737556,
        "initial_lat": 37.774929,
        "initial_lng": -122.41941,
        "modified_on": 1614737556,
        "reduced_lat": 37774,
        "reduced_lng": -122419,
        "scores_json": {
            "cafes": {
                "text": "Variety of caf\u00e9s right on the street",
                "value": "4.83249",
                "display_name": "Cafes"
            },
            "parks": {
                "text": "Very large amount of park space within a few minutes' walk",
                "value": "5.0",
                "display_name": "Parks"
            },
            "quiet": {
                "text": "Many sources of noise nearby",
                "value": "0.0"
            },
            "vibrant": {
                "text": "Vibrant atmosphere all day and into the evening",
                "value": "4.0613098297915435"
            },
            "daycares": {
                "text": "At least one daycare within a 5-minute walk",
                "value": "4.58703"
            },
            "greenery": {
                "text": "Few street trees or parks in the area",
                "value": "2.658042"
            },
            "historic": {
                "text": "Some historical buildings nearby",
                "value": "3.37973"
            },
            "shopping": {
                "text": "Wide variety of shops within a few minutes' walk",
                "value": "5.0",
                "display_name": "Shopping"
            },
            "groceries": {
                "text": "Several grocery stores nearby",
                "value": "4.9324074",
                "display_name": "Groceries"
            },
            "nightlife": {
                "text": "Variety of bars right on the street",
                "value": "4.84216",
                "display_name": "Nightlife"
            }
        },
        "location_scores_id": 5576
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested listing, building, or page was not found. 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)