RAIA Portal Feed API (MoveHome.org implementation)

MoveHome's inbound syndication API for CRMs, agencies and partners pushing listings in, at https://movehome.org/api/raia/portal/v1 — an implementation of the RAIA Protocol Working Group's vendor-neutral RAIA Portal Feed API (OpenAPI 3.1.0, 13 operations, MIT). OAuth 2.0 client credentials at https://movehome.org/oauth/token (HS256 JWT, 1 hour, scopes feed.read / feed.write / products.write, credentials issued by the operator). Idempotent PUT/DELETE of listings by the client's own reference (NO_CHANGE on identical re-send), branch inventory reconciliation, 28-day performance reports, cursor-polled enquiries and Premium/Featured product activations; every error is application/problem+json with a trace_id; 60 req/min per credential per endpoint group with X-RateLimit-* and Retry-After. Verified live on 2026-09-19: GET /healthz 200 {"service":"raia-portal-feed-api","version":"0.1.0"}; unauthenticated calls 401 with WWW-Authenticate Bearer realm="raia-portal-feed". The saved OpenAPI is the standard's verbatim document (its servers[] and tokenUrl are implementer placeholders); the overlay binds them to MoveHome's live hosts.

Operations 13

GET /healthz Service health probe #
PUT /listings/{reference} Upsert a listing #
GET /listings/{reference} Retrieve a listing #
DELETE /listings/{reference} Remove a listing #
GET /branches/{branch_id}/listings List a branch's current listings #
GET /branches/{branch_id}/performance Branch performance / listing statistics #
GET /branches/{branch_id}/enquiries Poll new branch enquiries (leads) #
GET /products/premium-listings List Premium Listing activations #
POST /products/premium-listings Request a Premium Listing activation #
GET /products/premium-listings/{activation_id} Get a Premium Listing activation #
GET /products/featured-properties List Featured Property activations #
POST /products/featured-properties Request a Featured Property activation #
GET /products/featured-properties/{activation_id} Get a Featured Property activation #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/raia-portal-feed-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

movehome-org-raia-portal-feed-openapi.yaml Raw ↑
openapi: 3.1.0
info:
  title: RAIA Portal Feed API
  version: 0.1.0
  summary: Vendor-neutral HTTP contract for syndicating property listings, reconciling branch inventory, polling enquiries, and activating portal products.
  description: |
    The RAIA Portal Feed API gives implementers a single, vendor-neutral contract
    that covers the same jobs-to-be-done as historical UK portal feed
    integrations (Rightmove Real-Time Data Feed, Rightmove Commercial Listings,
    Zoopla Real-Time Listings, and Zoopla Products).

    Implementers expose this API in front of their CRM, MLS or listing
    aggregator. Buyer agents, portals, and partner systems consume it to:

    - Upload, update, retrieve and remove residential and commercial listings.
    - Reconcile a branch's live inventory against their own source of truth.
    - Pull branch performance metrics and enquiries (leads).
    - Request and inspect portal product activations such as Premium Listings
      and Featured Properties.

    The contract intentionally uses RAIA naming conventions
    (`snake_case` fields, `SCREAMING_SNAKE_CASE` enum values, `raia_id`
    identifiers) and shares the public listing projection with
    [`schemas/property.json`](../schemas/property.json).

    Specification is published under the MIT license. See the developer guide
    at [`docs/raia-portal-feed-api.md`](../docs/raia-portal-feed-api.md).
  contact:
    name: RAIA Protocol Working Group
    email: protocol@estateaigents.org
    url: https://estateaigents.org
  license:
    name: MIT
    identifier: MIT

servers:
  - url: https://feed.example.com/api/raia/portal/v1
    description: Production (implementer-hosted)
  - url: https://staging.feed.example.com/api/raia/portal/v1
    description: Staging / sandbox (implementer-hosted)
  - url: http://localhost:8787/api/raia/portal/v1
    description: Local development

tags:
  - name: Listings
    description: Upload, update, retrieve and remove residential or commercial listings.
  - name: Branches
    description: Per-branch reconciliation, performance reporting and enquiry retrieval.
  - name: Products
    description: Portal product activations such as Premium Listings and Featured Properties.
  - name: Operational
    description: Health and metadata.

security:


# --- truncated at 32 KB (49 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/movehome-org/refs/heads/main/openapi/movehome-org-raia-portal-feed-openapi.yaml