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
| Name | Description |
|---|---|
idrequiredType: integer · path | Listing id. |
Response
The data field is an object with these fields.
| Name | Description |
|---|---|
availablerequiredType: boolean | |
reasonrequiredType: string | null | Why no number is returned; null when |
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. |
Related endpoints
- Search listings
GET /listings - Count listings
GET /listings/count - Get listings by id
GET /listings/batch - Get a listing
GET /listings/{id} - Get a listing's price history
GET /listings/{id}/price-history