kleinanzeigen-agent-de Search API
The Search API from kleinanzeigen-agent-de — 2 operation(s) for search.
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/kleinanzeigen-agent-de:kleinanzeigen-agent-de-search-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: Kleinanzeigen Agent Search API
version: 2.0.0
description: Authenticated read API for live, normalized public Kleinanzeigen data plus an archive of listings recorded since October 2026. Requests consume the documented Kleinanzeigen Agent credits.
contact:
email: office@kleinanzeigen-agent.de
servers:
- url: https://api.kleinanzeigen-agent.de/api/v2/kleinanzeigen
description: Production API v2
tags:
- name: Search
paths:
/search:
get:
operationId: searchKleinanzeigen
summary: Search live listings
parameters:
- name: q
in: query
description: Search text.
schema:
type: string
maxLength: 200
- name: category_id
in: query
schema:
type: string
- name: location_id
in: query
schema:
type: string
- name: distance
in: query
schema:
type: string
- name: min_price
in: query
schema:
type: integer
minimum: 0
- name: max_price
in: query
schema:
type: integer
minimum: 0
- name: picture_required
in: query
schema:
type: boolean
- name: buy_now_only
in: query
schema:
type: boolean
- name: shippable
in: query
schema:
type: boolean
- name: ad_type
in: query
schema:
type: string
enum:
- OFFER
- WANTED
- name: poster_type
in: query
schema:
type: string
enum:
- PRIVATE
- COMMERCIAL
- name: latitude
in: query
schema:
type: number
- name: longitude
in: query
schema:
type: number
- name: page
in: query
description: Zero-based result page.
schema:
type: integer
minimum: 0
maximum: 1000
default: 0
- name: size
in: query
description: Results per page.
schema:
type: integer
minimum: 1
maximum: 100
default: 31
security:
- KlazApiKey: []
- BearerApiKey: []
responses:
'200':
description: Successful normalized Kleinanzeigen response
content:
application/json:
schema:
$ref: '#/components/schemas/SuccessResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/InsufficientCredits'
'429':
$ref: '#/components/responses/RateLimited'
'502':
$ref: '#/components/responses/UpstreamUnavailable'
tags:
- Search
/search/category-counts:
get:
operationId: getKleinanzeigenSearchCategoryCounts
summary: Count live search results per category
parameters:
- name: q
in: query
description: Search text.
schema:
type: string
maxLength: 200
- name: category_id
in: query
schema:
type: string
- name: location_id
in: query
schema:
type: string
- name: distance
in: query
schema:
type: string
- name: min_price
in: query
schema:
type: integer
minimum: 0
- name: max_price
in: query
schema:
type: integer
minimum: 0
- name: picture_required
in: query
schema:
type: boolean
- name: buy_now_only
in: query
schema:
type: boolean
- name: shippable
in: query
schema:
type: boolean
- name: ad_type
in: query
schema:
type: string
enum:
- OFFER
- WANTED
- name: poster_type
in: query
schema:
type: string
enum:
- PRIVATE
- COMMERCIAL
- name: latitude
in: query
schema:
type: number
- name: longitude
in: query
schema:
type: number
security:
- KlazApiKey: []
- BearerApiKey: []
responses:
'200':
description: Successful normalized Kleinanzeigen response
content:
application/json:
schema:
$ref: '#/components/schemas/SuccessResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/InsufficientCredits'
'429':
$ref: '#/components/responses/RateLimited'
'502':
$ref: '#/components/responses/UpstreamUnavailable'
tags:
- Search
components:
schemas:
SuccessResponse:
type: object
required:
- success
- data
- request_id
properties:
success:
const: true
message:
type: string
data:
type: object
additionalProperties: true
request_id:
type: string
ErrorResponse:
type: object
required:
- success
- error_code
- message
- request_id
properties:
success:
const: false
error_code:
type: string
message:
type: string
errors:
type: object
additionalProperties: true
data:
type: object
additionalProperties: true
request_id:
type: string
responses:
UpstreamUnavailable:
description: Kleinanzeigen is temporarily unavailable.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Unauthorized:
description: Missing or invalid API key.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
BadRequest:
description: Invalid request parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
InsufficientCredits:
description: The account has insufficient credits.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
RateLimited:
description: A plan or upstream rate limit was reached.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
securitySchemes:
KlazApiKey:
type: apiKey
in: header
name: klaz_key
description: Kleinanzeigen Agent API key.
BearerApiKey:
type: http
scheme: bearer
description: API key sent as a Bearer token.
externalDocs:
description: Complete developer documentation as Markdown
url: https://kleinanzeigen-agent.de/api/docs-raw