---
title: "Fetch a discovery feed"
method: GET
path: "/immoweb/discovery"
tags: ["Immoweb"]
---

# Fetch a discovery feed

`GET /immoweb/discovery`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/immoweb/discovery`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `module` 'guest' | 'newest-classifieds-for-sale' | 'newest-classifieds-for-rent' | 'popular-classifieds' | 'newest' | 'popular' | 'similar', required
- `transactionTypes` 'FOR_SALE' | 'FOR_RENT' | 'null', nullable
- `language` 'nl' | 'fr' | 'en' | 'null', nullable

## Response `200`

- union
  - string
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'immoweb_unknown_discovery_module', required
      - `message` string, required
  - object
    - `success` boolean, required
    - `module` string, required
    - `classifieds` unknown[], required
      - unknown
    - `search_context` unknown, required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` string, required
      - `message` string, required
  - object
    - `success` boolean, required
    - `module` string, required
    - `classifieds` unknown[], required
      - unknown
    - `search_context` unknown, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: One or more query parameters failed validation. No credits are charged.
- `503`: One upstream lookup per request. A failed lookup is never billed. transactionTypes is required for the newest, popular and similar modules.

---

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