---
title: "Search live listings"
method: GET
path: "/search"
tags: ["Search"]
---

# Search live listings

`GET /search`

## Request

- Base URL: `https://api.kleinanzeigen-agent.de/api/v2/kleinanzeigen`
- URL: `https://api.kleinanzeigen-agent.de/api/v2/kleinanzeigen/search`
- Auth: one of:
  - API key in header `klaz_key`
  - HTTP bearer

## Query parameters

- `q` string
- `category_id` string
- `location_id` string
- `distance` string
- `min_price` integer
- `max_price` integer
- `picture_required` boolean
- `buy_now_only` boolean
- `shippable` boolean
- `ad_type` 'OFFER' | 'WANTED'
- `poster_type` 'PRIVATE' | 'COMMERCIAL'
- `latitude` number
- `longitude` number
- `page` integer
- `size` integer

## Response `200`

Successful normalized Kleinanzeigen response

- SuccessResponse
  - `success` unknown, required
  - `message` string
  - `data` object, required
  - `request_id` string, required

## Other responses

- `400`: Invalid request parameters.
- `401`: Missing or invalid API key.
- `402`: The account has insufficient credits.
- `429`: A plan or upstream rate limit was reached.
- `502`: Kleinanzeigen is temporarily unavailable.

---

[API](https://skmtc.dev/kleinanzeigen-agent/apis/kleinanzeigen-agent-api.md) · [All operations](https://skmtc.dev/kleinanzeigen-agent/apis/kleinanzeigen-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kleinanzeigen-agent/apis/kleinanzeigen-agent-api/revisions/cb3a02e55d40?raw)