Question 1

What is the Housing Market API?

Accepted Answer

A RESTful JSON API that lets developers and partners access published real estate listings from across the Housing Market Group network.

The Housing Market API is a RESTful JSON API that allows developers, real estate portals, CRM providers, proptech companies, mobile app developers, and enterprise partners to access published real estate listings from the Housing Market Group marketplace network.

The API provides secure access to real-time property listing data, allowing you to integrate listings directly into your own website, application, CRM, MLS platform, analytics platform, or marketing solution.

Question 2

Who is the Housing Market API designed for?

Accepted Answer

Portals, property search sites, CRM providers, app developers, investment and analytics platforms, marketing companies, and enterprise real estate businesses.

The API is ideal for:

- Real estate portals
- Property search websites
- Real estate CRM providers
- Mobile application developers
- Property investment platforms
- AI and analytics companies
- Marketing platforms
- Enterprise real estate companies
- Developers building custom property solutions

Question 3

What data can I retrieve?

Accepted Answer

Published property listings including location, price, size, key attributes, and images — plus a summary and full HTML description on the single-property endpoint.

The API provides access to published property listings including:

- Property ID
- Listing Type
- Property Type
- Country
- Province / State
- City
- Address
- Postal Code
- GPS Coordinates
- Price
- Currency
- Bedrooms
- Bathrooms
- Living Area
- Land Area
- Build Year
- Publication Date
- Property Images

The single property endpoint additionally provides:

- Property Summary
- Full HTML Description

These fields are documented in the API specification.

Question 4

Is the API REST based?

Accepted Answer

Yes. It is a modern REST API using JSON responses, compatible with virtually every programming language and framework.

Yes.

The Housing Market API is a modern REST API using JSON responses, making it compatible with virtually every programming language and framework.

Question 5

What response format is returned?

Accepted Answer

All responses are returned as JSON.

Question 6

Does the API support HTTPS?

Accepted Answer

Yes. All API communication is encrypted using HTTPS.

Yes.

All API communication is encrypted using HTTPS.

Question 7

How do I authenticate?

Accepted Answer

Every request requires an API key supplied in the x-api-key HTTP header. Keep the key private and server-side only.

Every request requires an API key supplied in the HTTP header:

x-api-key: YOUR_API_KEY

API keys must remain private and should never be embedded into client-side applications or public repositories.

Question 8

How do I obtain an API key?

Accepted Answer

API access is issued individually to approved partners. Contact Housing Market Group to request credentials, partner approval, and IP registration.

API access is issued individually to approved partners.

Simply contact Housing Market Group to request:

- API credentials
- Partner approval
- IP address registration

Question 9

Is IP whitelisting supported?

Accepted Answer

Yes. For additional security, API requests can be restricted to registered server IP addresses.

Yes.

For additional security, API requests can be restricted to registered server IP addresses.

Question 10

Can I call the API directly from JavaScript?

Accepted Answer

No. Your API key should always remain on your backend server; direct browser access exposes your credentials.

No.

Your API key should always remain on your backend server.

Direct browser access is not recommended because it exposes your credentials.

Question 11

How do I retrieve property listings?

Accepted Answer

Use the Properties endpoint, which supports retrieving all listings or filtering by country, listing type, location, price, bedrooms, or recency.

Use the Properties endpoint.

You can retrieve:

- All listings
- Country-specific listings
- Listings by listing type
- Listings by location
- Listings using price filters
- Listings by bedroom count
- Newly published listings

Question 12

Can I retrieve a single property?

Accepted Answer

Yes. The Single Property endpoint returns all listing information together with a summary and full HTML description.

Yes.

The Single Property endpoint returns all listing information together with:

- Summary
- Full HTML Description

Question 13

Can I filter listings?

Accepted Answer

Yes. Supported filters include country, listing type, province, city, bedrooms, min/max price, published-since, and pagination.

Yes.

Supported filters include:

- Country
- Listing Type
- Province
- City
- Bedrooms
- Minimum Price
- Maximum Price
- Published Since
- Pagination

Question 14

Can I retrieve only recently published listings?

Accepted Answer

Yes. Use the published_since parameter to retrieve listings published after a specified date — useful for incremental synchronisation.

Yes.

Use the published_since parameter to retrieve listings published after a specified date.

This is especially useful for incremental synchronisation.

Question 15

Which listing types are supported?

Accepted Answer

Sale, Rent, Vacation Rental, and Co-Living.

Current listing types include:

- Sale
- Rent
- Vacation Rental
- Co-Living

Question 16

Are property images included?

Accepted Answer

