Your website. Our IDX infrastructure.

Build your own real estate website.
We’ll handle the IDX connection.

Building with Claude, ChatGPT, or a developer? Connect approved MLS listings to your custom website with the Agent Winds IDX API, a ready-to-share OpenAPI specification, and a real engineer on your side.

$129/month + $200 one-time setup

One website ¡ One MLS ¡ MLS fees covered ¡ Integration support included

FROM YOUR IDEA TO PROPERTY SEARCH

“Help me build a real estate website with MLS listings.”

01
Your website + coding assistant

You shape the design and experience.

02
Your secure backend

Your private API key stays server-side.

03
Agent Winds IDX API

We manage the approved MLS connection.

OpenAPI documentedEngineer supported

A concrete starting point for your AI

Give your coding assistant a specification.
Not a guessing game.

Our OpenAPI document describes the endpoints, parameters, authentication, and response formats. Share it with your developer or AI coding assistant so they can plan the integration around the actual API contract.

AGENT WINDS / CUSTOMER IDX APIOpenAPI 3.0.3 ¡ Preview based on v1.1.0

SERVER-TO-SERVER REQUEST

GET https://tophamtechbe.com/api/treas/idx/v1/retrieve-property-summary/page?state=OK&pageSize=24
X-API-Key: <your server-side secret>

Load listing cards in pages, then use next_cursor with the same filters to continue. The state filter narrows the search; it does not grant MLS access.

ILLUSTRATIVE RESPONSE ¡ NOT A LIVE LISTING

{
  "total_count": 1,
  "properties": [
    {
      "id": 12345,
      "listing_key": "EXAMPLE-LISTING",
      "current_price": 325000,
      "city": "Example City",
      "state": "OK",
      "bedrooms_total": 3,
      "bathrooms_full": 2,
      "first_photo_url": null
    }
  ],
  "pagination": {
    "version": "bounded-search-v1",
    "page_size": 24,
    "returned": 1,
    "has_more": false,
    "next_cursor": null
  }
}
Download OpenAPI JSON

Open full specification ↗ No signup required to read the docs. Credentials and activation are provided separately.

Read the AI build prompt before copying
I am building a real estate website using the Agent Winds IDX API.

Read this OpenAPI specification: https://aw-business-marketing.s3.us-east-1.amazonaws.com/agent-winds-idx.openapi.json

Inspect my existing project before making changes. Plan property search, listing details, and photo integration using only documented endpoints and fields. If you cannot read the specification, ask me to attach it rather than guessing.

Keep the private X-API-Key in backend or serverless secrets, never in browser code, URLs, logs, or chat prompts. Use server-to-server requests without an Origin header. Do not ask me to paste the key into this conversation.

Use the paginated search endpoint for navigation. Handle empty results, nullable fields, expired cursors, and documented error and rate-limit responses. Do not assume every MLS supplies every field.

Identify missing requirements and leave clearly marked placeholders for the MLS attribution and display rules Agent Winds supplies during onboarding. Do not treat placeholder compliance text as launch-ready. Confirm account activation and MLS approval before testing with real data. Show me your integration plan before implementing it.
Explore all six documented API paths
  • Filtered listing summariesGET /retrieve-property-summary

    Up to 100 rows. Prefer paginated search for browsing.

  • Paginated property searchGET /retrieve-property-summary/page

    Opaque cursors; keep filters unchanged between pages.

  • Map-based search dataGET /retrieve-property-summary/map

    Bounded map results for a custom map interface.

  • Property details by numeric IDGET /retrieve-property-data/{id}

    Detailed information for an approved listing.

  • Property details by listing keyGET /retrieve-property-data

    Supply the listingKey query parameter.

  • Listing photo metadataGET /retrieve-property-media/{listingKey}

    Photo data for an approved listing.

Share the spec, not your secret. Your API key belongs in backend or serverless secrets—not frontend JavaScript, public repositories, or AI chat prompts.

Designed around the screens you’re building

One connection. Room for your own experience.

01

Search that fits your market

Use supported location, price, bedroom, bathroom, and property filters to help buyers narrow their search.

02

Details beyond a listing card

Build property pages from structured listing, location, feature, school, and land fields where supplied by the MLS.

03

Photos and map exploration

Use photo metadata and bounded geographic results to create galleries and your own map interface.

04

Purposeful data requests

Paginate results and retrieve details or photos when needed instead of loading every field for every screen.

05

Access scoped to your account

Your private credential is restricted to approved MLS sources. Adding a state filter does not expand those permissions.

06

Help through the integration

Work with the engineer on setup, endpoint usage, and troubleshooting—with ongoing support after connection.

Available fields vary by feed. API response time, listing refresh frequency, and MLS approval time are separate considerations; we review them for your integration rather than promise an unmeasured speed.

Craig Topham, founder and engineer behind Agent Winds

Direct access to the engineer

