Free sandbox: try any request below on the sample suburbs, no signup. For every suburb, create an API key.

Classic docs

Microburbs Property Data API

Listings

Listing photos

GET/v1/listings/{listing_id}/images5¢ per call

The photos of one listing, as signed links you can download for 15 minutes.

What you get. Every photo we hold for the listing, main photo first, in the size you ask for, each as a link to the WebP file on our image store. The links need no key and expire at expires_at: download or cache the photos inside that window, and call again for fresh links. One call covers the whole gallery at a flat price per listing, priced separately from the listing data because photos are heavy.

Which photos. The same ones our listing page shows: the agency's own photography, never a listing portal's, and never logos, banners or office shots. A photo we have not copied to our store yet is left out (new listings' photos usually arrive within a day). A listing whose details we withhold — seen on only one major portal — has no photos here, and no listing_id elsewhere.

Get a listing_id from /v1/listings/search, the SA4 off-market bulk, or the suburb for-sale / for-rent endpoints.

Example: /v1/listings/cc74291e277ad596d6c41a6ce07077f1/images?size=large

About this data ↓

Authorization

Bearer tokentest

Sandbox key test works for the allowlisted GNAF + SAL — no signup.

Request

The only values you send. Fields under Responses below are what comes back — you never pass those.

Path parameters

listing_idstringrequired

The listing's `listing_id`, from any listings endpoint.

Query parameters

sizestringoptional

small ≈ 640 px wide, medium ≈ 1200 px (default), large up to 2048 px.

Responses

Successful Response

application/json

ListingImagesfields returned to you

listing_idstringmay be null

The listing these photos belong to.

sizestringmay be null

The rendition linked: small ≈ 640 px wide, medium ≈ 1200 px, large up to 2048 px.

expires_atstringmay be null

When every link in `images` stops working (UTC, ISO 8601). 15 minutes after the call.

imagesarray of ListingImagemay be null

Every photo we hold for the listing in that size, main photo first. Empty when we hold none yet; new listings' photos usually arrive within a day.

totalintegermay be null

Number of photos in `images`.

About this data

What this is

The photo gallery of one listing: every photo we hold, main photo first, in the size you choose, each as a download link valid for 15 minutes.

What people use it for

Property apps and portals: show listing photos next to the listing data from our search endpoints.
Buyers' agents and CRMs: keep the photos with each listing in a client shortlist.
Analysts and AI tools: run image models over listings, for example to spot renovated kitchens.

Coverage

Photos come from the agency's own marketing, not from portals, and logos and office shots are left out. New listings' photos usually arrive within a day.

Tips

Download or cache the images before expires_at, then call again for fresh links. Use size=small for thumbnails. Get a listing_id from /v1/listings/search or /v1/suburbs/{suburb_name}/listings/for-sale.

GET/v1/listings/{listing_id}/images

cURL

curl --request GET \
  --url 'https://api.microburbs.com.au/v1/listings/cc74291e277ad596d6c41a6ce07077f1/images' \
  --header 'Authorization: Bearer test'

Example Responses

Show schema

{
  "data": {
    "expires_at": "2026-11-12T06:37:01Z",
    "images": [
      {
        "position": 0,
        "url": "https://…/listings/blobs/3dc464bb491923c908a85fbc4b878cd3582e67bef1c0bea255f0069d8647546b/hero.webp?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=900&…&X-Amz-Signature=…"
      },
      {
        "position": 1,
        "url": "https://…/listings/blobs/d865695a6d8de7f435893b89113c54e5a89fd080b4a182e7cb6ad7f705971190/hero.webp?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=900&…&X-Amz-Signature=…"
      },
      {
        "position": 2,
        "url": "https://…/listings/blobs/896d977c1e53409014d58424bb20b28ef28a19ad763ec1042d74cc88853c08f7/hero.webp?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=900&…&X-Amz-Signature=…"
      }
    ],
    "listing_id": "cc74291e277ad596d6c41a6ce07077f1",
    "size": "medium",
    "total": 20
  }
}

Successful Response200

application/json