Bulk Listing Upload

Upakiaji wa Nyumba Nyingi

Upload up to 100 property listings in a single API call. Ideal for property management agencies, real estate platforms, and brokers managing large portfolios across Tanzania.

Batch Processing

Upload up to 100 listings per request with atomic validation

JSON Schema

Strict schema validation with clear error messages per listing

Async Processing

Large batches are processed asynchronously with webhook callbacks

Idempotent

Safe to retry — duplicate listings are detected and skipped

Request Example

http

POST /api/v1/listings/bulk
Content-Type: application/json
X-API-Key: mkz_live_YOUR_KEY

{
  "listings": [
    {
      "title": "Modern 3BR Apartment in Masaki",
      "description": "Spacious apartment with ocean views...",
      "property_type": "apartment",
      "price": 3500000,
      "currency": "TZS",
      "bedrooms": 3,
      "bathrooms": 2,
      "area_sqm": 140,
      "address": "Masaki, Dar es Salaam",
      "latitude": -6.7580,
      "longitude": 39.2780,
      "amenities": ["pool", "gym", "parking", "generator"],
      "images": [
        "https://cdn.example.com/masaki-1.jpg",
        "https://cdn.example.com/masaki-2.jpg"
      ]
    },
    {
      "title": "Cozy Studio near Mlimani City",
      "description": "Furnished studio apartment...",
      "property_type": "studio",
      "price": 650000,
      "bedrooms": 1,
      "bathrooms": 1,
      "amenities": ["wifi", "furnished"]
    }
  ],
  "test_mode": false
}

Response

json

{
  "summary": {
    "total": 2,
    "succeeded": 2,
    "failed": 0,
    "test_mode": false
  },
  "results": [
    {
      "index": 0,
      "success": true,
      "listing_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Modern 3BR Apartment in Masaki"
    },
    {
      "index": 1,
      "success": true,
      "listing_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "title": "Cozy Studio near Mlimani City"
    }
  ]
}

Required Fields

Field	Type	Description
title	string	Property listing title (max 200 chars)
description	string	Full property description
property_type	enum	apartment \| house \| studio \| room \| commercial \| land
price	number	Monthly rental price in specified currency

Rate Limits & Quotas

100 listings per request
60 requests per minute per API key
Images auto-validated (max 25 per listing)
Test mode available with mkz_test_ prefix keys

Get Your API Key