Your AI can write code.
You can still talk to Craig.

You don’t need to become an MLS integration expert to build your own website. Work directly with Craig Topham for help understanding the API, connecting your approved feed, and troubleshooting integration issues.

Craig’s background includes digital mortgage origination, product ownership for Bank of America’s Erica AI platform, and a master’s degree in computer science from Vanderbilt.

Personal engineering support is part of the service. Integration assistance and ongoing API support are included; full website development is a separate service.

Meet the person behind Agent Winds →

From your idea to an approved connection

We walk you through the IDX setup.

  1. Tell us what you’re building

    Bring your website plans, platform, and MLS name. We review what your integration needs.

  2. Navigate the access process

    We help you work through the MLS and brokerage approvals required for your intended website.

  3. Get your configured API

    We set up the approved feed in our middleware, manage the infrastructure, and provide scoped credentials and the OpenAPI spec.

  4. Integrate, test, and launch

    Your developer or AI coding assistant builds the connection. We help verify the integration and review the required attribution and display rules.

Access is subject to required approvals and feed readiness. We confirm the setup timeline with you; a key alone is not approval to launch.

Bring your own website

The IDX connection.
The engineer.
A clear starting price.

You control the website you build and host. Agent Winds handles the approved listing-data connection and helps you integrate it.

Want the entire website built for you instead? Explore our managed IDX websites.

Agent Winds IDX API

$129/month

+ $200 one-time setup

  • One website and one approved MLS source
  • MLS fees covered for the included source
  • Managed middleware and API infrastructure
  • Private, MLS-scoped API credential
  • OpenAPI documentation for your developer or AI
  • Integration assistance and ongoing support
Discuss My IDX Setup

Need two MLS feeds? We’ll discuss additional-source approval, scope, and pricing. Website hosting, CRM, and a finished interface are not included.

Practical answers for your build

Building an IDX website with AI?
Start with these questions.

Can I build my own real estate website with ChatGPT or Claude?

Yes, an AI coding assistant can help write your website and API integration. Agent Winds supplies the IDX connection, OpenAPI documentation, and integration assistance. You still need a backend or serverless function, approved MLS access, testing, and the required listing disclosures. The specification is an integration guide, not a one-prompt guarantee of a finished website.

How do I get MLS listings onto my custom website?

Start with your MLS and brokerage approval requirements. We walk you through requesting access, configure the approved feed in our middleware, and provide a private API credential scoped to your approved source. Your backend requests listings from Agent Winds and supplies the data your website displays.

What is the difference between an IDX API and an IDX plugin?

An API provides data your developer or coding assistant uses to build a custom experience. A plugin generally supplies a prebuilt integration or interface within its supported platform. Choose an API when you want control of the interface and can maintain the website code; choose a packaged solution when you prefer more of that interface already built.

Can I use this with React, WordPress, or an AI website builder?

The API uses server-to-server HTTP requests and JSON responses. Your chosen platform must support a secure backend or serverless integration, either directly or through a developer-built service. A browser-only site cannot safely hold the private key. We review your stack with you rather than promising a native plugin for every builder.

What does one MLS mean? Can I connect two?

One MLS means one approved listing-data source, not one state. A market can span more than one source. The base plan covers one website and one MLS; additional approved sources can be configured for an account. Contact us to agree the scope and pricing for multiple MLS feeds before setup.

Are MLS fees and engineering support included?

MLS fees for the included source, integration assistance, and ongoing support are included in the $129 monthly plan, with a $200 one-time setup fee. You can work directly with Craig on the IDX integration. This is not an unlimited custom website development allowance.

How fast is the API, and how fresh are the listings?

The API offers paginated search, separate detail and photo endpoints, and bounded map results so an integration can request the data needed for each screen. Response time depends on the query, result size, and network. Listing freshness depends on feed synchronization, not request speed. We review refresh behavior and test representative queries for your integration; we do not publish an unmeasured latency or uptime guarantee.

How long does IDX API setup take?

Timing depends on MLS and brokerage approvals, feed readiness, and your integration. We discuss these dependencies with you before confirming a setup timeline. Creating an API key alone does not mean the feed is approved or ready to launch.

Does this include a website, hosting, CRM, or AI assistant?

No. This product supplies the IDX API and integration support for a website you build and host. It does not include a finished website, CRM, map interface, or built-in AI assistant. If you want us to build and manage the full website, explore our managed website plans.

Prefer to see a finished website? Explore our demo using Oklahoma data ↗. The demo shows our managed website platform, not everything included in the API-only plan.

Let’s talk about your build

You bring the idea.
We’ll help with the IDX connection.

Tell Craig which MLS you belong to, what you’re building, and the platform or AI coding assistant you plan to use. We’ll discuss access, setup, and the right next step.

Email opens your mail app. You can also write to support@agentwinds.com. No payment or account required to discuss your project.