# Get your Flexmls saved searches through an API

> Read the listings in your Flexmls saved searches, with their new listings, status changes and price changes, and your reverse prospecting matches, with one API call each. A workflow can run your saved searches each morning and email you what changed.

Page: https://fous.com/automate/flexmls
Updated: 2026-11-12

Works with your own Flexmls account. Fous is an independent product.

## What you can build on Flexmls

### Run a saved search

Opens one of your Saved Searches and reads the listings it returns, marking new listings, status changes and price changes since the date you give.

- Takes: Saved search name, changed since (optional)
- Returns: MLS number, address, status, list price, change type, change date

### Get reverse prospecting matches

Reads the Reverse Prospecting Matches page for one of your Active, Pending or Hold listings: the members whose contacts have saved searches that match it.

- Takes: MLS number of your listing, prospecting period (optional)
- Returns: Listing, member name, office, member contact information

### List a contact's subscriptions

Reads the Searches/Subscriptions tab of one contact in Contact Management: each subscription, its schedule and whether Preview Mode is on.

- Takes: Contact name
- Returns: Subscription name, saved search, schedule, Preview Mode, recipients, opt-in status

### Set up a subscription for a contact

Creates a subscription on one of your saved searches for a contact, with the schedule you choose and Preview Mode on, so you review listings before they go out.

- Takes: Contact name, saved search name, schedule
- Returns: Subscription name, contact, schedule, Preview Mode, opt-in status

## Automate Flexmls with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Morning check of your saved searches

Starts: Every weekday at 7:00

1. For each saved search you name, run the saved search.
2. Keep the listings that are new, or whose status or list price changed, since the last run.
3. Email you the list, one section per saved search.

### Weekly reverse prospecting for your listings

Starts: Every Monday at 8:00

1. For each of your listings you name, get the reverse prospecting matches.
2. Keep the members who were not matched on the last run.
3. Email you the new matches, one section per listing, to follow up by hand.

### New listings from a saved search, posted to your CRM

Starts: Every hour