Yes. Every property includes one or more image URLs hosted on Housing Market Group's CDN.

Yes.

Every property includes one or more image URLs hosted on Housing Market Group's CDN.

Images may be displayed directly or downloaded depending on your integration agreement.

Question 17

Are image URLs permanent?

Accepted Answer

Image URLs are designed for reliable access, but partners should avoid permanently caching images unless permitted under their agreement.

Image URLs are designed for reliable access. Partners should avoid permanently caching images unless permitted under their agreement.

Question 18

What countries are currently supported?

Accepted Answer

The API provides access to published property databases across all 34 Housing Market Group marketplaces, with daily data updates. Subscribe to a single country, regional bundles, or the complete global dataset.

The Housing Market API currently provides access to published real estate property databases across all 34 Housing Market Group marketplaces, with daily data updates. You can subscribe to a single country, regional bundles, or the complete global dataset.

Asia-Pacific (13 countries):

- Australia
- Cambodia
- China
- Hong Kong
- India
- Indonesia
- Japan
- Malaysia
- Philippines
- Singapore
- Taiwan
- Thailand
- Vietnam

Middle East & North Africa (7 countries):

- Bahrain
- Dubai (UAE)
- Egypt
- Oman
- Qatar
- Saudi Arabia
- Turkey

Europe (4 countries):

- Cyprus
- Germany
- Spain
- United Kingdom

Americas (10 countries):

- Argentina
- Brazil
- Canada
- Colombia
- Mexico
- Panama
- Paraguay
- United States
- Uruguay
- Venezuela

Every country uses the same REST JSON API structure, making it easy to integrate one market and expand to additional countries by simply changing the API base URL. All property databases include listings for sale, rent, vacation rental, and co-living, and are refreshed daily.

Question 19

Does the API convert currencies?

Accepted Answer

No. Prices are always returned in the original listing currency.

No.

Prices are always returned in the original listing currency.

Question 20

Which currencies are used?

Accepted Answer

Prices are always returned in the listing's original local currency. The API supports all local currencies across the 34 marketplaces and never converts prices.

Property prices are always returned in the listing's original local currency for the country where the property is located. The Housing Market API supports all local currencies across our 34 real estate marketplaces, ensuring pricing is displayed exactly as published by the listing agent or property owner.

Supported currencies include, but are not limited to, ARS (Argentina), AUD (Australia), BHD (Bahrain), BRL (Brazil), KHR (Cambodia), CAD (Canada), CNY (China), COP (Colombia), EUR (Cyprus, Germany, Spain), AED (Dubai/UAE), EGP (Egypt), HKD (Hong Kong), INR (India), IDR (Indonesia), JPY (Japan), MYR (Malaysia), MXN (Mexico), OMR (Oman), USD (Panama, United States), PYG (Paraguay), PHP (Philippines), QAR (Qatar), SAR (Saudi Arabia), SGD (Singapore), TWD (Taiwan), THB (Thailand), TRY (Turkey), GBP (United Kingdom), UYU (Uruguay), VES (Venezuela), and VND (Vietnam).

Property prices are not converted by the API. This ensures that all listings reflect their original published price and currency, providing maximum accuracy and consistency for developers, real estate portals, CRM systems, and property marketplaces.

For rental properties, the returned price represents the published monthly rental amount in the property's local currency.

Question 21

Does the API support pagination?

Accepted Answer

Yes. Use the limit and offset parameters; the maximum page size is 200 listings.

Yes.

Standard pagination parameters include:

- limit
- offset

The maximum page size is 200 listings.

Question 22

How should I synchronise all listings?

Accepted Answer

Keep your filters identical while increasing the offset until all records are retrieved. Results are ordered by property ID for stable synchronisation.

Keep your filters identical while increasing the offset until all records have been retrieved.

The API returns results ordered by property ID to maintain stable synchronisation.

Question 23

What HTTP status codes are returned?

Accepted Answer

Common responses are 200 (success), 400 (invalid request), 401 (invalid or missing key), 403 (unauthorized IP), 404 (not found), and 500 (server error).

Common responses include:

- 200 — Success
- 400 — Invalid request
- 401 — Invalid or missing API key
- 403 — Unauthorized source IP
- 404 — Property not found
- 500 — Internal server error

Question 24

Why am I receiving a 403 error?

Accepted Answer

Usually your API key is valid but your server IP has not yet been authorised. Contact Housing Market Group to register your server.

A 403 response usually means:

- Your API key is valid
- Your server IP has not yet been authorised

Please contact Housing Market Group to register your server.

Question 25

Which programming languages are supported?

Accepted Answer

