Skip to main content

Inserat-Details

Mit diesem Endpunkt können Sie detaillierte Informationen zu einem spezifischen Inserat anhand seiner ID abrufen.

Endpunkt

GET https://api.kleinanzeigen-agent.de/ads/v1/kleinanzeigen/inserat

Parameter

ParameterTypBeschreibungErforderlich
idstringDie ID des InseratsJa
livebooleanWenn auf true gesetzt, werden die Daten in Echtzeit abgerufen und die Datenbank wird umgangen. (Optional)Nein
viewsbooleanWenn auf true gesetzt, werden die Aufrufe (Views) des Inserats zurückgegeben. (Optional)Nein

Live-Datenabfrage

Der Endpunkt zum Abrufen einer einzelnen Anzeige wurde aktualisiert, um das Abrufen von Daten in Echtzeit zu unterstützen.

1. Live-Daten anfordern

Ein neuer Abfrageparameter wurde eingeführt, um die Datenbank zu umgehen und die neuesten Anzeigendaten direkt von der Quelle abzurufen. Neuer Abfrageparameter:
  • live (optional, boolean): Wenn auf true gesetzt, überspringt die API die Datenbankprüfung und fordert die Anzeigendaten in Echtzeit an. Dies stellt sicher, dass Sie die aktuellsten verfügbaren Informationen erhalten.
Beispiel: GET /ads/v1/kleinanzeigen/inserat?id=3192702825&live=true

2. Datenquelle in der Antwort

Die JSON-Antwort enthält jetzt ein source-Feld, um Klarheit darüber zu schaffen, wie die Daten abgerufen wurden. Neues Feld in der Antwort:
  • "source": Gibt den Ursprung der Anzeigendaten an.
    • "database": Die Daten wurden aus unserer Datenbank abgerufen.
    • "live": Die Daten wurden in Echtzeit abgerufen, wie durch den live=true-Parameter angefordert.
    • "database-fallback": Die Anzeige wurde nicht in unserer Datenbank gefunden, und die Daten wurden als Fallback in Echtzeit abgerufen.

Abrufen der Aufrufe (Views)

Der Endpunkt wurde erweitert, um eine gezielte Steuerung der Rückgabe von Anzeigenaufrufen zu ermöglichen.

1. Standardverhalten (ohne Views)

Standardmäßig, wenn der views-Parameter nicht gesetzt oder auf false gesetzt ist, wird das views-Feld in der API-Antwort nicht mehr enthalten sein. Dies dient der Performance-Optimierung.

2. Aufrufe anfordern

Um die Anzahl der Aufrufe eines Inserats zu erhalten, muss der optionale Query-Parameter views auf true gesetzt werden. Neuer Abfrageparameter:
  • views (optional, boolean): Wenn auf true gesetzt, wird die Anzahl der Aufrufe des Inserats zurückgegeben.
Beispiel: GET /ads/v1/kleinanzeigen/inserat?id=3192702825&views=true

3. Live-Aufrufe anfordern

Um die aktuelle Anzahl der Aufrufe direkt von der Quelle abzurufen, müssen beide Parameter live und views auf true gesetzt sein. Beispiel: GET /ads/v1/kleinanzeigen/inserat?id=3192702825&live=true&views=true

Beispielanfrage

const apiKey = "IHR_API_SCHLÜSSEL";
const inseratId = "3032719671";
const url = new URL("https://api.kleinanzeigen-agent.de/ads/v1/kleinanzeigen/inserat");

url.searchParams.append("id", inseratId);

const response = await fetch(url, {
  headers: {
    "ads_key": apiKey,
    "Content-Type": "application/json"
  }
});

const data = await response.json();
console.log(data);

Beispielantwort

