List advertisers by matching listings (GET /advertisers) — 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

Analytics

List advertisers by matching listings

GET/advertisers

The advertisers behind the listings a search matches: one row per advertiser, with how many matching listings they hold, their price range and where they list. Takes every filter GET /listings takes, so "brokers with apartments above 40,000 SAR a year in north Riyadh" is one call instead of paging the listings and grouping them yourself.

Which listings count. The same active, deduplicated, quality-filtered listings GET /listings returns for these filters, and of those only the ones whose advertiser GET /listings would name: the ad carries a REGA licence (an advertising licence or a FAL brokerage licence) and no takedown or removal request covers it. Listings by unlicensed or unnamed advertisers are left out, so totals.listings is usually below GET /listings/count for the same filters.

Who is one advertiser. Listings are grouped by the office name the ad shows (the company, or the person's name when the ad names no company), ignoring case. Kite does not merge spellings, so an office that posts under an Arabic name on one source and an English name on another appears twice. fal_number is the FAL licence its matching listings most often carry; an office whose agents each hold their own licence has several, counted in fal_licences.

Above the median. Pass above_median_pct to count only listings priced more than that percentage above the median asking price of comparable listings: same city, listing type, neighborhood, property type and bedroom count, where at least 5 such listings exist. 0 means any amount above. A listing with no comparable group (no neighborhood, or too few like it) never matches. The median is taken over all quality-filtered listings of the city and listing type, not only those matching your other filters.

No phone numbers. Contact details are not part of this response. sample_listing_ids are an advertiser's highest-priced matching listings; pass one to GET /listings/{id}/contact (which needs the listings:contact scope) or to GET /listings/batch.

Prices are asking prices of active listings, in SAR; rents are yearly.

Authentication
Send a data key (dk_live_… or dk_test_…) as a Bearer token.
Scope
analytics
Cost
50 units per call

Parameters

NameDescription
cityrequiredType: string · query

City slug from GET /cities. A town inside a covered region is accepted and resolved to its city (dammam, khobar, dhahran, jubail and qatif to eastern_province; buraydah and unaizah to qassim; hofuf to al_ahsa), as are Arabic city names. The response's filters.city and the X-Resolved-City header show the slug used.

listing_typerequiredType: string · query

One of: rent, sale

listing_categoryType: string · query

Omit for both.

One of: residential, commercial

property_typeType: string[] · query

One or more, comma-separated.

One of: apartment, villa, floor, duplex, office, shop, warehouse, land, building

neighborhood_idType: integer[] · query

Neighborhood ids from GET /cities/{city}/neighborhoods.

bedsType: integer · query

Exact number of bedrooms. Exact at every value, including 5 — kite.sa's own filter treats 5 as five-or-more, so the same number returns different sets here. Use beds_min for a range.

beds_minType: integer · query

Minimum number of bedrooms.

beds_maxType: integer · query

Maximum number of bedrooms.

bathrooms_minType: integer · query

Minimum number of bathrooms.

price_minType: integer · query

SAR. Yearly for rentals (see price.yearly_sar).

price_maxType: integer · query

SAR. Yearly for rentals (see price.yearly_sar).

area_minType: number · query

Square meters.

area_maxType: number · query

Square meters.

furnishedType: string · query

true matches listings confirmed furnished. false matches listings not confirmed furnished: those stated unfurnished and those that don't say. Omit to include all.

One of: true, false

sourceType: string[] · query

Source platforms, see GET /enums. Values aren't checked against the list, so a misspelled source narrows to nothing rather than erroring.

bboxType: string · query

Bounding box west,south,east,north in degrees (GeoJSON order).

updated_sinceType: string (date-time) · query

Only listings whose updated_at is at or after this ISO 8601 time. Combine with sort=updated_asc to sync.

bathroomsType: integer · query

Exact number of bathrooms.

bathrooms_maxType: integer · query

Maximum number of bathrooms.

livings_minType: integer · query

Minimum number of living rooms.

neighborhood_id_excludeType: integer[] · query

Exclude these neighborhoods. Ids from GET /cities/{city}/neighborhoods. Listings Kite could not place in a neighborhood are kept — unlike neighborhood_id, which drops them.

qType: string · query

Free-text match on the advertiser's title and description, as posted — not on headline, which Kite builds for the response. Several words must all appear; "quote a phrase" to match it whole, and | between words for either. Sources that post no title (Aqar among them) are matched on description alone.

amenitiesType: string[] · query

Only listings that have all of these. See GET /enums.

One of: ac, kitchen, maid_room, parking, private_roof, lift, pool, gym, balcony, garden, laundry_room

amenities_excludeType: string[] · query

Exclude listings that have any of these.

One of: ac, kitchen, maid_room, parking, private_roof, lift, pool, gym, balcony, garden, laundry_room

photo_featuresType: string[] · query

Only listings whose photos show all of these: real_photos (photos of the actual property, not renders or stock images), kitchen_installed (fitted kitchen cabinets), ac_split, pool, roof_terrace, balcony, large_windows (a living room or bedroom with large windows). Read from the listing's photos by an automated vision model and published only for features it identifies with high precision, so this is a must-have filter and nothing else: a listing whose photos don't show a feature, or that hasn't been analysed yet, simply doesn't match, and there is no way to ask for listings without a feature. Coverage is homes with photos; recently added listings may not be analysed yet.

One of: real_photos, kitchen_installed, ac_split, pool, roof_terrace, balcony, large_windows

floorType: string · query

ground for ground-floor listings, upper for any stated floor above it. The two do not partition the results: a listing whose floor the source didn't state is in neither.

One of: ground, upper

source_excludeType: string[] · query

Exclude these source platforms, see GET /enums.

max_ageType: integer · query

Maximum property age in years. In Riyadh the age is checked against municipal building permits from 2018 on: when the ad claims a building at least four years younger than its latest permit allows, the permit's age (the permit year plus a year to build) is used instead. A permit never makes a building younger than its ad says. Aqar records an age of 0 when the advertiser leaves it blank, so an Aqar listing at 0 counts as new only when a Riyadh permit or the ad's own text (first occupant, never lived in, newly built) backs it; otherwise its age is unknown and it doesn't match. Where an ad's own description states the building's age ("العمر 8 سنوات") at least three years older than its age field, or the field is empty, the description's age is used.

verifiedType: string · query

true for listings the source marks as verified. false means everything else — both listings it marked unverified and listings it said nothing about.

One of: true, false

advertiser_typeType: string · query

Who posted the ad, where the source says. company groups agencies, brokerage companies and developers; individual groups individual brokers and owners. Many listings match neither: their source states no category (Aqar, the largest source, states none), or names an intermediary without saying whether it is a firm or a person. So the two values together are well short of all listings; don't use this filter to size a market.

One of: company, individual

compoundType: string · query

Compound name, partial match.

in_compoundType: string · query

Only listings that belong to a compound, whichever one.

One of: true, false

rent_frequencyType: string · query

How the rent is advertised. price.yearly_sar stays yearly either way; see price.as_posted.

One of: monthly, yearly

days_on_market_minType: integer · query

Days since Kite first saw the listing.

days_on_market_maxType: integer · query

Days since Kite first saw the listing.

zoningType: string[] · query

Only listings whose plot is zoned any of these (plot.zoning), comma-separated. Like every plot filter, it matches only listings with a plot.

One of: residential, commercial, mixed, industrial, agricultural, public, other

cornerType: string · query

true: corner plots only (plot.is_corner); false: plots not on a corner.

One of: true, false

street_width_minType: number · query

Minimum width in metres of the widest street the plot fronts (plot.street_width_m).

white_land_feeType: string · query

true: plots in a white-land fee band (plot.white_land_fee); false: plots outside every band. Bands are mapped for Riyadh only, so false matches nothing in other cities.

One of: true, false

last_sale_within_monthsType: integer · query

Only listings whose parcel's last registered sale (plot.last_registered_sale) is at most this many calendar months old (months_since). Land, villas and buildings only: flats, floors and duplexes have no last sale.

ask_to_last_sale_maxType: number · query

Sale listings only: the asking price is at most this multiple of the parcel's last registered sale, among listings whose area agrees with the deed (plot.last_registered_sale.ask_to_last_sale_ratio). 1.05 finds plots offered for at most 5% above what they last sold for.

plot_soldType: string · query

true: only listings whose plot registered a sale while the ad was up (plot.registered_sale_while_listed), which on the market means plots most likely sold already. false: leaves those out, and keeps every listing with no such sale on record, including those without a plot. Land, villas and buildings for sale.

One of: true, false

above_median_pctType: number · query

Count only listings priced more than this percentage above the median of comparable listings (same neighborhood, property type and bedrooms, at least 5 listings). 0 = any amount above.

min_listingsType: integer · query

Only advertisers with at least this many matching listings.

sortType: string · query

listings_desc (most matching listings first) or median_price_desc (highest median asking price first).

One of: listings_desc, median_price_desc

limitType: integer · query
cursorType: string · query

Response

The data field is an object with these fields.

NameDescription
price_basisrequiredType: string

What the *_sar price fields mean: yearly_rent (SAR per year) for rentals, sale_price (total SAR) for sales.

One of: yearly_rent, sale_price

price_sourcerequiredType: string

Where the prices come from: asking = advertised asking prices from listings; registered = registered transactions or rent contracts. Asking prices typically sit above what is finally agreed.

One of: asking, registered

totalsrequiredType: object

Across every page: advertisers with at least min_listings matching listings, and the listings they hold.

advertisersrequiredType: object[]

Example request

cURL
curl "https://api.kite.sa/v1/advertisers?city=riyadh&listing_type=rent" \  -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.analytics.advertisers({ city: "riyadh", listing_type: "rent" });
Python (kite-sa)
from kite_sa import Kitekite = Kite()  # reads KITE_API_KEYresult = kite.analytics.advertisers(city="riyadh", listing_type="rent")

Open in the interactive reference

Related endpoints

  • Get comparable listingsGET /listings/{id}/comparables
  • Get a listing's market positionGET /listings/{id}/market-position
  • Get a listing's nearby asking-price bandGET /listings/{id}/price-band
  • Find below-market listingsGET /market/below-market
  • Find below-market listings (old path)GET /market/deals
  • Get gross rental yieldGET /market/rental-yield
  • Get price trendsGET /market/trends
  • Compare neighborhoodsGET /market/neighborhoods/compare
  • Check the asking price for any homeGET /valuations/asking-range

Guides

  • Quickstart
  • What a listing is
  • Coverage and freshness
  • Limits and quotas
  • 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