scraper-api-com WG Gesucht API
WG-Gesucht: read-only. 2 public endpoints, no account needed.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/scraper-api-com:scraper-api-com-wg-gesucht-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: scraper-api.com WG Gesucht API
version: 0.1.0
description: 'Self-hosted social media scraping API — a drop-in replacement for scrapecreators.com.
## Authentication
Every request must send your API key in the `x-api-key` header.
## Credits
Billing is credit-based: **1 request = 1 credit** (some endpoints cost more — see each endpoint''s description). Credits are **non-expiring** — buy once, use whenever.
Response bodies match the ScrapeCreators shapes so existing integrations work unchanged.'
contact:
name: Fabian Bitter
email: fabian@bitter.de
servers:
- url: https://api.scraper-api.com
description: Production
security:
- apiKeyAuth: []
tags:
- name: WG-Gesucht
description: 'WG-Gesucht: read-only. 2 public endpoints, no account needed.'
paths:
/v1/wggesucht/search:
get:
tags:
- WG-Gesucht
summary: Search WG-Gesucht.de ads (shared-flat rooms, 1-room apartments, apartments…
operationId: wggesucht_v1_search
description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
security:
- apiKeyAuth: []
parameters:
- name: location
in: query
required: false
description: 'City name, resolved to the portal''s city id. Prefix match; an exact name wins. Provide at least one of: location, city_id.'
schema:
type: string
example: Köln
- name: city_id
in: query
required: false
description: 'WG-Gesucht city id (73 = Köln). Skips the lookup. Provide at least one of: location, city_id.'
schema:
type: string
example: '73'
- name: category
in: query
required: false
description: What to search. Defaults to wg_room.
schema:
type: string
enum:
- wg_room
- one_room_apartment
- apartment
- house
example: apartment
- name: rent_type
in: query
required: false
description: Rental period. Comma-separated; omit for all.
schema:
type: string
enum:
- unlimited
- limited
- overnight
example: unlimited
- name: price_min
in: query
required: false
description: Minimum total monthly rent in EUR.
schema:
type: string
example: '300'
- name: price_max
in: query
required: false
description: Maximum total monthly rent in EUR.
schema:
type: string
example: '900'
- name: size_min
in: query
required: false
description: Minimum size in m² (room size for WG rooms).
schema:
type: string
example: '15'
- name: size_max
in: query
required: false
description: Maximum size in m².
schema:
type: string
example: '60'
- name: rooms_min
in: query
required: false
description: Minimum number of rooms (apartments and houses).
schema:
type: string
example: '2'
- name: rooms_max
in: query
required: false
description: Maximum number of rooms.
schema:
type: string
example: '3'
- name: only_with_images
in: query
required: false
description: Only ads that have photos.
schema:
type: string
enum:
- 'true'
- 'false'
example: 'true'
- name: sort
in: query
required: false
description: Result order. Defaults to newest.
schema:
type: string
enum:
- newest
- price_asc
- price_desc
- size_asc
- size_desc
- available_asc
- available_desc
example: price_asc
- name: page
in: query
required: false
description: 1-based page number; the portal's page holds about 20 to 30 ads.
schema:
type: string
example: '1'
- name: page_size
in: query
required: false
description: Cap on returned results per page; the portal's own page size is fixed.
schema:
type: string
example: '10'
responses:
'200':
description: Platform-native JSON payload (ScrapeCreators-compatible).
content:
application/json:
example:
success: true
query:
location: Köln
city_id: '73'
city: Köln
state: Nordrhein-Westfalen
category: wg_room
rent_types: []
sort: newest
page: 1
page_size: 1
total_results: 572
total_results_all_categories: 970
number_of_pages: 29
has_next_page: true
count: 1
results:
- id: '14294058'
url: https://www.wg-gesucht.de/14294058.html
title: Gemütliches Zimmer in 3er WG
category: wg_room
type_label: 3er WG
price: 365
price_label: 365 €
price_period: pro Monat
size: 10
rooms: null
wg_size: 3
flatmates:
current: 2
total: 3
address:
street: Münchener Straße
city: Köln
district: Höhenberg
available_from: '2026-12-15'
available_to: null
thumbnail: https://img.wg-gesucht.de/media/up/2026/43/d061eed05b957289d6a3a4d37e21cd6da5f096e9885971a28aafd8e1b8d88f46_179328782270094674062270062147.small.JPEG
provider:
name: Livia
type: Privat
avatar: null
online_since: 42 Min.
instant_booking: false
is_premium: false
'400':
description: Missing or invalid parameters.
content:
application/json:
example:
error:
message: 'Missing required parameter(s): handle'
'401':
description: Missing or invalid API key.
content:
application/json:
example:
error:
message: Invalid API key.
'402':
description: Not enough credits.
content:
application/json:
example:
error:
message: Insufficient credits.
'429':
description: Rate limit exceeded.
content:
application/json:
example:
error:
message: Rate limit exceeded.
'502':
description: Upstream scrape failed.
content:
application/json:
example:
error:
message: Upstream scrape failed.
/v1/wggesucht/ad:
get:
tags:
- WG-Gesucht
summary: 'Get one WG-Gesucht.de ad (full detail: costs, address and coordinates…'
operationId: wggesucht_v1_ad
description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
security:
- apiKeyAuth: []
parameters:
- name: id
in: query
required: false
description: 'Ad id (the number in the ad URL). Provide at least one of: id, url.'
schema:
type: string
example: '14294058'
- name: url
in: query
required: false
description: 'Public ad URL. Provide at least one of: id, url.'
schema:
type: string
example: https://www.wg-gesucht.de/14294058.html
responses:
'200':
description: Platform-native JSON payload (ScrapeCreators-compatible).
content:
application/json:
example:
success: true
data:
id: '14294058'
url: https://www.wg-gesucht.de/wg-zimmer-in-Koeln-Hoehenberg.14294058.html
title: Gemütliches Zimmer in 3er WG
category: wg_room
size: 10
total_rent: 365
rooms: null
rent: 300
extra_costs: 65
other_costs: null
deposit: null
transfer_fee: null
address:
street: Münchener Straße
zip_code: '51103'
city: Köln
district: Höhenberg
lat: 50.9688
lon: 7.0371
available_from: '2026-12-15'
available_to: null
online_since: 42 Minuten
member_since: Oktober 2026
descriptions:
- title: Zimmer
text: In unserer schönen und hellen Dachgeschosswohnung wird ein Zimmer frei.
- title: Lage
text: Die Bahnhaltestelle ist 3 Minuten zu Fuß entfernt.
features:
- icon: office-building
text: 4. OG
- icon: bus
text: 3 Minuten zu Fuß entfernt
energy:
certificate: null
energy_class: null
construction_year: null
wg:
- title: Die WG
items:
- 10m² Zimmer in 3er WG
- 'Wohnungsgröße: 80m²'
- 'Bewohneralter: 24 bis 27 Jahre'
images:
- url: https://img.wg-gesucht.de/media/up/2026/43/d061eed05b957289d6a3a4d37e21cd6da5f096e9885971a28aafd8e1b8d88f46_179328782270094674062270062147.large.JPEG
caption: null
'400':
description: Missing or invalid parameters.
content:
application/json:
example:
error:
message: 'Missing required parameter(s): handle'
'401':
description: Missing or invalid API key.
content:
application/json:
example:
error:
message: Invalid API key.
'402':
description: Not enough credits.
content:
application/json:
example:
error:
message: Insufficient credits.
'429':
description: Rate limit exceeded.
content:
application/json:
example:
error:
message: Rate limit exceeded.
'502':
description: Upstream scrape failed.
content:
application/json:
example:
error:
message: Upstream scrape failed.
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: Your scraper-api.com API key.
x-tagGroups:
- name: Platforms
tags:
- Instagram
- TikTok
- YouTube
- Facebook
- LinkedIn
- Twitter
- Spotify
- Apple Music
- Kleinanzeigen
- Quoka
- markt.de
- mobile.de
- '11880'
- Gelbe Seiten
- ImmobilienScout24
- immowelt
- WG-Gesucht
- Bayut
- LOVOO
- Jaumo
- Tinder
- Bumble
- Snapchat
- Google
- Arbeitsagentur
- Ausbildung.de
- meinestadt.de