1. Run the saved search you name.
2. Keep only listings that were not there on the last run, and stop when there are none.
3. Post MLS number, address, status and list price to your CRM's webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Run a saved search” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "flexmls.com/run_saved_search",
    "input": {
      "saved_search": "Northwind buyers, 3+ beds",
      "changed_since": "2026-11-11"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "saved_search": "Northwind buyers, 3+ beds",
    "total_matches": 46,
    "changes": [
      {
        "mls_number": "6120458",
        "address": "1418 Acme Ridge Dr",
        "status": "Active",
        "list_price": 489000,
        "change_type": "New listing",
        "change_date": "2026-11-11"
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## Flexmls’s own options

FBS offers the Spark API, raw data feeds meant for web developers rather than for real estate agents themselves. Registering is free, but live data needs a data plan from your MLS in the Spark Datamart or your MLS's approval, and not every MLS offers plans. In Flexmls itself you can export search results to a .csv file.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Spark API | Listing data as raw feeds, with an IDX, VOW or Private role depending on where the data will be shown. | Free developer registration, then a data plan bought in the Spark Datamart and approved by the MLS, or a key from the MLS. |
| A broker's or agent's own data | A Private key limited to listings where you were the listing or selling agent, or all your office's or company's agents. | A data plan from your MLS, where it offers one. Data pulled with a Private key may never be displayed publicly. |
| Flexmls IDX solutions | Ready-made listing search for your website, such as the SmartFrame and the WordPress Plugin. | Arranged with FBS's IDX team. |
| Flexmls by hand | Saved Searches, subscriptions and Reverse Prospecting, with search results exported to .csv by Generic Text Export or a Custom Text Export template. | Your Flexmls account from your MLS. Other export options vary by MLS. |

Read on November 12, 2026: [Spark API: set up access](https://sparkplatform.com/docs/overview/set_up_access), [Flexmls Help: export search results](https://help.flexmls.com/en/export-search-results.html).

## Signing in to Flexmls

You sign in at www.flexmls.com with your username and password, and the same login works in the Flexmls mobile apps. Members of MLSs that use FBS's Launch Dashboard get single sign-on with FBS as the identity provider. With Fous you sign in once through Flexmls's own sign-in with your own account: the login is sealed with AES-256, code and AI agents never see it, and an expired session is signed back in.

## Worth knowing

- **Each MLS decides on API access**: Spark API keys are ultimately up to each MLS, and not every MLS offers data plans in the Spark Datamart. A key for your own data comes with the Private role, whose data may never be shown publicly.
- **Saved searches track changes for you**: By default a saved search counts new listings, status changes and price changes. Its summary shows new listings in the last 24 hours and new listings since a date, 30 days back by default.
- **Subscriptions need opt-in**: A contact must confirm an opt-in email before receiving listing emails. Each subscription is limited to 200 recipients, and with Preview Mode on you review new listings before they go out.
- **Reverse prospecting has a window**: Matches cover your Active, Pending and Hold listings, and only contacts with Enable Reverse Prospecting checked who clicked Flexmls emailed links in the chosen period. The other member's contact is not identified.

## More in Real estate: property management and listings

- [レインズ](https://fous.com/automate/reins.md)
- [HomeWiseDocs](https://fous.com/automate/homewisedocs.md)
- [Bright MLS](https://fous.com/automate/bright-mls.md)
- [CRMLS](https://fous.com/automate/crmls.md)
- [Matrix](https://fous.com/automate/matrix.md)
- [Paragon MLS](https://fous.com/automate/paragon-mls.md)
- [Ignite](https://fous.com/automate/ignite.md)
- [PF Expert](https://fous.com/automate/pf-expert.md)
- [Rightmove Plus](https://fous.com/automate/rightmove-plus.md)
- [ZooplaPro](https://fous.com/automate/zooplapro.md)
- [AppFolio Property Manager](https://fous.com/automate/appfolio-property-manager.md)
- [Buildium](https://fous.com/automate/buildium.md)
- [Entrata](https://fous.com/automate/entrata.md)
- [PropertyMe](https://fous.com/automate/propertyme.md)
- [Yardi Voyager](https://fous.com/automate/yardi-voyager.md)
- [Rental Bonds Online](https://fous.com/automate/rental-bonds-online.md)
- [RTBA Online](https://fous.com/automate/rtba-online.md)
- [ShowingTime](https://fous.com/automate/showingtime.md)
- [Deposit Protection Service](https://fous.com/automate/deposit-protection-service.md)
- [Tenancy Deposit Scheme](https://fous.com/automate/tenancy-deposit-scheme.md)

Other industries: [ASCAP Member Access](/automate/ascap-member-access), [AlbertsonsNet for Suppliers](/automate/albertsonsnet-for-suppliers), [REWE Group Supplier Portal](/automate/rewe-group-supplier-portal), [Verizon Enterprise Center](/automate/verizon-enterprise-center), [Gas Safe Register online services](/automate/gas-safe-register-online-services), [Taulia supplier portal](/automate/taulia-supplier-portal).

## Frequently asked questions

### Does Flexmls have an API?

Yes, FBS's Spark API, but it is meant for developers and MLS-approved uses. Registration is free; live data needs a data plan from your MLS in the Spark Datamart or your MLS's approval. Plans for an agent's own data issue a Private key limited to your listings and sales. Inside Flexmls you can export search results to .csv.

### Can I export a saved search from Flexmls?

Yes, from its results. Open the saved search, choose Export in the More menu, pick all matches or selected ones, and Generic Text Export writes all listing data to a .csv file. A Custom Text Export template from My Exports picks the fields. A method you build returns the same listings as JSON instead.

### Can Flexmls send new listings to my clients automatically?

Yes, with a subscription on a saved search. It sends ASAP, within minutes of a listing being added or changed, or daily, weekly or on days you pick. The contact must confirm an opt-in email first, and clients who use the Flexmls Portal see the listings in its News Feed.

### Is Fous affiliated with FBS?

No. Fous is an independent product. You use it with your own Flexmls account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Flexmls (FBS). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.