Get a listing's advertiser contact (GET /listings/{id}/contact) — Kite API
Skip to content
KitePlatform
Pricing
Browse endpoints
All endpoints

Reference data

  • List cities
  • List neighborhoods
  • List city directions
  • List enumerated values
  • Get this key's limits
  • What the API covers

Listings

  • Search listings
  • Count listings
  • Get listings by id
  • Get a listing
  • Get a listing's price history
  • Get a listing's advertiser contact

Market data

  • Market summary
  • Price distribution
  • Area distribution
  • New supply
  • Vacancy indicator
  • Prices by neighborhood
  • Commercial rent per m² by neighborhood
  • Plots for sale against their last registered sale
  • Registered sale price against the asking price
  • Places, population and landmarks around a point or in a neighborhood

Official data

  • Registered rents (REGA)
  • Kite Property Index

Analytics

  • Get comparable listings
  • Get a listing's market position
  • Get a listing's nearby asking-price band
  • Find below-market listings
  • Find below-market listings (old path)
  • Get gross rental yield
  • Get price trends
  • Compare neighborhoods
  • List advertisers by matching listings
  • Check the asking price for any home

Registered transactions

  • Search registered deals
  • Registered deal statistics
  • Land prices per m²

Off-plan projects

  • Search projects
  • Get a project
  • List a project's units
  • Get a project's unit availability over time
  • Search project units
  • List developers
  • Get a project's absorption by month
  • Project absorption by area, developer or type

Exports

  • Create an export
  • List exports
  • Get an export

Administration

  • Get your organization
  • List data keys
  • Create a data key
  • Revoke a key
  • List projects
  • Daily usage
  • List members and invitations
  • List audit events
  • List request logs
  • Create a webhook endpoint
  • List webhook endpoints
  • Update a webhook endpoint
  • Re-enable a webhook endpoint
  • Rotate a webhook signing secret
  • Delete a webhook endpoint
  • List deliveries
  • Replay a delivery

Interactive reference

All endpoints

Reference data

  • List cities
  • List neighborhoods
  • List city directions
  • List enumerated values
  • Get this key's limits
  • What the API covers

Listings

  • Search listings
  • Count listings
  • Get listings by id
  • Get a listing
  • Get a listing's price history
  • Get a listing's advertiser contact

Market data

  • Market summary
  • Price distribution
  • Area distribution
  • New supply
  • Vacancy indicator
  • Prices by neighborhood
  • Commercial rent per m² by neighborhood
  • Plots for sale against their last registered sale
  • Registered sale price against the asking price
  • Places, population and landmarks around a point or in a neighborhood

Official data

  • Registered rents (REGA)
  • Kite Property Index

Analytics

  • Get comparable listings
  • Get a listing's market position
  • Get a listing's nearby asking-price band
  • Find below-market listings
  • Find below-market listings (old path)
  • Get gross rental yield
  • Get price trends
  • Compare neighborhoods
  • List advertisers by matching listings
  • Check the asking price for any home

Registered transactions

  • Search registered deals
  • Registered deal statistics
  • Land prices per m²

Off-plan projects

  • Search projects
  • Get a project
  • List a project's units
  • Get a project's unit availability over time
  • Search project units
  • List developers
  • Get a project's absorption by month
  • Project absorption by area, developer or type

Exports

  • Create an export
  • List exports
  • Get an export

Administration

  • Get your organization
  • List data keys
  • Create a data key
  • Revoke a key
  • List projects
  • Daily usage
  • List members and invitations
  • List audit events
  • List request logs
  • Create a webhook endpoint
  • List webhook endpoints
  • Update a webhook endpoint
  • Re-enable a webhook endpoint
  • Rotate a webhook signing secret
  • Delete a webhook endpoint
  • List deliveries
  • Replay a delivery

Interactive reference

Listings

Get a listing's advertiser contact

GET/listings/{id}/contact

The advertiser's phone number for one active listing. Only to contact the advertiser about this listing. Not for marketing lists or resale.

A number is returned only when the ad carries a REGA licence (an advertising licence, which owners posting their own property also hold, or a FAL brokerage licence), Kite holds a number for it, and no takedown or removal request covers it. Otherwise available is false and reason says why; source_url still leads to the original ad. advertiser.contact_available on a listing tells you in advance.

Needs the listings:contact scope, which no plan includes: Kite enables it for an organization on request. Test keys and the dashboard playground can't call it. Each organization can receive 200 numbers per day across all its keys; the allowance resets at midnight Riyadh time (UTC+3), and past it the call returns 429 contact_daily_cap_exceeded with Retry-After. Answers without a number don't count toward it. Every lookup is logged with your organization, key and the listing. Responses are Cache-Control: private, no-store: don't cache or store the number beyond the conversation it was fetched for.

Authentication
Send a data key (dk_live_… or dk_test_…) as a Bearer token.
Scope
listings:contact
Cost
1 unit per call

Parameters

NameDescription
idrequiredType: integer · path

Listing id.

Response

The data field is an object with these fields.

NameDescription
availablerequiredType: boolean
reasonrequiredType: string | null

Why no number is returned; null when available is true. unlicensed: the ad carries no REGA licence (neither an advertising licence nor a FAL brokerage licence). removal_requested: the advertiser or owner asked for the listing to be removed. suppressed: a takedown covers this advertiser or listing. no_phone: the ad is licensed but Kite holds no number for it.

phonerequiredType: string | null

The advertiser's phone number, as posted.

whatsapprequiredType: string | null

WhatsApp number, when the source gives one apart from the phone.

source_urlrequiredType: string | null

A kite.sa link that forwards to the original ad, where the advertiser can be reached through the source. Null on the Sandbox plan, or when the source has no ad page.

Example request

cURL
curl "https://api.kite.sa/v1/listings/128647/contact" \  -H "Authorization: Bearer $KITE_API_KEY"
JavaScript (@kite-sa/sdk)
import { Kite } from "@kite-sa/sdk";const kite = new Kite(); // reads KITE_API_KEYconst result = await kite.listings.contact(128647);
Python (kite-sa)
from kite_sa import Kitekite = Kite()  # reads KITE_API_KEYresult = kite.listings.contact(128647)

Open in the interactive reference

Related endpoints

  • Search listingsGET /listings
  • Count listingsGET /listings/count
  • Get listings by idGET /listings/batch
  • Get a listingGET /listings/{id}
  • Get a listing's price historyGET /listings/{id}/price-history

Guides

  • Quickstart
  • What a listing is
  • Searching and filtering
  • Keeping a copy in sync
  • Limits and quotas
  • Pagination
  • Errors

Ready to make a request? The Sandbox plan is free. For volume or licensing, talk to us.

Get an API keyTalk to us
Kite API

Saudi real estate data for developers.

Product
  • Data coverage
  • Pricing
  • Investors and developers
  • Valuation checks
  • Proptech and apps
Developers
  • Quickstart
  • Guides
  • API reference
  • MCP server
  • JavaScript SDK (npm)
  • Python SDK (PyPI)
  • Changelog
  • Status
Company
  • kite.sa
  • Blog
  • Contact
  • Security
Legal
  • Terms
  • Sources and data rights
  • Privacy
  • DPA
  • Subprocessors
© Kite