Keller Williams

aid: keller-williams
name: Keller Williams
kind: company
url: https://raw.githubusercontent.com/api-evangelist/keller-williams/refs/heads/main/apis.yml
description: 'Keller Williams Realty, Inc. (KWRI) is an Austin, Texas headquartered residential real estate franchisor and
  the largest real estate brokerage franchise in the United States by agent count, operating more than 1,000 market centers
  worldwide through independently owned and operated offices. In the value chain Keller Williams sits at the brokerage and
  agent-platform layer, not the data-cooperative layer: it franchises brokerages, and it builds and operates KW Command, a
  proprietary agent operating system for lead, contact, task, listing, opportunity and marketing management, plus the KW Marketplace
  where third-party vendors sell integrated products to KW agents. Its API posture is real but partner-gated. Keller Williams
  runs a genuine Apigee-backed developer portal (DevHub) at developer.kw.com with a live gateway at partners.api.kw.com and
  a sandbox at sandbox.partners.api.kw.com, an OpenID Connect authorization server whose discovery document is publicly readable,
  and a published API License Agreement. Access is not self-serve: a developer must submit a partnership application through
  the "Apply to Integrate" form, be approved by KWRI, receive a DevHub account, then sign the KW API License Agreement and
  Terms of Use before receiving an API key and secret. Only one API — KW Worldwide Listings Search — is visible anonymously
  in the API catalog; the rest of the catalog (Command MC, Contact and Lead Data, Tasks, Opportunity/Deal/ Transaction Data,
  User/Organization/Role Information, Marketplace Subscription Management, Internal) is behind a SAML member login. On the
  sector''s central question, Keller Williams carries no RESO posture at all: it is absent from the RESO certification directory,
  no RESO Web API, Data Dictionary, OData $metadata or Universal Property Identifier reference appears anywhere in its developer
  portal or specification, and its own listings spec states in its description that the service "is not a substitution for
  or tied to any Multiple Listings Services database records." This is a brokerage''s own listing and CRM data behind a commercial
  partner agreement, not licensed MLS data behind a certified standard.'
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/groq.png
tags:
- Real Estate
- United States
- Residential Real Estate
- Brokerage
- Franchise
- Property Listings
- PropTech
- Agent Platform
- CRM
- Partner APIs
- Marketplace
- Austin Texas
created: '2026-07-26'
modified: '2026-07-26'
specificationVersion: '0.19'
apis:
- aid: keller-williams:keller-williams-worldwide-listings-search-api
  name: KW Worldwide Listings Search API
  description: The only Keller Williams API whose specification is published anonymously in the DevHub API catalog. The KW
    Worldwide Listings service returns Keller Williams Listing Service (KWLS) listings scoped to a KW Worldwide region, and
    supports listing create, update and delete plus a lookup table of controlled vocabularies (property types, statuses, flooring,
    roof type, appliances, currency, country, state/province and more) and an organization-people lookup. The published OpenAPI
    3.0.1 document declares 5 paths and 8 operations against a production and a sandbox server. The spec's own description
    states the service is not a substitution for, or tied to, any Multiple Listing Service database records. Access requires
    an approved DevHub application; requests carry an API key plus a Basic or Bearer credential.
  humanURL: https://developer.kw.com/docs/listingskww/1/overview
  baseURL: https://partners.api.kw.com/v2
  tags:
  - Property Listings
  - Search
  - KW Worldwide
  - KWLS
  properties:
  - type: OpenAPI
    url: openapi/keller-williams-listings-search-openapi.json
  - type: Documentation
    url: https://developer.kw.com/docs/listingskww/1/overview
  - type: APIReference
    url: https://developer.kw.com/docs/listingskww/1/routes/listings/get
  - type: Documentation
    url: https://developer.kw.com/filtering-and-sorting
  - type: Sandbox
    url: https://sandbox.partners.api.kw.com/v2
  - type: Sandbox
    url: sandbox/keller-williams-sandbox.yml
  - type: Overlay
    url: overlays/keller-williams-listings-search-overlay.yaml
  - type: Examples
    url: examples/keller-williams-listings-search-examples.json
  - type: ErrorCatalog
    url: errors/keller-williams-problem-types.yml
  - type: DataModel
    url: data-model/keller-williams-data-model.yml
  - type: Arazzo
    name: Publish a KW Worldwide listing
    url: arazzo/keller-williams-publish-listing.yml
