{
  "data": {
    "id": "UpTA9hd0YmaaNvAQY",
    "actId": "ga4id9tv6zzNvN7Wi",
    "userId": "NL4ThgItAwaoBlffQ",
    "startedAt": "2026-11-18T06:47:29.076Z",
    "finishedAt": "2026-11-18T06:47:37.237Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 8065,
      "runTimeSecs": 8.065,
      "computeUnits": 0.00896111111111111,
      "imageSizeBytes": 319325184
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "6GwdnIcc2aWR7LzCS",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Trade Me Property Scraper Input\",\n  \"description\": \"Search Trade Me Property residential listings for sale or rent across New Zealand, or refresh specific listings. No account, cookies or API key required.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"What to scrape\",\n      \"type\": \"string\",\n      \"description\": \"Search residential properties for sale, search rental listings, or refresh a list of property URLs you already track.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"searchForSale\",\n        \"searchForRent\",\n        \"byListingUrls\"\n      ],\n      \"enumTitles\": [\n        \"Search properties for sale\",\n        \"Search rental listings\",\n        \"Refresh specific listing URLs\"\n      ],\n      \"default\": \"searchForSale\",\n      \"prefill\": \"searchForSale\",\n      \"sectionCaption\": \"Mode and location\"\n    },\n    \"region\": {\n      \"title\": \"Region\",\n      \"type\": \"string\",\n      \"description\": \"New Zealand region to search. Choose All New Zealand to search nationwide.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"Northland\",\n        \"Auckland\",\n        \"Waikato\",\n        \"Bay of Plenty\",\n        \"Gisborne\",\n        \"Hawke's Bay\",\n        \"Taranaki\",\n        \"Manawatu / Whanganui\",\n        \"Wellington\",\n        \"Nelson / Tasman\",\n        \"Marlborough\",\n        \"West Coast\",\n        \"Canterbury\",\n        \"Otago\",\n        \"Southland\",\n        \"All New Zealand\"\n      ],\n      \"enumTitles\": [\n        \"Northland\",\n        \"Auckland\",\n        \"Waikato\",\n        \"Bay of Plenty\",\n        \"Gisborne\",\n        \"Hawke's Bay\",\n        \"Taranaki\",\n        \"Manawatu / Whanganui\",\n        \"Wellington\",\n        \"Nelson / Tasman\",\n        \"Marlborough\",\n        \"West Coast\",\n        \"Canterbury\",\n        \"Otago\",\n        \"Southland\",\n        \"All New Zealand\"\n      ],\n      \"default\": \"Auckland\",\n      \"prefill\": \"Auckland\"\n    },\n    \"district\": {\n      \"title\": \"District (optional)\",\n      \"type\": \"string\",\n      \"description\": \"Narrow the search to one district, for example Auckland City or Christchurch City. Enter a district name or Trade Me district ID.\",\n      \"editor\": \"textfield\"\n    },\n    \"suburb\": {\n      \"title\": \"Suburb (optional)\",\n      \"type\": \"string\",\n      \"description\": \"Narrow the search to one suburb, for example Ponsonby or Riccarton. Enter a suburb name or Trade Me suburb ID.\",\n      \"editor\": \"textfield\"\n    },\n    \"searchString\": {\n      \"title\": \"Keyword (optional)\",\n      \"type\": \"string\",\n      \"description\": \"Only return listings whose title or description matches this keyword, for example villa, waterfront or garage.\",\n      \"editor\": \"textfield\",\n      \"sectionCaption\": \"Search filters\"\n    },\n    \"propertyType\": {\n      \"title\": \"Property type\",\n      \"type\": \"string\",\n      \"description\": \"Limit results to one type of property.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"house\",\n        \"apartment\",\n        \"townhouse\",\n        \"unit\",\n        \"section\",\n        \"dwelling\",\n        \"bareland\",\n        \"lifestyle\",\n        \"rural\",\n        \"newdevelopment\",\n        \"carpark\"\n      ],\n      \"enumTitles\": [\n        \"All types\",\n        \"House\",\n        \"Apartment\",\n        \"Townhouse\",\n        \"Unit\",\n        \"Section / Land\",\n        \"Lifestyle / Dwelling\",\n        \"Bare land\",\n        \"Lifestyle (legacy, same as Lifestyle / Dwelling)\",\n        \"Rural (legacy, maps to Lifestyle / Dwelling)\",\n        \"New development (legacy, new builds only)\",\n        \"Carpark (legacy, keyword search)\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"minPrice\": {\n      \"title\": \"Minimum price or weekly rent (NZD)\",\n      \"type\": \"integer\",\n      \"description\": \"Lowest asking price for sale listings, or lowest weekly rent for rental listings.\",\n      \"minimum\": 0,\n      \"maximum\": 10000000\n    },\n    \"maxPrice\": {\n      \"title\": \"Maximum price or weekly rent (NZD)\",\n      \"type\": \"integer\",\n      \"description\": \"Highest asking price for sale listings, or highest weekly rent for rental listings.\",\n      \"minimum\": 0,\n      \"maximum\": 10000000\n    },\n    \"minBedrooms\": {\n      \"title\": \"Minimum bedrooms\",\n      \"type\": \"integer\",\n      \"description\": \"Smallest number of bedrooms to include. Use 0 to include studios.\",\n      \"minimum\": 0,\n      \"maximum\": 20\n    },\n    \"maxBedrooms\": {\n      \"title\": \"Maximum bedrooms\",\n      \"type\": \"integer\",\n      \"description\": \"Largest number of bedrooms to include.\",\n      \"minimum\": 0,\n      \"maximum\": 20\n    },\n    \"minBathrooms\": {\n      \"title\": \"Minimum bathrooms\",\n      \"type\": \"integer\",\n      \"description\": \"Smallest number of bathrooms to include.\",\n      \"minimum\": 0,\n      \"maximum\": 20\n    },\n    \"maxBathrooms\": {\n      \"title\": \"Maximum bathrooms\",\n      \"type\": \"integer\",\n      \"description\": \"Largest number of bathrooms to include.\",\n      \"minimum\": 0,\n      \"maximum\": 20\n    },\n    \"minLandArea\": {\n      \"title\": \"Minimum land area (m²)\",\n      \"type\": \"integer\",\n      \"description\": \"Smallest land area in square metres.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000\n    },\n    \"maxLandArea\": {\n      \"title\": \"Maximum land area (m²)\",\n      \"type\": \"integer\",\n      \"description\": \"Largest land area in square metres.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000\n    },\n    \"minFloorArea\": {\n      \"title\": \"Minimum floor area (m²)\",\n      \"type\": \"integer\",\n      \"description\": \"Smallest floor area in square metres.\",\n      \"minimum\": 0,\n      \"maximum\": 100000\n    },\n    \"maxFloorArea\": {\n      \"title\": \"Maximum floor area (m²)\",\n      \"type\": \"integer\",\n      \"description\": \"Largest floor area in square metres.\",\n      \"minimum\": 0,\n      \"maximum\": 100000\n    },\n    \"minParking\": {\n      \"title\": \"Minimum parking spaces\",\n      \"type\": \"integer\",\n      \"description\": \"Smallest number of garage, carport or off-street parking spaces.\",\n      \"minimum\": 0,\n      \"maximum\": 20\n    },\n    \"maxParking\": {\n      \"title\": \"Maximum parking spaces\",\n      \"type\": \"integer\",\n      \"description\": \"Largest number of garage, carport or off-street parking spaces.\",\n      \"minimum\": 0,\n      \"maximum\": 20\n    },\n    \"minLounges\": {\n      \"title\": \"Minimum living areas\",\n      \"type\": \"integer\",\n      \"description\": \"Smallest number of separate lounges or living areas.\",\n      \"minimum\": 0,\n      \"maximum\": 20\n    },\n    \"maxLounges\": {\n      \"title\": \"Maximum living areas\",\n      \"type\": \"integer\",\n      \"description\": \"Largest number of separate lounges or living areas.\",\n      \"minimum\": 0,\n      \"maximum\": 20\n    },\n    \"salesMethod\": {\n      \"title\": \"Sale method\",\n      \"type\": \"string\",\n      \"description\": \"Only return sale listings using this method. Ignored for rental searches.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"auction\",\n        \"negotiation\",\n        \"tender\",\n        \"deadlinesale\",\n        \"pricedisplayed\"\n      ],\n      \"enumTitles\": [\n        \"Any method\",\n        \"Auction\",\n        \"Negotiation\",\n        \"Tender\",\n        \"Deadline sale\",\n        \"Asking price\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"openHomesOnly\": {\n      \"title\": \"Only listings with open homes\",\n      \"type\": \"boolean\",\n      \"description\": \"Return only properties that have an upcoming open home.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"newHomesOnly\": {\n      \"title\": \"Only new builds\",\n      \"type\": \"boolean\",\n      \"description\": \"Return only new-build properties.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"homeIncomeOnly\": {\n      \"title\": \"Only home and income\",\n      \"type\": \"boolean\",\n      \"description\": \"Return only home-and-income properties.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"sortOrder\": {\n      \"title\": \"Sort order\",\n      \"type\": \"string\",\n      \"description\": \"Order of the search results.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"Default\",\n        \"PriceAsc\",\n        \"PriceDesc\",\n        \"ExpiryDesc\",\n        \"EarliestOpenHome\"\n      ],\n      \"enumTitles\": [\n        \"Featured first\",\n        \"Lowest price first\",\n        \"Highest price first\",\n        \"Latest listings first\",\n        \"Earliest open home first\"\n      ],\n      \"default\": \"Default\",\n      \"prefill\": \"Default\"\n    },\n    \"includeDetails\": {\n      \"title\": \"Load full details for every search result\",\n      \"type\": \"boolean\",\n      \"description\": \"Fetch the full listing page data for each result. Adds the description, every photo, agent names and property features, at the cost of one extra request per listing.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"listingUrls\": {\n      \"title\": \"Listing URLs or IDs\",\n      \"type\": \"array\",\n      \"description\": \"Trade Me Property listing URLs or numeric listing IDs. Used when mode is Refresh specific listing URLs.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": [],\n      \"sectionCaption\": \"Specific listings\"\n    },\n    \"maxItems\": {\n      \"title\": \"Maximum listings\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum number of listings to save. Trade Me serves up to 50 per page; the actor walks pages until it reaches this limit or the source is exhausted.\",\n      \"minimum\": 1,\n      \"maximum\": 5000,\n      \"default\": 50,\n      \"prefill\": 20,\n      \"sectionCaption\": \"Output\"\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Trade Me NZ Residential Listings Scraper\n\nTrade Me is New Zealand's largest property marketplace, with homes for sale and rentals listed in every region from Northland to Southland. This actor collects residential listings straight from Trade Me Property's public search data, runs entirely without an account, cookie, API key or proxy setup, and returns clean rows ready for analysis, alerts or a CRM.\n\n## What you can do\n\n- **Search homes for sale** with price, bedroom, bathroom, land area, floor area, parking, living area, property type and sale-method filters.\n- **Search rental listings** with weekly rent, bedroom, bathroom, parking and property-type filters, plus available-from and tenant details.\n- **Refresh listings you already track** by pasting Trade Me Property URLs or numeric listing IDs.\n- **Narrow by location** with a region, district or suburb, or search all of New Zealand at once.\n- **Order the results** by featured, price, newest or the earliest open home.\n- **Walk the full result set** automatically. Trade Me serves up to 50 listings per page; the actor requests page after page until it reaches your limit or the source runs out.\n- **Optionally load full details** for every search result to add the description, every photo, agent names and property features.\n\nNo login or developer application is needed, so the actor works the same for every user.\n\n## Inputs\n\n| Input | Default | What it does |\n| --- | --- | --- |\n| `mode` | `searchForSale` | `searchForSale`, `searchForRent` or `byListingUrls`. |\n| `region` | `Auckland` | One of the 15 New Zealand regions, or All New Zealand. |\n| `district` | – | Optional district name or Trade Me district ID. |\n| `suburb` | – | Optional suburb name or Trade Me suburb ID. |\n| `searchString` | – | Optional keyword matched against the listing title and description. |\n| `propertyType` | All types | House, apartment, townhouse, unit, section, lifestyle/dwelling or bare land. |\n| `minPrice` / `maxPrice` | – | Asking price for sale searches, weekly rent for rental searches. |\n| `minBedrooms` / `maxBedrooms` | – | Bedroom range. Use 0 to include studios. |\n| `minBathrooms` / `maxBathrooms` | – | Bathroom range. |\n| `minLandArea` / `maxLandArea` | – | Land area range in square metres. |\n| `minFloorArea` / `maxFloorArea` | – | Floor area range in square metres. |\n| `minParking` / `maxParking` | – | Garage, carport and off-street parking range. |\n| `minLounges` / `maxLounges` | – | Separate living-area range. |\n| `salesMethod` | Any method | Auction, negotiation, tender, deadline sale or asking price. |\n| `openHomesOnly` | `false` | Keep only listings with an upcoming open home. |\n| `newHomesOnly` | `false` | Keep only new-build listings. |\n| `homeIncomeOnly` | `false` | Keep only home-and-income listings. |\n| `sortOrder` | `Default` | Featured first, lowest price, highest price, latest listings or earliest open home. |\n| `includeDetails` | `false` | Load the full detail view for each search result (description, all photos, agents, features). |\n| `listingUrls` | – | Trade Me listing URLs or numeric IDs for `byListingUrls`. |\n| `maxItems` | 50 | Upper limit for the run, from 1 to 5,000. |\n\nOld saved tasks that still send `startUrls` are handled automatically: those URLs are treated as `listingUrls`.\n\n## Output\n\nEvery dataset item is one property. Empty values are omitted rather than written as `null`.\n\n| Field | Description |\n| --- | --- |\n| `listingId` | Trade Me listing ID. |\n| `url` | Canonical Trade Me Property listing URL. |\n| `title` | Listing headline. |\n| `address` | Full display address, or the best address text Trade Me provides. |\n| `streetAddress` | Street portion of the address exactly as listed. |\n| `suburb`, `city` | Suburb and district/city. |\n| `region`, `regionId` | New Zealand region and its Trade Me ID. |\n| `districtId`, `suburbId` | Trade Me location IDs. |\n| `propertyId` | Agency's property reference, when published (common on rentals). |\n| `propertyType` | House, apartment, townhouse, unit, section, dwelling or bare land. |\n| `bedrooms`, `bathrooms` | Room counts. |\n| `landArea`, `floorArea` | Square metres, when published. |\n| `garages`, `totalParking` | Total parking spaces. |\n| `parking` | Parking description, for example `2 Car Garage`. |\n| `lounges`, `toilets`, `studies`, `ensuites` | Additional room counts, when published. |\n| `price`, `priceDisplay` | Numeric asking price (when the listing shows one) and the original price text. Auction, tender and negotiation listings keep the label without inventing a number. |\n| `rentPerWeek`, `rentPerWeekDisplay` | Weekly rent in NZD for rentals, or the original rent text when no clean number exists. |\n| `rateableValue` | Council rateable value (RV) in NZD, when published. |\n| `agency`, `agencyPhone`, `agencyWebsite` | Listing agency details. |\n| `agentName`, `agentNames` | Listing agent name(s). |\n| `listingDate`, `expiryDate` | Listing start and end dates in `YYYY-MM-DD`. |\n| `saleMethod`, `saleDate` | Sale method and auction/tender/deadline date for for-sale listings. |\n| `description` | Full description (up to 2,000 characters) when full details are loaded. |\n| `features` | Feature lines from the listing detail view, such as broadband or smoke alarm. |\n| `imageUrl`, `images` | Main photo and every photo, using full-size URLs. |\n| `latitude`, `longitude` | GPS coordinates. |\n| `openHomes` | Upcoming open-home objects with ISO `start` and `end` timestamps. |\n| `availableFrom` | Rental availability date. |\n| `smokersOkay`, `maxTenants`, `whiteware`, `idealTenant`, `amenities` | Rental terms, when published. |\n| `broadband`, `smokeAlarm` | Connectivity and safety details from the detail view. |\n| `viewCount`, `watcherCount` | Public view and watcher counts from the detail view. |\n| `suburbAverageSalePrice` | Recent average sale price for the suburb, when Trade Me publishes it. |\n| `recordType` | Always `tradeMeProperty`. |\n| `scrapedAt` | UTC scrape timestamp. |\n\n## Examples\n\nSearch the first 100 Auckland homes for sale between NZ$700,000 and NZ$1,200,000 with at least three bedrooms:\n\n```json\n{\n  \"mode\": \"searchForSale\",\n  \"region\": \"Auckland\",\n  \"minPrice\": 700000,\n  \"maxPrice\": 1200000,\n  \"minBedrooms\": 3,\n  \"sortOrder\": \"PriceAsc\",\n  \"maxItems\": 100\n}\n```\n\nRefresh three listings you already follow:\n\n```json\n{\n  \"mode\": \"byListingUrls\",\n  \"listingUrls\": [\n    \"https://www.trademe.co.nz/a/property/residential/sale/auckland/auckland-city/epsom/listing/6226341247\",\n    \"6224742628\",\n    \"6236406095\"\n  ]\n}\n```\n\n## How it works\n\nThe actor reads the same public search and listing data that powers the Trade Me Property website. It requests 50 listings per page, de-duplicates by listing ID and stops at your `maxItems` limit or when Trade Me has no more matching listings. Optional detail requests reuse the same cookieless connection. Transient rate limits and server errors are retried with backoff.\n\n## Limitations\n\n- Trade Me serves at most 50 listings per search request. The actor pages through the result set, but a single run is capped at 5,000 saved listings; split a very large search by region, price band or property type.\n- Pets-allowed status is not exposed in Trade Me's public listing data, so it cannot be returned.\n- New-development, rural and commercial listings sit in separate Trade Me categories and are outside this residential actor.\n- Some fields are conditional by nature: an auction listing has no numeric price, a brand-new listing may not have GPS coordinates yet, and open homes only exist for properties that schedule them.\n- Trade Me can change its public data format at any time. The actor validates every response and reports a clear status message rather than saving partial or fabricated rows.\n\n## Data source\n\nPublic Trade Me Property search and listing data at `trademe.co.nz`, read without authentication, cookies or user-supplied credentials.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "trade-me-nz-residential-listings-scraper",
      "title": "Trade Me NZ Residential Listings Scraper",
      "description": "Search Trade Me Property for homes for sale or rent across any New Zealand region, filtered by price, bedrooms, bathrooms, land and floor area, parking, property type and sale method, or refresh a list of listing URLs you already track.",
      "version": "1.1",
      "buildTag": "latest",
      "dockerfile": "../Dockerfile",
      "readme": "# Trade Me NZ Residential Listings Scraper\n\nTrade Me is New Zealand's largest property marketplace, with homes for sale and rentals listed in every region from Northland to Southland. This actor collects residential listings straight from Trade Me Property's public search data, runs entirely without an account, cookie, API key or proxy setup, and returns clean rows ready for analysis, alerts or a CRM.\n\n## What you can do\n\n- **Search homes for sale** with price, bedroom, bathroom, land area, floor area, parking, living area, property type and sale-method filters.\n- **Search rental listings** with weekly rent, bedroom, bathroom, parking and property-type filters, plus available-from and tenant details.\n- **Refresh listings you already track** by pasting Trade Me Property URLs or numeric listing IDs.\n- **Narrow by location** with a region, district or suburb, or search all of New Zealand at once.\n- **Order the results** by featured, price, newest or the earliest open home.\n- **Walk the full result set** automatically. Trade Me serves up to 50 listings per page; the actor requests page after page until it reaches your limit or the source runs out.\n- **Optionally load full details** for every search result to add the description, every photo, agent names and property features.\n\nNo login or developer application is needed, so the actor works the same for every user.\n\n## Inputs\n\n| Input | Default | What it does |\n| --- | --- | --- |\n| `mode` | `searchForSale` | `searchForSale`, `searchForRent` or `byListingUrls`. |\n| `region` | `Auckland` | One of the 15 New Zealand regions, or All New Zealand. |\n| `district` | – | Optional district name or Trade Me district ID. |\n| `suburb` | – | Optional suburb name or Trade Me suburb ID. |\n| `searchString` | – | Optional keyword matched against the listing title and description. |\n| `propertyType` | All types | House, apartment, townhouse, unit, section, lifestyle/dwelling or bare land. |\n| `minPrice` / `maxPrice` | – | Asking price for sale searches, weekly rent for rental searches. |\n| `minBedrooms` / `maxBedrooms` | – | Bedroom range. Use 0 to include studios. |\n| `minBathrooms` / `maxBathrooms` | – | Bathroom range. |\n| `minLandArea` / `maxLandArea` | – | Land area range in square metres. |\n| `minFloorArea` / `maxFloorArea` | – | Floor area range in square metres. |\n| `minParking` / `maxParking` | – | Garage, carport and off-street parking range. |\n| `minLounges` / `maxLounges` | – | Separate living-area range. |\n| `salesMethod` | Any method | Auction, negotiation, tender, deadline sale or asking price. |\n| `openHomesOnly` | `false` | Keep only listings with an upcoming open home. |\n| `newHomesOnly` | `false` | Keep only new-build listings. |\n| `homeIncomeOnly` | `false` | Keep only home-and-income listings. |\n| `sortOrder` | `Default` | Featured first, lowest price, highest price, latest listings or earliest open home. |\n| `includeDetails` | `false` | Load the full detail view for each search result (description, all photos, agents, features). |\n| `listingUrls` | – | Trade Me listing URLs or numeric IDs for `byListingUrls`. |\n| `maxItems` | 50 | Upper limit for the run, from 1 to 5,000. |\n\nOld saved tasks that still send `startUrls` are handled automatically: those URLs are treated as `listingUrls`.\n\n## Output\n\nEvery dataset item is one property. Empty values are omitted rather than written as `null`.\n\n| Field | Description |\n| --- | --- |\n| `listingId` | Trade Me listing ID. |\n| `url` | Canonical Trade Me Property listing URL. |\n| `title` | Listing headline. |\n| `address` | Full display address, or the best address text Trade Me provides. |\n| `streetAddress` | Street portion of the address exactly as listed. |\n| `suburb`, `city` | Suburb and district/city. |\n| `region`, `regionId` | New Zealand region and its Trade Me ID. |\n| `districtId`, `suburbId` | Trade Me location IDs. |\n| `propertyId` | Agency's property reference, when published (common on rentals). |\n| `propertyType` | House, apartment, townhouse, unit, section, dwelling or bare land. |\n| `bedrooms`, `bathrooms` | Room counts. |\n| `landArea`, `floorArea` | Square metres, when published. |\n| `garages`, `totalParking` | Total parking spaces. |\n| `parking` | Parking description, for example `2 Car Garage`. |\n| `lounges`, `toilets`, `studies`, `ensuites` | Additional room counts, when published. |\n| `price`, `priceDisplay` | Numeric asking price (when the listing shows one) and the original price text. Auction, tender and negotiation listings keep the label without inventing a number. |\n| `rentPerWeek`, `rentPerWeekDisplay` | Weekly rent in NZD for rentals, or the original rent text when no clean number exists. |\n| `rateableValue` | Council rateable value (RV) in NZD, when published. |\n| `agency`, `agencyPhone`, `agencyWebsite` | Listing agency details. |\n| `agentName`, `agentNames` | Listing agent name(s). |\n| `listingDate`, `expiryDate` | Listing start and end dates in `YYYY-MM-DD`. |\n| `saleMethod`, `saleDate` | Sale method and auction/tender/deadline date for for-sale listings. |\n| `description` | Full description (up to 2,000 characters) when full details are loaded. |\n| `features` | Feature lines from the listing detail view, such as broadband or smoke alarm. |\n| `imageUrl`, `images` | Main photo and every photo, using full-size URLs. |\n| `latitude`, `longitude` | GPS coordinates. |\n| `openHomes` | Upcoming open-home objects with ISO `start` and `end` timestamps. |\n| `availableFrom` | Rental availability date. |\n| `smokersOkay`, `maxTenants`, `whiteware`, `idealTenant`, `amenities` | Rental terms, when published. |\n| `broadband`, `smokeAlarm` | Connectivity and safety details from the detail view. |\n| `viewCount`, `watcherCount` | Public view and watcher counts from the detail view. |\n| `suburbAverageSalePrice` | Recent average sale price for the suburb, when Trade Me publishes it. |\n| `recordType` | Always `tradeMeProperty`. |\n| `scrapedAt` | UTC scrape timestamp. |\n\n## Examples\n\nSearch the first 100 Auckland homes for sale between NZ$700,000 and NZ$1,200,000 with at least three bedrooms:\n\n```json\n{\n  \"mode\": \"searchForSale\",\n  \"region\": \"Auckland\",\n  \"minPrice\": 700000,\n  \"maxPrice\": 1200000,\n  \"minBedrooms\": 3,\n  \"sortOrder\": \"PriceAsc\",\n  \"maxItems\": 100\n}\n```\n\nRefresh three listings you already follow:\n\n```json\n{\n  \"mode\": \"byListingUrls\",\n  \"listingUrls\": [\n    \"https://www.trademe.co.nz/a/property/residential/sale/auckland/auckland-city/epsom/listing/6226341247\",\n    \"6224742628\",\n    \"6236406095\"\n  ]\n}\n```\n\n## How it works\n\nThe actor reads the same public search and listing data that powers the Trade Me Property website. It requests 50 listings per page, de-duplicates by listing ID and stops at your `maxItems` limit or when Trade Me has no more matching listings. Optional detail requests reuse the same cookieless connection. Transient rate limits and server errors are retried with backoff.\n\n## Limitations\n\n- Trade Me serves at most 50 listings per search request. The actor pages through the result set, but a single run is capped at 5,000 saved listings; split a very large search by region, price band or property type.\n- Pets-allowed status is not exposed in Trade Me's public listing data, so it cannot be returned.\n- New-development, rural and commercial listings sit in separate Trade Me categories and are outside this residential actor.\n- Some fields are conditional by nature: an auction listing has no numeric price, a brand-new listing may not have GPS coordinates yet, and open homes only exist for properties that schedule them.\n- Trade Me can change its public data format at any time. The actor validates every response and reports a clear status message rather than saving partial or fabricated rows.\n\n## Data source\n\nPublic Trade Me Property search and listing data at `trademe.co.nz`, read without authentication, cookies or user-supplied credentials.\n",
      "input": {
        "title": "Trade Me Property Scraper Input",
        "description": "Search Trade Me Property residential listings for sale or rent across New Zealand, or refresh specific listings. No account, cookies or API key required.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "What to scrape",
            "type": "string",
            "description": "Search residential properties for sale, search rental listings, or refresh a list of property URLs you already track.",
            "editor": "select",
            "enum": [
              "searchForSale",
              "searchForRent",
              "byListingUrls"
            ],
            "enumTitles": [
              "Search properties for sale",
              "Search rental listings",
              "Refresh specific listing URLs"
            ],
            "default": "searchForSale",
            "prefill": "searchForSale",
            "sectionCaption": "Mode and location"
          },
          "region": {
            "title": "Region",
            "type": "string",
            "description": "New Zealand region to search. Choose All New Zealand to search nationwide.",
            "editor": "select",
            "enum": [
              "Northland",
              "Auckland",
              "Waikato",
              "Bay of Plenty",
              "Gisborne",
              "Hawke's Bay",
              "Taranaki",
              "Manawatu / Whanganui",
              "Wellington",
              "Nelson / Tasman",
              "Marlborough",
              "West Coast",
              "Canterbury",
              "Otago",
              "Southland",
              "All New Zealand"
            ],
            "enumTitles": [
              "Northland",
              "Auckland",
              "Waikato",
              "Bay of Plenty",
              "Gisborne",
              "Hawke's Bay",
              "Taranaki",
              "Manawatu / Whanganui",
              "Wellington",
              "Nelson / Tasman",
              "Marlborough",
              "West Coast",
              "Canterbury",
              "Otago",
              "Southland",
              "All New Zealand"
            ],
            "default": "Auckland",
            "prefill": "Auckland"
          },
          "district": {
            "title": "District (optional)",
            "type": "string",
            "description": "Narrow the search to one district, for example Auckland City or Christchurch City. Enter a district name or Trade Me district ID.",
            "editor": "textfield"
          },
          "suburb": {
            "title": "Suburb (optional)",
            "type": "string",
            "description": "Narrow the search to one suburb, for example Ponsonby or Riccarton. Enter a suburb name or Trade Me suburb ID.",
            "editor": "textfield"
          },
          "searchString": {
            "title": "Keyword (optional)",
            "type": "string",
            "description": "Only return listings whose title or description matches this keyword, for example villa, waterfront or garage.",
            "editor": "textfield",
            "sectionCaption": "Search filters"
          },
          "propertyType": {
            "title": "Property type",
            "type": "string",
            "description": "Limit results to one type of property.",
            "editor": "select",
            "enum": [
              "",
              "house",
              "apartment",
              "townhouse",
              "unit",
              "section",
              "dwelling",
              "bareland",
              "lifestyle",
              "rural",
              "newdevelopment",
              "carpark"
            ],
            "enumTitles": [
              "All types",
              "House",
              "Apartment",
              "Townhouse",
              "Unit",
              "Section / Land",
              "Lifestyle / Dwelling",
              "Bare land",
              "Lifestyle (legacy, same as Lifestyle / Dwelling)",
              "Rural (legacy, maps to Lifestyle / Dwelling)",
              "New development (legacy, new builds only)",
              "Carpark (legacy, keyword search)"
            ],
            "default": "",
            "prefill": ""
          },
          "minPrice": {
            "title": "Minimum price or weekly rent (NZD)",
            "type": "integer",
            "description": "Lowest asking price for sale listings, or lowest weekly rent for rental listings.",
            "minimum": 0,
            "maximum": 10000000
          },
          "maxPrice": {
            "title": "Maximum price or weekly rent (NZD)",
            "type": "integer",
            "description": "Highest asking price for sale listings, or highest weekly rent for rental listings.",
            "minimum": 0,
            "maximum": 10000000
          },
          "minBedrooms": {
            "title": "Minimum bedrooms",
            "type": "integer",
            "description": "Smallest number of bedrooms to include. Use 0 to include studios.",
            "minimum": 0,
            "maximum": 20
          },
          "maxBedrooms": {
            "title": "Maximum bedrooms",
            "type": "integer",
            "description": "Largest number of bedrooms to include.",
            "minimum": 0,
            "maximum": 20
          },
          "minBathrooms": {
            "title": "Minimum bathrooms",
            "type": "integer",
            "description": "Smallest number of bathrooms to include.",
            "minimum": 0,
            "maximum": 20
          },
          "maxBathrooms": {
            "title": "Maximum bathrooms",
            "type": "integer",
            "description": "Largest number of bathrooms to include.",
            "minimum": 0,
            "maximum": 20
          },
          "minLandArea": {
            "title": "Minimum land area (m²)",
            "type": "integer",
            "description": "Smallest land area in square metres.",
            "minimum": 0,
            "maximum": 1000000
          },
          "maxLandArea": {
            "title": "Maximum land area (m²)",
            "type": "integer",
            "description": "Largest land area in square metres.",
            "minimum": 0,
            "maximum": 1000000
          },
          "minFloorArea": {
            "title": "Minimum floor area (m²)",
            "type": "integer",
            "description": "Smallest floor area in square metres.",
            "minimum": 0,
            "maximum": 100000
          },
          "maxFloorArea": {
            "title": "Maximum floor area (m²)",
            "type": "integer",
            "description": "Largest floor area in square metres.",
            "minimum": 0,
            "maximum": 100000
          },
          "minParking": {
            "title": "Minimum parking spaces",
            "type": "integer",
            "description": "Smallest number of garage, carport or off-street parking spaces.",
            "minimum": 0,
            "maximum": 20
          },
          "maxParking": {
            "title": "Maximum parking spaces",
            "type": "integer",
            "description": "Largest number of garage, carport or off-street parking spaces.",
            "minimum": 0,
            "maximum": 20
          },
          "minLounges": {
            "title": "Minimum living areas",
            "type": "integer",
            "description": "Smallest number of separate lounges or living areas.",
            "minimum": 0,
            "maximum": 20
          },
          "maxLounges": {
            "title": "Maximum living areas",
            "type": "integer",
            "description": "Largest number of separate lounges or living areas.",
            "minimum": 0,
            "maximum": 20
          },
          "salesMethod": {
            "title": "Sale method",
            "type": "string",
            "description": "Only return sale listings using this method. Ignored for rental searches.",
            "editor": "select",
            "enum": [
              "",
              "auction",
              "negotiation",
              "tender",
              "deadlinesale",
              "pricedisplayed"
            ],
            "enumTitles": [
              "Any method",
              "Auction",
              "Negotiation",
              "Tender",
              "Deadline sale",
              "Asking price"
            ],
            "default": "",
            "prefill": ""
          },
          "openHomesOnly": {
            "title": "Only listings with open homes",
            "type": "boolean",
            "description": "Return only properties that have an upcoming open home.",
            "default": false,
            "prefill": false
          },
          "newHomesOnly": {
            "title": "Only new builds",
            "type": "boolean",
            "description": "Return only new-build properties.",
            "default": false,
            "prefill": false
          },
          "homeIncomeOnly": {
            "title": "Only home and income",
            "type": "boolean",
            "description": "Return only home-and-income properties.",
            "default": false,
            "prefill": false
          },
          "sortOrder": {
            "title": "Sort order",
            "type": "string",
            "description": "Order of the search results.",
            "editor": "select",
            "enum": [
              "Default",
              "PriceAsc",
              "PriceDesc",
              "ExpiryDesc",
              "EarliestOpenHome"
            ],
            "enumTitles": [
              "Featured first",
              "Lowest price first",
              "Highest price first",
              "Latest listings first",
              "Earliest open home first"
            ],
            "default": "Default",
            "prefill": "Default"
          },
          "includeDetails": {
            "title": "Load full details for every search result",
            "type": "boolean",
            "description": "Fetch the full listing page data for each result. Adds the description, every photo, agent names and property features, at the cost of one extra request per listing.",
            "default": false,
            "prefill": false
          },
          "listingUrls": {
            "title": "Listing URLs or IDs",
            "type": "array",
            "description": "Trade Me Property listing URLs or numeric listing IDs. Used when mode is Refresh specific listing URLs.",
            "editor": "stringList",
            "default": [],
            "prefill": [],
            "sectionCaption": "Specific listings"
          },
          "maxItems": {
            "title": "Maximum listings",
            "type": "integer",
            "description": "Maximum number of listings to save. Trade Me serves up to 50 per page; the actor walks pages until it reaches this limit or the source is exhausted.",
            "minimum": 1,
            "maximum": 5000,
            "default": 50,
            "prefill": 20,
            "sectionCaption": "Output"
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Trade Me NZ Residential Listings Scraper Output",
        "description": "Residential sale and rental listings from Trade Me Property. Each dataset item contains the listing identity, location, property attributes, pricing, agency details, photos and GPS coordinates, plus optional full-detail fields.",
        "properties": {
          "properties": {
            "type": "string",
            "title": "Trade Me property listings",
            "description": "Dataset containing every scraped Trade Me Property listing.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "defaultMemoryMbytes": 512,
      "minMemoryMbytes": 256,
      "maxMemoryMbytes": 1024,
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Properties",
              "transformation": {
                "fields": [
                  "listingId",
                  "title",
                  "address",
                  "suburb",
                  "city",
                  "region",
                  "propertyType",
                  "bedrooms",
                  "bathrooms",
                  "priceDisplay",
                  "rentPerWeek",
                  "agency",
                  "listingDate",
                  "openHomes"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.1.1",
    "imageDigest": "73d45bdd475b220006fa3ae5f777bbbc2055ff9ea3ed5c26587ec7586ec2f7bd",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.1"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.00896111111111111
    }
  }
}