Karibu Partner API

Authenticated, read-only access to Karibu market data and de-identified customer intelligence. Generate a key in your Partner portal.

Authentication

Send your key as a bearer token:

curl https://karibuhome.world/api/partner/listings?city=Nairobi \
  -H "Authorization: Bearer kapi_<keyId>_<secret>"

The full token is shown once at creation. Only a hash is stored — regenerate if lost. Trial tier: 10,000 requests/day.

Endpoints

• GET/api/partner/listingsscope: listings:read

  Market inventory (approved/live listings). Filters: city, neighborhood, saleOrRent, limit, offset.

• GET/api/partner/marketscope: market:read

  Catalogued source registry + inventory aggregates by property type.

• GET/api/partner/customersscope: customers:read

  De-identified customer aggregates (counts, segments, opt-ins). No PII.

• GET/api/partner/me

  Identify the calling key (tier, scopes, status).

Privacy

Customer endpoints return aggregate, de-identified data only — never names, emails, or phone numbers. Per-partner data agreements can widen scope under contract.