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.'
imageNote: The `image` property was removed on 2026-08-26. It had been copied verbatim out of a bootstrap template and pointed
  at an icon belonging to groq, not to this company. That asset returns HTTP 200, so the record rendered another company's
  brand rather than a broken image, which is why it went unreported (roadmap#153). No correct icon has been sourced yet. Shipping
  the wrong company's mark is worse than shipping none; re-run the icon backfill once a real asset exists.
tags:
- Real-Estate
- United States
- Residential Real Estate
- Brokerage
- Franchise
- Property Listings
- PropTech
- Agent Platform
- CRM
- Partner APIs
- Marketplace
- Austin Texas
tags_raw:
- Real Estate
- United States
- Residential Real Estate
- Brokerage
- Franchise
- Property Listings
- PropTech
- Agent Platform
- CRM
- Partner APIs
- Marketplace
- Austin Texas
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: false
  label: Hosted service · you call their endpoint
  confidence: medium
  source:
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  - scopes
  - security
  - sandbox
  generated: '2026-09-02'
  method: derived
created: '2026-07-26'
modified: '2026-07-26'
specificationVersion: '0.23'
apis:
- 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
  - Scopes
  tags_raw:
  - 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
  - Subscription
  - Billing
  - Event
  tags_raw:
  - 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
- aid: keller-williams:keller-williams-search-api
  name: Keller Williams Search API
  description: The Search API from Keller Williams — 5 operation(s) for search.
  humanURL: https://developer.kw.com/docs/listingskww/1/overview
  baseURL: https://partners.api.kw.com/v2
  tags:
  - Search
  properties:
  - type: OpenAPI
    url: openapi/keller-williams-search-api-openapi.yml
  - 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: 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
    url: arazzo/keller-williams-publish-listing.yml
common:
- type: CapabilityMap
  url: capabilities/keller-williams-capability-edges.yml
  name: Keller Williams Business Capability Map
- type: Overlay
  url: overlays/keller-williams-listings-search-overlay.yaml
- type: X-MCPServerCandidate
  url: mcp/keller-williams-mcp.yml
  note: 'Renamed from MCPServer 2026-09-03 (roadmap#247): the manifest self-describes as status: candidate — a tool list derived
    from the published API contracts, not an existing server. The scorer already read the manifest and reported mcp_server
    correctly; the MCPServer type was crediting the artifact-type surfaces with a server that does not exist.'
- 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