Bright MLS

Bright MLS Listing API

The Listing API from Bright MLS — 2 operation(s) for listing.

GitHub OpenAPI

Operations 2

GET /datahub/listing/delta/{date} Distribution Service GET API to fetch presigned url for delta package #
GET /datahub/listing/historical/{date} Distribution Service GET API to fetch presigned url for historical package #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/bright-mls/openapi/bright-mls-listing-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/bright-mls/json-schema/bright-mls-manifest-schema.json
📊
JSONSchema
https://artifacts.apis.io/bright-mls/json-schema/bright-mls-uuid-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/bright-mls/json-schema/bright-mls-user-api-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/bright-mls/json-schema/bright-mls-user-api-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/bright-mls/json-schema/bright-mls-auth-token-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/bright-mls/json-schema/bright-mls-get-package-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/bright-mls/json-schema/bright-mls-auth-token-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/bright-mls/json-schema/bright-mls-ingestion-api-body-schema.json

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/bright-mls:bright-mls-listing-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

bright-mls-listing-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: '1.0'
  title: DataLake Distribution Service Listing API
  description: DataLake Distribution Service API
servers:
- description: SwaggerHub API
  url: https://4qpk2x8mkb.execute-api.us-east-1.amazonaws.com/t1
tags:
- name: Listing
paths:
  /datahub/listing/delta/{date}:
    get:
      summary: Distribution Service GET API to fetch presigned url for delta package
      description: 'By using this GET API endpoint an authorized consumer can request to recieve the delta package for a specific date.

        The package may include all newly received listing type data that were received on the same date [as provided in place of date parameter] after 4 AM GMT / UTC.

        As the package is quite large in size therefor we provide a presigned URL starting with https://aue1t1z1s3bdatahubdistributionservices-distribution.s3.amazonaws.com and the presigned url would expire in next 10 minutes'
      tags:
      - Listing
      parameters:
      - name: date
        in: path
        description: The date of delta package generation
        required: true
        example: yyyymmdd
        schema:
          type: string
      responses:
        '200':
          description: 200 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPackageResponse'
        '400':
          description: 400 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: 403 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Forbidden'
        '404':
          description: 404 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: 500 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: getDatahubListingDeltaByDate
      x-operation-id-source: derived
  /datahub/listing/historical/{date}:
    get:
      summary: Distribution Service GET API to fetch presigned url for historical package
      description: 'By using this GET API endpoint an authorized consumer can request to recieve all available listing data from the original date the data is ingested to the date the consumer is onboarded package for a specific date.

        As the package is quite large in size therefor we provide a presigned URL starting with https://aue1t1z1s3bdatahubdistributionservices-distribution.s3.amazonaws.com and the presigned url would expire in next 10 minutes'
      tags:
      - Listing
      parameters:
      - name: date
        in: path
        description: The date of delta package generation
        required: true
        example: yyyymmdd
        schema:
          type: string
      responses:
        '200':
          description: 200 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPackageResponse'
        '400':
          description: 400 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: 403 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Forbidden'
        '404':
          description: 404 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: 500 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: getDatahubListingHistoricalByDate
      x-operation-id-source: derived
components:
  schemas:
    ApiInfo:
      type: object
      properties:
        version:
          type: string
          example: '1.0'
        timestamp:
          type: number
          description: 'UTC timestamp in miliseconds when the response was generated from the server

            '
          example: 1659599754000
        provider:
          type: string
          example: BrightMLS
    Error:
      type: object
      properties:
        apiInfo:
          $ref: '#/components/schemas/ApiInfo'
        message:
          type: string
          example: Error message
      title: Error Response
    GetPackageResponse:
      type: object
      required:
      - apiInfo
      - description
      - message
      - url
      properties:
        apiInfo:
          $ref: '#/components/schemas/ApiInfo'
        description:
          type: string
        message:
          type: string
        url:
          type: string
          description: 'Presigned url of the data package

            '
    Forbidden:
      type: object
      properties:
        message:
          type: string
          default: Forbidden
  securitySchemes:
    Authorization:
      type: apiKey
      name: Authorization
      in: header