---
title: "Places Data"
method: GET
path: "/immowelt/places/data"
tags: ["Immowelt"]
---

# Places Data

`GET /immowelt/places/data`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/immowelt/places/data`
- Auth: API key in header `X-API-KEY`

Fetch place metadata for one or more placeIds.

## Query parameters

- `place_ids[]` string[], required
- `parent_types[]` string[], required

## Response `200`

- union
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'UPSTREAM_TIMEOUT' | 'UPSTREAM_ERROR' | 'PROXY_EXHAUSTION', required
      - `message` 'Places data request failed', required
      - `last_exception` string, required
  - object
    - `success` boolean, required
    - `places` object[], required
      - `id` string, nullable, required
      - `name` string, nullable, required
      - `type` string, nullable, required
      - `postal_codes` union, required
        - string
        - string[]
      - `lat` string, nullable, required
      - `lon` string, nullable, required
      - `full_name` string, nullable, required
      - `source` 'immowelt_bff', required
    - `raw` unknown, required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'UPSTREAM_ERROR', required
      - `message` 'Immowelt places data failed', required
      - `http_status` integer, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: Validation error
- `503`

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)
