Skip to main content

​
Kleinanzeigen-Agent API

Die Kleinanzeigen-Agent API ermöglicht Entwicklern den programmatischen Zugriff auf unsere umfangreiche Datenbank von Kleinanzeigen. Mit dieser API können Sie Inserate suchen, Details abrufen und in Ihre eigenen Anwendungen integrieren.

​
API-Schlüssel

Um die API nutzen zu können, benötigen Sie einen API-Schlüssel. Diesen können Sie unter https://kleinanzeigen-agent.de/account/developer erstellen. Dort finden Sie auch Statistiken und Logs zu Ihren API-Anfragen.

​
Authentifizierung

Jede Anfrage an die API muss mit Ihrem API-Schlüssel authentifiziert werden. Dieser wird im HTTP-Header ads_key übermittelt: 
const response = await fetch(url, {
  headers: {
    "ads_key": "IHR_API_SCHLÜSSEL",
    "Content-Type": "application/json"
  }
});

​
Rate Limits

Die API hat ein Standardlimit von 20 Anfragen pro Minute. Bei Bedarf kann dieses Limit erhöht werden - kontaktieren Sie uns dafür unter contact@kleinanzeigen-agent.de.

​
Endpunkte

Die API bietet folgende Hauptendpunkte:

​
Beispiel-Integration

Hier ein einfaches Beispiel zur Suche nach Anzeigen mit JavaScript: 
async function searchAds(query, limit = 10) {
  const apiKey = "IHR_API_SCHLÜSSEL";
  const url = new URL("https://api.kleinanzeigen-agent.de/ads/v1/kleinanzeigen/search");
  
  url.searchParams.append("query", query);
  url.searchParams.append("limit", limit);
  
  const response = await fetch(url, {
    headers: {
      "ads_key": apiKey,
      "Content-Type": "application/json"
    }
  });
  
  return await response.json();
}

// Beispiel-Aufruf
searchAds("macbook pro").then(result => {
  console.log(result);
});