- aid: keller-williams:keller-williams-partner-identity-api
  name: KW Partner Identity API (OpenID Connect)
  description: Keller Williams uses OpenID Connect on top of OAuth 2.0 to grant a partner application access to an individual
    KW user's Command data. The authorization server at partners.api.kw.com/idp serves a publicly readable OpenID Connect
    discovery document advertising authorize, token, introspect, userinfo, revoke, end_session and device_authorization endpoints,
    RS256 ID tokens, PKCE S256, and 40 supported scopes covering contacts, tasks, listings, organizations, users, opportunities,
    recruiting and marketing profiles. The DevHub Getting Started guide documents the authorization-code flow, the consent
    screen, token exchange with base64 client_secret_basic credentials, and logout via the revoke endpoint. A separate partner
    token-refresh endpoint is documented under /v2/oauth2/partner/token.
  humanURL: https://developer.kw.com/getting-started
  baseURL: https://partners.api.kw.com/idp
  tags:
  - Authentication
  - OpenID Connect
  - OAuth 2.0
  - Scopes
  properties:
  - type: OpenIDConnectDiscovery
    url: authentication/keller-williams-openid-configuration.json
  - type: Documentation
    url: https://developer.kw.com/getting-started
  - type: Documentation
    url: https://developer.kw.com/docs-authentication
  - type: Documentation
    url: https://developer.kw.com/docs-refresh-token
  - type: Authentication
    url: authentication/keller-williams-authentication.yml
  - type: OAuthScopes
    url: scopes/keller-williams-scopes.yml
  - type: WellKnown
    url: well-known/keller-williams-well-known.yml
- aid: keller-williams:keller-williams-marketplace-subscription-api
  name: KW Marketplace Subscription & Metered Billing API
  description: The partner-facing surface behind the KW Marketplace, where vendors sell products to Keller Williams agents.
    Keller Williams pushes subscription lifecycle events — subscription creation, subscription creation for teams, subscription
    change, subscription cancel, status notification, user assignment and user unassignment — to a partner's secured HTTPS
    endpoint registered with the KW team, and partners report consumption back through a pre-configured metered billing endpoint
    that accepts a quantity and unit type per account. Sample payloads, synchronous and asynchronous subscription flows, an
    error-code reference and a subscription lifecycle walkthrough are published publicly on DevHub; no OpenAPI document is
    offered for this surface.
  humanURL: https://developer.kw.com/marketplace-documentation
  baseURL: https://partners.api.kw.com/v1
  tags:
  - Marketplace
  - Subscriptions
  - Billing
  - Events
  properties:
  - type: Documentation
    url: https://developer.kw.com/marketplace-documentation
  - type: Documentation
    url: https://developer.kw.com/metered-billing
  - type: Documentation
    url: https://developer.kw.com/subscription-lifecycle-walkthrough
  - type: Documentation
    url: https://developer.kw.com/docs-synchronous-subscription
  - type: Documentation
    url: https://developer.kw.com/docs-asynchronous-subscription
  - type: Documentation
    url: https://developer.kw.com/docs-error-codes-reference
  - type: Webhooks
    url: asyncapi/keller-williams-marketplace-webhooks.yml
  - type: ErrorCatalog
    url: errors/keller-williams-error-codes.yml
  - type: AgentSkill
    url: skills/keller-williams-handle-marketplace-subscriptions.md
common:
- type: AgenticAccess
  url: agentic-access/keller-williams-agentic-access.yml
- type: DomainSecurity
  url: security/keller-williams-domain-security.yml
- type: Authentication
  url: authentication/keller-williams-authentication.yml
- type: OAuthScopes
  url: scopes/keller-williams-scopes.yml
- type: Conventions
  url: conventions/keller-williams-conventions.yml
- type: ErrorCatalog
  url: errors/keller-williams-error-codes.yml
- type: Lifecycle
  url: lifecycle/keller-williams-lifecycle.yml
- type: StatusPage
  url: https://status.kw.com/
- type: Deprecation
  url: https://developer.kw.com/base-path-migration-guide
- type: Conformance
  url: conformance/keller-williams-conformance.yml
- type: DataModel
  url: data-model/keller-williams-data-model.yml
- type: Packages
  url: packages/keller-williams-packages.yml
- type: WellKnown
  url: well-known/keller-williams-well-known.yml
- type: Webhooks
  url: asyncapi/keller-williams-marketplace-webhooks.yml
- type: AgentSkill
  url: skills/_index.yml
- type: Arazzo
  name: Publish a KW Worldwide listing
  url: arazzo/keller-williams-publish-listing.yml
- type: LLMsTxt
  url: llms/keller-williams-llms.txt
- type: Website
  url: https://www.kw.com/
- type: DeveloperPortal
  url: https://developer.kw.com/
- type: Documentation
  url: https://developer.kw.com/getting-started
- type: GettingStarted
  url: https://developer.kw.com/getting-started
- type: APIReference
  url: https://developer.kw.com/docs/listingskww/1/overview
- type: APICatalog
  url: https://developer.kw.com/apis
- type: SignUp
  url: https://share.hsforms.com/2JQHe7zfKRLSo_cXKjy-5nwbg45/
- type: TermsOfService
  url: https://developer.kw.com/terms-and-conditions
- type: PrivacyPolicy
  url: https://legal.kw.com/privacy-policy
- type: License
  url: https://developer.kw.com/api-license-agreement
- type: Support
  url: https://developer.kw.com/support
- type: Marketplace
  url: https://marketplace.kw.com/
- type: News
  url: https://kwri.kw.com/
- type: Blog
  url: https://outfront.kw.com/
- type: BlogRSS
  url: https://outfront.kw.com/feed/
- type: GitHubOrganization
  url: https://github.com/KWRI
- type: LinkedIn
  url: https://www.linkedin.com/company/keller-williams-realty
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com