Skip to main content

Kategorien abrufen

Mit diesem Endpunkt können Sie eine Liste aller verfügbaren Kategorien abrufen, die für die Suche nach Inseraten verwendet werden können.

Endpunkt

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

Parameter

Dieser Endpunkt erfordert keine Parameter.

Beispielanfrage

const apiKey = "IHR_API_SCHLÜSSEL";
const url = "https://api.kleinanzeigen-agent.de/ads/v1/kleinanzeigen/categories";

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,
    "categories": [
        {
            "id": 48,
            "name": "Kleinanzeigen"
        },
        {
            "id": 49,
            "name": "Elektronik"
        },
        {
            "id": 189,
            "name": "Notebooks"
        },
        {
            "id": 110,
            "name": "Handy & Telefon"
        }
    ]
}

Antwortfelder

Die API liefert ein Array von Kategorie-Objekten zurück, die die folgenden Felder enthalten:

Kategorie-Objekt

FeldTypBeschreibung
idnumberDie eindeutige ID der Kategorie.
namestringDer Name der Kategorie.