{
  "message": "Data fetched successfully",
  "success": true,
  "source": "database",
  "data": {
    "id": "3032719671",
    "title": "TOP MacBook Pro 14\" M3 Pro, 12C/18C, 36GB, 1TB SSD & Touch ID",
    "description": "Wir verkaufen ein erst wenige Monate altes MacBook Pro 14\" in Silber und in entsprechend super Zustand mit top Ausstattung inklusive dem brandneuen M3 Pro Chip für unseren Verein. Der Originalpreis lag im Oktober bei 3.459€. Die Garantie läuft noch bis Oktober 2025.\n\nDas Gerät verfügt über:\n\n- Prozessor und Grafik: M3 Pro mit 12‑Core CPU und 18‑Core GPU für beeindruckende Performance bei allen Aufgaben.\n- Arbeitsspeicher: 36GB Unified Memory, ideal für Multitasking und anspruchsvolle Anwendungen.\n- Speicher: 1TB SSD, die schnellen Zugriff und viel Platz für Daten garantiert.\n- Anschlüsse: Drei Thunderbolt 4 Ports, HDMI, SDXC Slot und MagSafe 3 – optimal für moderne Peripheriegeräte.\n- Display: Optionales Liquid Retina XDR Display, das für brillante Farben und gestochen scharfe Bilder sorgt.\n- Weitere Features: Eingebautes Touch ID für sichere Anmeldung und schnellen Zugriff.\n\nEs ist also perfekt für Menschen, die Leistung, Mobilität und modernste Technik schätzen, viel Software nutzen oder zum Beispiel Bild- & Tonbearbeitung machen.\n\nIm Lieferumfang sind sowohl der original 96W USB-C Power Adapter als auch die Originalverpackung enthalten. Die Originalrechnung liegt vor und kann auf Wunsch gern eingesehen werden.\n\nDas MacBook wurde stets umsichtig behandelt und in einer Hülle transportiert. Dementsprechend ist der Zustand ist bis auf kleinste Gebrauchsspuren (siehe Bilder) einwandfrei, es gibt also keinerlei funktionale Mängel. Alle Teile sind original, es wurde nie eine Reparatur durchgeführt. Der Bildschirm weist einen wenige Pixel großen Kratzer auf, der mit bloßem Auge nur bei Betrachtung von wenigen cm Abstand sichtbar wird (siehe Fotos mit Finger und dem orangenen Stift zum Größenvergleich), bei normalem Abstand aber nicht sichtbar ist.\n\nWir verkaufen den PC, da wir für unsere Vereinsarbeit kein Gerät mit so hochwertiger Ausstattung mehr brauchen.\n___\n\n\nEine Abholung in Berlin Gesundbrunnen wird bevorzugt. Eine Übergabe an einem anderen Ort in Berlin ist nach Absprache u.U. möglich. Ein versicherter Versand ist u.U. ebenfalls möglich und erfolgt nach Bezahlung auf eigene Kosten.\n\nDie Zahlung per Überweisung vorab oder als Barzahlung bei Übergabe wird bevorzugt. Sofern notwendig ist auch eine Zahlung per PayPal bei Übergabe bzw. vor Versand möglich. Eine Rücknahme ist nicht möglich.\n\nNatürlich wird der Mac vor der Übergabe auf den Werkszustand zurückgesetzt und in der Originalverpackung übergeben.\n\nBei Interesse oder Fragen stehe ich gerne zur Verfügung. Einfach anrufen unter 0151 19370345 oder per WhatsApp schreiben.",
    "upload_date": "2025-03-18T00:00:00.000Z",
    "price_amount": "2300",
    "price_currency": "€",
    "price_negotiable": false,
    "location_id": 7359,
    "seller_id": "147683311",
    "shipping": true,
    "scrape_time": "2025-03-18T19:00:00.000Z",
    "last_check": "2025-03-18T19:00:00.000Z",
    "check_status": "done",
    "deleted": false,
    "klaz_images": [
      {
        "id": 72831628,
        "inserate_id": "3032719671",
        "image_url": "https://img.kleinanzeigen.de/api/v1/prod-ads/images/61/61508c53-c9a2-45c4-b663-0c0863ee394b?rule=$_59.AUTO"
      },
      // Weitere Bilder...
    ],
    "klaz_locations": {
      "id": 7359,
      "zip": "13359",
      "state": "Mitte",
      "city": "Gesundbrunnen",
      "latitude": "52.5591664",
      "longitude": "13.3830433"
    },
    "klaz_sellers": {
      "id": "147683311",
      "name": "SIGE e.V. / I. Henschen",
      "type": "Gewerblicher Nutzer",
      "since": "2025-01-11T00:00:00.000Z",
      "cre_dat": "2025-03-18T19:00:00.000Z",
      "badges": [
        "TOP Zufriedenheit",
        "Freundlich",
        "Zuverlässig"
      ]
    },
    "categories": [
      {
        "id": 49,
        "name": "Elektronik"
      },
      {
        "id": 69,
        "name": "Kleinanzeigen Berlin"
      },
      {
        "id": 189,
        "name": "Notebooks"
      }
    ],
    "details": {
      "Zustand": "Sehr Gut"
    }
  },
  "request_id": "cddc9ab4-e109-4596-845a-8241c7b9e3ee"
}

Antwortfelder

Die API liefert die folgenden Felder zurück:

Hauptobjekt

FeldBeschreibung
messageStatusmeldung der Anfrage
successErfolgsindikator (true/false)
sourceGibt die Herkunft der Daten an (database, live, database-fallback)
dataEnthält die detaillierten Informationen zum Inserat
request_idEindeutige ID dieser Anfrage (nützlich für Support)

Data-Objekt (Inserat-Details)

FeldBeschreibung
idEindeutige ID des Inserats
titleTitel des Inserats
descriptionDetaillierte Beschreibung des Inserats
viewsAnzahl der Aufrufe. Wird nur zurückgegeben, wenn views=true gesetzt ist.
upload_dateDatum, an dem das Inserat erstellt wurde
price_amountPreis des Artikels als Zeichenkette
price_currencyWährungssymbol (z.B. ”€“)
price_negotiableGibt an, ob der Preis verhandelbar ist
location_idID des Standorts
seller_idID des Verkäufers
shippingGibt an, ob Versand möglich ist
scrape_timeZeitpunkt, zu dem das Inserat zuletzt gescrapt wurde
last_checkZeitpunkt der letzten Überprüfung
check_statusStatus der Überprüfung
deletedGibt an, ob das Inserat gelöscht wurde
klaz_imagesArray mit Bildern des Inserats
klaz_locationsInformationen zum Standort
klaz_sellersInformationen zum Verkäufer
categoriesKategorien, zu denen das Inserat gehört
detailsZusätzliche Detailinformationen zum Inserat

Bilder-Objekt

FeldBeschreibung
idID des Bildes
inserate_idID des zugehörigen Inserats
image_urlURL des Bildes

Standort-Objekt

FeldBeschreibung
idID des Standorts
zipPostleitzahl
stateBundesland/Region
cityStadt/Stadtteil
latitudeBreitengrad
longitudeLängengrad

Verkäufer-Objekt

FeldBeschreibung
idID des Verkäufers
nameName des Verkäufers
typeTyp des Verkäufers (z.B. “Gewerblicher Nutzer”)
sinceDatum, seit dem der Verkäufer registriert ist
cre_datErstellungsdatum des Verkäuferkontos
badgesAuszeichnungen des Verkäufers