Maria Torres Homes · Developer resources
API documentation
A practical reference for connecting property search, listing details and photography to Maria’s South Florida website.
01 / Access
The property gateway.
The website uses a site-scoped, read-only gateway. Its server supplies the private IDX credential; browser requests do not need an API key, account token or cookies.
https://tophamtechbe.com/api/treas/idx/v1/website/m.torres.flBrowser requests must come from a registered origin. Maria’s production origins are https://mariatorreshomes.com and https://www.mariatorreshomes.com; staging uses https://main.d1z44nj1jdznyw.amplifyapp.com. A new website origin must be registered before browser access will work. Server requests can omit the Origin header.
This gateway accepts property GET requests only. It does not grant access to private accounts, CRM records, contact submission or administration. MLS display, reuse and redistribution remain subject to the applicable approvals and terms.
02 / Quick start
Begin with a small search.
This request retrieves up to six Fort Lauderdale results from Maria’s authorized BEACH feed. Availability and results change; use the live response.
curl --get 'https://tophamtechbe.com/api/treas/idx/v1/website/m.torres.fl/summary/page' \
--data-urlencode 'state=FL' \
--data-urlencode 'city=Fort Lauderdale' \
--data-urlencode 'originatingSystemName=BEACH' \
--data-urlencode 'pageSize=6' \
--data-urlencode 'firstPhoto=true' \
--header 'Accept: application/json'const response = await fetch(
'https://tophamtechbe.com/api/treas/idx/v1/website/m.torres.fl/summary/page?state=FL&city=Fort%20Lauderdale&originatingSystemName=BEACH&pageSize=6&firstPhoto=true',
{ credentials: 'omit', headers: { Accept: 'application/json' } }
);
if (!response.ok) throw new Error(`Property search failed: ${response.status}`);
const { properties, pagination } = await response.json();03 / Search & maps
Find the right collection.
| GET endpoint | Purpose |
|---|---|
/summary/page | Paged property cards. Recommended for lists. |
/summary/map | Bounded results for the visible map. |
/summary | Legacy summary search; use /summary/page for new lists. |
/data?listingKey=LISTING_KEY | Details for a listing returned by search. |
/data/PROPERTY_ID | Details by internal numeric property ID. |
/media/LISTING_KEY | Listing photography and media. |
| Parameter | Use |
|---|---|
state, city, zip | Location filters. Use FL for Florida. |
originatingSystemName | Use BEACH for this site’s configured feed. |
status | For example, Active. |
propertyType, propertySubType | Filter by the feed’s property classifications. |
minPrice, maxPrice | Numeric price bounds. |
minBedrooms, minBathrooms | Minimum bedroom and bathroom counts. |
hasPool, waterfront | Boolean feature filters: true or false. |
priceSort | highlow or lowhigh. |
firstPhoto | true requests the first photo with summaries. |
pageSize | 1–100 results per list page; default 24. |
cursor | Opaque next_cursor from the previous list response. |
Continue a list search
List responses contain properties, total_count and pagination. Pagination includes page_size, returned, has_more and next_cursor. When has_more is true, send next_cursor as the next request’s cursor, using URLSearchParams to preserve its encoding. Keep the search filters unchanged; begin a new search when they change.
Search the visible map
Use /summary/map with north, south, east, west and zoom. Supply all four bounds together. Map delivery chooses its own bounded size; omit pageSize and cursor. An empty collection is a valid result.
04 / Property details
Follow the listing key.
Take listing_key from a search result and pass it as the camelCase query parameter listingKey. Do not substitute an MLS display number or guess a listing identifier.
const url = new URL('https://tophamtechbe.com/api/treas/idx/v1/website/m.torres.fl/data');
url.searchParams.set('listingKey', listing.listing_key);
const response = await fetch(url, { credentials: 'omit' });The response contains a properties array and total_count. Use the returned property fields and current status; account for missing values. Link to a website listing using /listing/ followed by the encoded listing key.
05 / Photography
Use the listing’s own media.
https://tophamtechbe.com/api/treas/idx/v1/website/m.torres.fl/media/LISTING_KEYReplace LISTING_KEY with the encoded key from search. Media responses contain a media array and total_count. Entries may include media_url, s3_link and order_hint. Handle empty media, use descriptive image alternatives and preserve required attribution. MLS photography is separate from illustrative lifestyle imagery on editorial pages.
06 / Contact & showings
Keep the customer in control.
For a personal inquiry, use Maria’s contact page. To request a showing, open the property in property search and choose its showing action. Those flows collect the customer’s details and the required consent.
Separately authorized contact integrations
The shared service provides POST /api/treas/idx/v1/chatleads for approved integrations. This is outside the property gateway and requires a separately authorized credential and any required Turnstile verification. A property-read credential does not establish permission to submit leads.
| Query parameter | Meaning |
|---|---|
siteId | m.torres.fl |
name, email, phoneNumber | Customer details supplied for the inquiry. |
serviceReq | The customer’s explicit request. |
listingKey | Optional listing context from a search result. |
Submit these as URL-encoded query parameters rather than a JSON body. Authorized callers use the X-API-Key header and, when required, X-Turnstile-Token. Keep private credentials on the server. Submit only after the customer asks to send an inquiry; an unclear timeout is not permission to resend a lead or create a showing.
07 / Errors & limits
Handle the next step clearly.
| Status | Recommended handling |
|---|---|
400 | Correct invalid filters, identifiers or pagination parameters. |
401 / 403 | Check access, the registered origin and integration permissions. |
404 | The listing, route or site registration is unavailable. |
405 | The property gateway permits GET requests only. |
429 | Respect Retry-After and reduce request frequency. |
502 / 503 / 504 | Show a temporary-unavailability message; retry property reads with backoff. |
Limits are configured per site and caller. Respect Retry-After, cancel obsolete searches and debounce map movement. Preserve a useful empty or error state instead of presenting old results as current inventory.
08 / Support
Build with the right context.
For technical integration support, contact support@agentwinds.com and include site ID m.torres.fl, the endpoint, status code and approximate request time. Exclude credentials and customer information.
For real estate questions, contact Maria Torres. Public business identity is available in llms.txt. Review the Privacy Policy and Terms of Service before integrating.
Reference checked October 8, 2026. Examples describe request structure and do not promise listing availability.