Inserate per API in Seeki übertragen.

API-Schlüssel erhalten

Der Zugriff auf die Agency Import API erfordert ein aktives Seeki-Agentur-Abonnement. Jedes Abonnement enthält einen API-Schlüssel, der auf Ihr Agenturkonto beschränkt ist.

Abonnieren Sie auf der Seite Für Agenturen, um zu starten.

Authentifizierung

Jede Anfrage muss Ihren API-Schlüssel als Bearer-Token im Authorization-Header enthalten.

Authorization: Bearer seeki_live_your_key_here

Schlüssel, die mit seeki_live_ beginnen, sind Produktivschlüssel. Staging-Schlüssel beginnen mit seeki_test_. Sie sind zwischen den Umgebungen nicht austauschbar.

Ihr erster Import

Senden Sie eine POST-Anfrage an /v1/listings mit einem JSON-Body, der ein listings-Array enthält. Jedes Element entspricht einer Immobilie.

curl -X POST https://ingest.seeki.eu/v1/listings \
  -H "Authorization: Bearer seeki_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "listings": [
      {
        "external_id": "crm-listing-00123",
        "listing_type": "SELL",
        "real_estate_type": "APARTMENT",
        "price": 320000,
        "currency": "EUR",
        "address": {
          "street": "Wenceslas Square 1",
          "city": "Prague",
          "country_code": "CZ",
          "postal_code": "11000"
        },
        "name": "Sunny 2-bedroom apartment, Wenceslas Square",
        "floorage": 65
      }
    ]
  }'

Ein erfolgreicher Batch liefert HTTP 200 mit den Arrays accepted und rejected zurück:

{
  "accepted": [
    { "external_id": "crm-listing-00123", "import_item_id": "uuid-…" }
  ],
  "rejected": []
}

Anfrage-Struktur

Der Top-Level-Body lautet { listings: [...] }. Pflichtfelder pro Inserat:

Das vollständige Schema mit allen optionalen Feldern finden Sie in der interaktive API-Referenz.

Antwort-Struktur & Fehler

Der Endpunkt /v1/listings liefert immer HTTP 200 OK zurück, solange die Anfrage selbst korrekt ist (gültiges JSON, korrekter Auth-Header, innerhalb der Größenbeschränkungen). Fehler einzelner Inserate werden im Array rejected gemeldet — nicht als HTTP-Fehlercodes.

Jeder abgelehnte Eintrag enthält external_id, error_code und eine lesbare Nachricht. Batch-Level-Fehler (fehlerhafte Authentifizierung, zu großer Payload) liefern einen HTTP-Status ungleich 200 mit einem error_code auf oberster Ebene.

Fehlercodes

Batch-Level-Codes liefern HTTP-Fehler. Codes pro Eintrag erscheinen im Array rejected einer 200-Antwort.

Idempotenz / erneute Importe

Re-posting a listing with the same external_id updates the existing record — it does not create a duplicate. The listing’s TTL is refreshed on every successful import.

Intern wird jeder Import-Eintrag auf einen Cloudflare-Workflow mit folgender ID abgebildet:

agency-{agency_id}-{external_id}

Ablauf von Inseraten

Jedes importierte Inserat hat eine TTL von 60 Tagen ab dem letzten erfolgreichen Import. Nach Ablauf der TTL wird das Inserat von einem täglichen Cron-Job automatisch depubliziert.

Um ein Inserat dauerhaft online zu halten, importieren Sie es vor Ablauf des 60-Tage-Fensters erneut (auch mit identischen Daten). Eine nächtliche Re-Synchronisation Ihrer aktiven Inserate ist das empfohlene Vorgehen.

Status + Wiederholung

Verwenden Sie GET /v1/import-items/{import_item_id}/status, um den Verarbeitungsstatus eines einzelnen Eintrags abzufragen. Die import_item_id wird im Array accepted der ursprünglichen POST-Antwort zurückgegeben.

curl https://ingest.seeki.eu/v1/import-items/{import_item_id}/status \
  -H "Authorization: Bearer seeki_live_your_key_here"

{
  "import_item_id": "uuid-…",
  "external_id": "crm-listing-00123",
  "status": "completed",
  "listing_id": "uuid-listing"
}

Falls ein Eintrag im Status INFRA_LOST oder INFRA_QUEUE_REJECTED endet, stellen Sie ihn erneut in die Queue, ohne den gesamten Batch erneut zu senden:

curl -X POST https://ingest.seeki.eu/v1/import-items/{import_item_id}/retry \
  -H "Authorization: Bearer seeki_live_your_key_here"

Limits

• →Body-Größe: maximal 25 MB pro Anfrage.
• →Einträge pro Anfrage: maximal 5.000. Teilen Sie größere Batches auf.
• →Aktuell wird kein QPS-Limit erzwungen. Sehr große Bursts können automatisch gedrosselt werden; verteilen Sie hochvolumige Synchronisationen über mehrere Anfragen.

Live gehen

Es gibt zwei getrennte Umgebungen. API-Schlüssel sind umgebungsspezifisch — ein Produktivschlüssel funktioniert nicht in Staging und umgekehrt.

Alle Endpunkte (/listings, /import-items/{id}/status, /import-items/{id}/retry) sind in beiden Umgebungen identisch.