Push listings into Seeki via API.

Get an API key

Access to the Agency Import API requires an active Seeki agency subscription. Each subscription comes with one API key scoped to your agency account.

Subscribe on the For Agents page to get started.

Authentication

Every request must include your API key as a Bearer token in the Authorization header.

Authorization: Bearer seeki_live_your_key_here

Keys starting with seeki_live_ are production keys. Staging keys start with seeki_test_. They are not interchangeable across environments.

Your first import

Send a POST request to /v1/listings with a JSON body containing a listings array. Each element represents one property.

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
      }
    ]
  }'

A successful batch returns HTTP 200 with accepted and rejected arrays:

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

Request shape

The top-level body is { listings: [...] }. Required fields per listing:

See the full schema with all optional fields in the interactive API reference.

Response shape & errors

The /v1/listings endpoint always returns HTTP 200 OK as long as the request itself is well-formed (valid JSON, correct auth header, within size limits). Individual listing failures are reported inside the rejected array — not as HTTP error codes.

Each rejected item includes external_id, error_code, and a human-readable message. Batch-level errors (bad auth, oversized payload) return a non-200 HTTP status with a top-level error_code.

Error codes

Batch-level codes return HTTP errors. Per-item codes appear in the rejected array of a 200 response.

Idempotency / re-imports

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.

Internally, each import item maps to a Cloudflare Workflow with the ID:

agency-{agency_id}-{external_id}

Listing expiration

Every imported listing has a TTL of 60 days from the most recent successful import. Once the TTL expires, the listing is automatically unpublished by a daily cron job.

To keep a listing live indefinitely, re-import it (even with identical data) before the 60-day window closes. Implementing a nightly re-sync of your active listings is the recommended pattern.

Status + retry

Use GET /v1/import-items/{import_item_id}/status to poll the processing state of a single item. The import_item_id is returned in the accepted array of the original POST response.

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"
}

If an item ends up in an INFRA_LOST or INFRA_QUEUE_REJECTED state, re-queue it without resubmitting the full batch:

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

Limits

• →Body size: 25 MB maximum per request.
• →Items per request: 5,000 maximum. Split larger batches.
• →No QPS limit is enforced today. Very large bursts may be rate-limited automatically; spread high-volume syncs over multiple requests.

Going live

There are two separate environments. API keys are environment-scoped — a production key will not work on staging, and vice versa.

All endpoints (/listings, /import-items/{id}/status, /import-items/{id}/retry) are identical across both environments.