kleinanzeigen-agent-de

kleinanzeigen-agent-de Ads API

The Ads API from kleinanzeigen-agent-de — 4 operation(s) for ads.

Documentation GitHub OpenAPI

Operations 4

GET /ads/{ad_id} Get live ad details #

GET /ads/{ad_id}/status Get live ad status #

GET /ads/{ad_id}/similar List similar live ads #

GET /ads/{ad_id}/seller-ads List up to 30 other live ads from the seller of an ad #

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/kleinanzeigen-agent-de:kleinanzeigen-agent-de-ads-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Kleinanzeigen Agent Ads 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: Ads
paths:
  /ads/{ad_id}:
    get:
      operationId: getKleinanzeigenAd
      summary: Get live ad details
      parameters:
      - name: ad_id
        in: path
        required: true
        description: Numeric Kleinanzeigen ad ID.
        schema:
          type: string
      - name: include_views
        in: query
        schema:
          type: boolean
          default: false
      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:
      - Ads
  /ads/{ad_id}/status:
    get:
      operationId: getKleinanzeigenAdStatus
      summary: Get live ad status
      parameters:
      - name: ad_id
        in: path
        required: true
        description: Numeric Kleinanzeigen ad ID.
        schema:
          type: string
      - name: include_views
        in: query
        schema:
          type: boolean
          default: false
      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:
      - Ads
  /ads/{ad_id}/similar:
    get:
      operationId: getKleinanzeigenSimilarAds
      summary: List similar live ads
      parameters:
      - name: ad_id
        in: path
        required: true
        description: Numeric Kleinanzeigen ad ID.
        schema:
          type: string
      - name: size
        in: query
        description: Number of similar ads.
        schema:
          type: integer
          minimum: 1
          maximum: 10
          default: 10
      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:
      - Ads
  /ads/{ad_id}/seller-ads:
    get:
      operationId: getKleinanzeigenAdSellerAds
      summary: List up to 30 other live ads from the seller of an ad
      parameters:
      - name: ad_id
        in: path
        required: true
        description: Numeric Kleinanzeigen ad ID.
        schema:
          type: string
      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:
      - Ads
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