Skip to content Kleinanzeigen Public API Gateway Documentation
Kleinanzeigen Logo KA Api Documentation

How to Update a Listing

Section titled “How to Update a Listing”

This guide outlines the process of updating an existing listing and publishing it to make changes visible on the web. Please pay close attention to the IDs you receive, as they are crucial for subsequent steps.

Prerequisites

You will need your Listing UUID to begin, and the Publication UUID if the listing is already published.

Steps

Section titled “Steps”

1. Update a Listing

Section titled “1. Update a Listing”

Send a PUT request to the /listing/{listing_uuid} endpoint.

  • Include the specific fields you want to change in the request body.
  • Replace {listing_uuid} with your actual Listing UUID.
  • The API will return 204 No Content upon success.

2. Publish the Changes

Section titled “2. Publish the Changes”

Trigger the publication update by sending a PUT request to /listing/{listing_uuid}/publication/{publication_uuid}.

  • Replace both the {listing_uuid} and {publication_uuid} with the correct values.
  • Query Parameter: Add requestedState with a value of either PUBLISHED or PAUSED.
  • Body: You must provide an empty JSON body: {}.
  • The API will return 204 No Content and initiate the asynchronous republish process.

3. Check Publication Status (Optional)

Section titled “3. Check Publication Status (Optional)”

To verify the progress and current data of your listing:

  • Get Listing Information: Send a GET request to /listing/{listing_uuid} to retrieve the listing data.
  • Get Specific Publication Information: Send a GET request to /listing/{listing_uuid}/publication/{publication_uuid} to see detailed status information.