The REST architecture works with virtually any technology, including PHP, Python, Java, C#, Node.js, Go, Ruby, and popular frameworks.

The REST architecture allows integration with virtually any technology, including:

- PHP
- Python
- Java
- C#
- Node.js
- Go
- Ruby
- Laravel
- .NET
- Django
- Spring Boot
- Flutter
- React
- React Native
- Angular
- Vue

Question 26

Can I integrate the API with my CRM?

Accepted Answer

Yes. Many partners use the API to automatically import listings into CRM systems, MLS platforms, marketing automation, portals, and mobile apps.

Yes.

Many partners use the API to automatically import listings into:

- CRM systems
- MLS platforms
- Marketing automation platforms
- Property portals
- Mobile applications

Question 27

Can I synchronise listings automatically?

Accepted Answer

Yes. Most partners schedule automatic synchronisation using background jobs or cron tasks.

Yes.

Most partners schedule automatic synchronisation using background jobs or cron tasks.

Question 28

Is there a request limit?

Accepted Answer

Rate limits depend on your partnership agreement. Enterprise partners may receive higher request allowances.

Rate limits depend on your partnership agreement.

Enterprise partners may receive higher request allowances.

Question 29

Who owns the property data?

Accepted Answer

The listings remain the property of Housing Market Group and its participating publishers. Partners receive access under the terms of their API agreement.

The listings remain the property of Housing Market Group and its participating publishers.

Partners receive access under the terms of their API agreement.

Question 30

Can I republish listings?

Accepted Answer

Yes, if permitted under your API licence agreement.

Question 31

Can I build a commercial application?

Accepted Answer

Absolutely. Many partners use the API to power commercial portals, CRMs, AI platforms, mobile apps, investment platforms, search engines, and marketing solutions.

Absolutely.

Many partners use the API to power commercial:

- Property portals
- CRM systems
- AI platforms
- Mobile applications
- Investment platforms
- Search engines
- Marketing solutions

Question 32

Do you offer enterprise partnerships?

Accepted Answer

Yes. Enterprise partnerships can include higher request limits, dedicated support, custom integrations, priority onboarding, additional market access, and white-label opportunities.

Yes.

Enterprise partnerships can include:

- Higher request limits
- Dedicated support
- Custom integrations
- Priority onboarding
- Additional market access
- White-label opportunities

Question 33

How do I get started?

Accepted Answer

Request an API key, register your server IP, test your first request, receive a successful JSON response, and begin integrating.

Getting started is simple:

- Request an API key.
- Register your server IP.
- Test your first API request.
- Receive a successful JSON response.
- Begin integrating into your application.

The API quick-start guide recommends verifying access with a simple request that returns one property before continuing development.

Question 34

How can I contact Housing Market Group?

Accepted Answer

Visit the Contact page on HousingMarketAPI.com or contact your Housing Market Group representative to request access, technical support, enterprise pricing, partnerships, or integration assistance.

Visit the Contact page on HousingMarketAPI.com or contact your Housing Market Group representative to request:

- API access
- Technical support
- Enterprise pricing
- Partnership opportunities
- Integration assistance

Our API team is happy to help with technical integration, onboarding, enterprise partnerships, and custom implementation requirements.

Housing Market API

General

Authentication & Security

Property Listings

Images

Countries, Currency & Pricing

Error Handling

Integration

Commercial & Licensing

Support & Getting Started

Still need help?

Housing Market API

General

What is the Housing Market API?

Who is the Housing Market API designed for?

What data can I retrieve?

Is the API REST based?

What response format is returned?

Does the API support HTTPS?

Authentication & Security

How do I authenticate?

How do I obtain an API key?

Is IP whitelisting supported?

Can I call the API directly from JavaScript?

Property Listings

How do I retrieve property listings?

Can I retrieve a single property?

Can I filter listings?

Can I retrieve only recently published listings?

Which listing types are supported?

Images

Are property images included?

Are image URLs permanent?

Countries, Currency & Pricing

What countries are currently supported?

Does the API convert currencies?

Which currencies are used?

Pagination & Sync

Does the API support pagination?

How should I synchronise all listings?

Error Handling

What HTTP status codes are returned?

Why am I receiving a 403 error?

Integration

Which programming languages are supported?

Can I integrate the API with my CRM?

Can I synchronise listings automatically?

Is there a request limit?

Commercial & Licensing

Who owns the property data?

Can I republish listings?

Can I build a commercial application?

Do you offer enterprise partnerships?

Support & Getting Started

How do I get started?

How can I contact Housing Market Group?

Explore other products

Still need help?