> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aris247.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IDX Broker

> Connect ARIS to IDX Broker for live MLS listing search.

# IDX Broker Integration

IDX Broker is the most common MLS data provider for real estate websites. ARIS connects directly to IDX Broker's API to search listings in real time.

## Setup

<Steps>
  <Step title="Log in to IDX Broker">
    Open your [IDX Broker dashboard](https://middleware.idxbroker.com/)
  </Step>

  <Step title="Get your API keys">
    Go to **API → Access** and copy your **API Key** (access key). Note your **Ancillary Key** if you have one.
  </Step>

  <Step title="Connect in ARIS">
    In the ARIS dashboard, go to **MLS Sync → IDX Broker** and enter both keys.
  </Step>

  <Step title="Save">
    ARIS automatically syncs your listing data and begins serving it through the widget.
  </Step>
</Steps>

## What ARIS uses from IDX

| Data                  | Used for                                |
| --------------------- | --------------------------------------- |
| Property listings     | Search results, featured listings       |
| Property photos       | Image carousels in chat                 |
| Property URLs         | Deep links to full listing details      |
| Video URLs            | Virtual tour links                      |
| Property descriptions | AI context for answering questions      |
| Agent/office info     | Agent attribution and featured listings |

## API reference

ARIS uses the following IDX Broker API methods:

* **Client results** — property search by city, price, beds, etc.
* **Client featured** — promoted listings for an agent or office
* **Component search** — advanced field-level search

See the [IDX Broker API docs](https://middleware.idxbroker.com/docs/api/methods/index.html) for the full method reference.

## Follow Up Boss

<Info>
  If your IDX Broker account is connected to [Follow Up Boss](https://www.followupboss.com/), leads captured by ARIS are automatically synced to your CRM. No additional setup is needed.
</Info>

## Troubleshooting

<AccordionGroup>
  <Accordion title="No listings found after connecting">
    * Verify your API key is correct in the IDX Broker dashboard
    * Confirm your MLS data feed is active (check [IDX MLS coverage](https://idxbroker.com/idx_mls_coverage))
    * Allow 5-10 minutes for the initial sync to complete
  </Accordion>

  <Accordion title="Stale listing data">
    ARIS fetches from IDX Broker in real time on each search. If you see stale data, the issue is upstream in the MLS feed update schedule (typically 15 minutes to 4 hours depending on your MLS).
  </Accordion>
</AccordionGroup>