Skip to content Kleinanzeigen Public API Gateway Documentation
Kleinanzeigen Logo KA Api Documentation
POST
/v1/listings
 
curl --request POST \
  --url https://developer.kleinanzeigen.de/api/goods/v1/listings \
  --header 'Content-Type: application/json' \
  --header 'HttpHeaders.AUTHORIZATION: eyJhbGciOiJIUzI1NiIsInR5...' \
  --data '{ "category": "Familie_Kind_Baby/Spielzeug", "attributes": { "art": "actionfiguren", "condition": "like_new", "versand": "ja" }, "title": "My Listing", "description": "Description of my listing", "adType": "OFFER", "price": { "type": "FIXED", "amount": 100 }, "email": "john@abc.com", "phoneNumber": "123456789", "customReference": "345345353", "contactPerson": "John C" }'

Creates a new listing for the authenticated user under consumer goods

Parameters

Section titled “ Parameters ”

Header Parameters

Section titled “Header Parameters ”
HttpHeaders.AUTHORIZATION
required

Request Body required

Section titled “Request Body required ”

Listing to create

Media type application/json
object
title
required
string
category
required
string
description
required
string
attributes
required
object
key
additional properties
string
adType
required
string
price
required
object
type
required
string
amount
required
number format: double
email
required
string
phoneNumber
string | null
customReference
string | null
contactPerson
string | null
buyNow
boolean | null
urls
string | null
Example 
{
  "category": "Familie_Kind_Baby/Spielzeug",
  "attributes": {
    "art": "actionfiguren",
    "condition": "like_new",
    "versand": "ja"
  },
  "title": "My Listing",
  "description": "Description of my listing",
  "adType": "OFFER",
  "price": {
    "type": "FIXED",
    "amount": 100
  },
  "email": "john@abc.com",
  "phoneNumber": "123456789",
  "customReference": "345345353",
  "contactPerson": "John C"
}

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Listing created successfully

Media type application/json
string
Example 
{
  "uuid": "123e4567-e89b-12d3-a456-426614174000"
}

400

Section titled “400 ”

Bad Request - Invalid listing data

Media type application/json
object
type
string format: uri
title
string | null
status
integer format: int32
detail
string | null
instance
string | null format: uri
properties
object | null
Example 
{
  "type": "about:blank",
  "status": 400,
  "title": "Bad Request",
  "detail": "Failed to read request",
  "instance": "/api/v1/listings",
  "localizedTitle": "",
  "localizedDetail": "",
  "localizedMessage": ""
}