{
  "data": {
    "id": "h8qsnYHHOCBNfp8bD",
    "actId": "9DHzfXPbmN43uWYSH",
    "userId": "NL4ThgItAwaoBlffQ",
    "startedAt": "2026-11-18T06:48:59.697Z",
    "finishedAt": "2026-11-18T06:49:02.965Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 3183,
      "runTimeSecs": 3.183,
      "computeUnits": 0.0035366666666666667,
      "imageSizeBytes": 319164416
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "6GwdnIcc2aWR7LzCS",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"ChavesNaMão City Property Listings Extractor\",\n  \"description\": \"Scrape sale and rental property listings from ChavesNaMão with city, price, room, area, type and sorting filters, or fetch full details for known listings.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"collectionMode\": {\n      \"title\": \"What to collect\",\n      \"type\": \"string\",\n      \"description\": \"Search listings by city and filters, or fetch full details for specific ChavesNaMão listings.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"listings\",\n        \"details\"\n      ],\n      \"enumTitles\": [\n        \"Search listings\",\n        \"Property details\"\n      ],\n      \"default\": \"listings\",\n      \"prefill\": \"listings\",\n      \"sectionCaption\": \"Collection mode\"\n    },\n    \"transactionType\": {\n      \"title\": \"Sale or rent\",\n      \"type\": \"string\",\n      \"description\": \"Whether to search properties for sale (venda) or for rent (aluguel).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"sell\",\n        \"rent\"\n      ],\n      \"enumTitles\": [\n        \"For sale (Venda)\",\n        \"For rent (Aluguel)\"\n      ],\n      \"default\": \"sell\",\n      \"prefill\": \"sell\"\n    },\n    \"city\": {\n      \"title\": \"City\",\n      \"type\": \"string\",\n      \"description\": \"Brazilian city to search in listings mode. For any other city, paste one of its ChavesNaMão search URLs into Listing URLs.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"sao-paulo\",\n        \"rio-de-janeiro\",\n        \"belo-horizonte\",\n        \"porto-alegre\",\n        \"curitiba\",\n        \"brasilia\",\n        \"salvador\",\n        \"fortaleza\",\n        \"recife\",\n        \"campinas\",\n        \"manaus\",\n        \"belem\",\n        \"goiania\",\n        \"florianopolis\",\n        \"vitoria\",\n        \"praia-grande\",\n        \"joao-pessoa\"\n      ],\n      \"enumTitles\": [\n        \"São Paulo\",\n        \"Rio de Janeiro\",\n        \"Belo Horizonte\",\n        \"Porto Alegre\",\n        \"Curitiba\",\n        \"Brasília\",\n        \"Salvador\",\n        \"Fortaleza\",\n        \"Recife\",\n        \"Campinas\",\n        \"Manaus\",\n        \"Belém\",\n        \"Goiânia\",\n        \"Florianópolis\",\n        \"Vitória\",\n        \"Praia Grande\",\n        \"João Pessoa\"\n      ],\n      \"default\": \"sao-paulo\",\n      \"prefill\": \"sao-paulo\"\n    },\n    \"propertyType\": {\n      \"title\": \"Property type\",\n      \"type\": \"string\",\n      \"description\": \"Restrict the search to one property type, or search every type.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"apartments\",\n        \"houses\",\n        \"gated-houses\",\n        \"kitnets\",\n        \"penthouses\",\n        \"flats\",\n        \"lofts\",\n        \"commercial-rooms\",\n        \"commercial-houses\",\n        \"commercial-points\",\n        \"buildings\",\n        \"warehouses\",\n        \"land\",\n        \"gated-land\",\n        \"commercial-land\",\n        \"farms\",\n        \"rural-farms\",\n        \"garages\"\n      ],\n      \"enumTitles\": [\n        \"All property types\",\n        \"Apartments\",\n        \"Houses and townhouses\",\n        \"Houses in gated communities\",\n        \"Kitnets\",\n        \"Penthouses\",\n        \"Flats\",\n        \"Lofts\",\n        \"Commercial rooms\",\n        \"Commercial houses\",\n        \"Commercial points\",\n        \"Buildings\",\n        \"Warehouses\",\n        \"Land\",\n        \"Land in gated communities\",\n        \"Commercial land\",\n        \"Chácaras\",\n        \"Farms\",\n        \"Garages\"\n      ],\n      \"default\": \"all\",\n      \"sectionCaption\": \"Listing filters\",\n      \"sectionDescription\": \"These filters apply when mode is Search listings. Any value left at zero or empty is not sent to ChavesNaMão.\"\n    },\n    \"bedroomsMin\": {\n      \"title\": \"Minimum bedrooms\",\n      \"type\": \"integer\",\n      \"description\": \"Minimum number of bedrooms (quartos). Use 0 for no minimum.\",\n      \"minimum\": 0,\n      \"maximum\": 20,\n      \"default\": 0\n    },\n    \"bathroomsMin\": {\n      \"title\": \"Minimum bathrooms\",\n      \"type\": \"integer\",\n      \"description\": \"Minimum number of bathrooms (banheiros). Use 0 for no minimum.\",\n      \"minimum\": 0,\n      \"maximum\": 20,\n      \"default\": 0\n    },\n    \"garagesMin\": {\n      \"title\": \"Minimum parking spaces\",\n      \"type\": \"integer\",\n      \"description\": \"Minimum number of garage or parking spaces (vagas). Use 0 for no minimum.\",\n      \"minimum\": 0,\n      \"maximum\": 20,\n      \"default\": 0\n    },\n    \"priceMin\": {\n      \"title\": \"Minimum price (BRL)\",\n      \"type\": \"integer\",\n      \"description\": \"Minimum asking price in Brazilian reais. Leave empty for no minimum.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000000\n    },\n    \"priceMax\": {\n      \"title\": \"Maximum price (BRL)\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum asking price in Brazilian reais. Leave empty for no maximum.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000000\n    },\n    \"areaMin\": {\n      \"title\": \"Minimum area (m²)\",\n      \"type\": \"integer\",\n      \"description\": \"Minimum usable area in square metres. Leave empty for no minimum.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000\n    },\n    \"areaMax\": {\n      \"title\": \"Maximum area (m²)\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum usable area in square metres. Leave empty for no maximum.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000\n    },\n    \"sortBy\": {\n      \"title\": \"Sort order\",\n      \"type\": \"string\",\n      \"description\": \"Order of the listing results.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"relevance\",\n        \"newest\",\n        \"priceAsc\",\n        \"priceDesc\",\n        \"areaAsc\",\n        \"areaDesc\"\n      ],\n      \"enumTitles\": [\n        \"Relevance (site default)\",\n        \"Newest first\",\n        \"Lowest price first\",\n        \"Highest price first\",\n        \"Smallest area first\",\n        \"Largest area first\"\n      ],\n      \"default\": \"relevance\"\n    },\n    \"ownerType\": {\n      \"title\": \"Advertiser\",\n      \"type\": \"string\",\n      \"description\": \"Show every advertiser, only listings direct from the owner, or only real-estate agencies.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"owner\",\n        \"agency\"\n      ],\n      \"enumTitles\": [\n        \"All advertisers\",\n        \"Direct with owner\",\n        \"Real-estate agencies only\"\n      ],\n      \"default\": \"all\"\n    },\n    \"maxItems\": {\n      \"title\": \"Maximum listings\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum number of listings to save across all selected searches (1–1000).\",\n      \"minimum\": 1,\n      \"maximum\": 1000,\n      \"default\": 20,\n      \"prefill\": 3,\n      \"sectionCaption\": \"Result limits\"\n    },\n    \"maxPages\": {\n      \"title\": \"Maximum pages per search\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum result pages to request for each search (30 listings per page). Stops earlier when the source runs out.\",\n      \"minimum\": 1,\n      \"maximum\": 100,\n      \"default\": 34,\n      \"prefill\": 1\n    },\n    \"includeDetails\": {\n      \"title\": \"Fetch full details\",\n      \"type\": \"boolean\",\n      \"description\": \"Fetch each listing's detail page data: full description, publisher phone and CRECI, photo list, amenities, video and tour links, created and updated dates. Costs one extra request per listing.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"listingUrls\": {\n      \"title\": \"Listing URLs\",\n      \"type\": \"array\",\n      \"description\": \"Optional ChavesNaMão search URLs to scrape exactly as configured on the site. Use this for cities, neighbourhoods or filter combinations not covered by the controls above.\",\n      \"editor\": \"stringList\",\n      \"items\": {\n        \"type\": \"string\"\n      },\n      \"sectionCaption\": \"Advanced\"\n    },\n    \"propertyUrls\": {\n      \"title\": \"Property detail URLs\",\n      \"type\": \"array\",\n      \"description\": \"ChavesNaMão property URLs to fetch in details mode (they contain an id-<number> segment).\",\n      \"editor\": \"stringList\",\n      \"items\": {\n        \"type\": \"string\"\n      }\n    },\n    \"propertyIds\": {\n      \"title\": \"Property IDs\",\n      \"type\": \"array\",\n      \"description\": \"ChavesNaMão listing IDs to fetch in details mode. Property URLs also work.\",\n      \"editor\": \"stringList\",\n      \"items\": {\n        \"type\": \"string\"\n      }\n    }\n  }\n}",
    "readme": "# ChavesNaMao City Property Listings Extractor\n\nChavesNaMão is one of Brazil's busiest property portals, with hundreds of thousands of sale and rental ads in a single city. This actor reads those listings without cookies or login, applies the portal's own filters, walks its result pages, and can open each ad to return the full published details.\n\n## What it collects\n\n- Sale (venda) and rental (aluguel) listings in 17 major Brazilian cities.\n- Structured search by property type, price range, area range, minimum bedrooms, bathrooms and parking spaces, advertiser type and sort order.\n- Every result page, with duplicate listing IDs removed, up to the requested limit.\n- Optional detail enrichment for each listing: full description, publisher name, CRECI and phone, complete photo list, amenities, video and 360° tour links, publication and update dates.\n\nFields are omitted when ChavesNaMão does not publish them for a particular ad. The actor never writes null, empty-string or placeholder values.\n\n## Input defaults\n\n| Input | Default | Notes |\n| --- | --- | --- |\n| `collectionMode` | `listings` | `details` for known ads. |\n| `transactionType` | `sell` | `rent` for aluguel. |\n| `city` | `sao-paulo` | One of 17 built-in city slugs. |\n| `propertyType` | `all` | Every type when not restricted. |\n| `bedroomsMin` | 0 | No minimum. |\n| `bathroomsMin` | 0 | No minimum. |\n| `garagesMin` | 0 | No minimum. |\n| `priceMin` | – | No minimum. |\n| `priceMax` | – | No maximum. |\n| `areaMin` | – | No minimum. |\n| `areaMax` | – | No maximum. |\n| `sortBy` | `relevance` | Site default order. |\n| `ownerType` | `all` | All advertisers. |\n| `maxItems` | 20 | Daily-test prefill uses 3. |\n| `maxPages` | 34 | 30 rows per page. |\n| `includeDetails` | false | One extra request per listing. |\n| `listingUrls` | – | Any ChavesNaMão search URL. |\n| `propertyUrls` | – | Details mode only. |\n| `propertyIds` | – | Details mode only. |\n\n## Collection modes\n\n### Search listings\n\nChoose a transaction, city and any combination of filters. The actor translates them into the same filter syntax the ChavesNaMão website uses, then follows the selected sort order across pages.\n\n| Input | Meaning |\n| --- | --- |\n| `transactionType` | `sell` for venda, `rent` for aluguel. |\n| `city` | One of the 17 built-in city slugs. |\n| `propertyType` | All types or one of apartments, houses, gated houses, kitnets, penthouses, flats, lofts, commercial rooms/houses/points, buildings, warehouses, land, chácaras, farms or garages. |\n| `bedroomsMin`, `bathroomsMin`, `garagesMin` | Minimum room counts. 0 means no minimum. |\n| `priceMin`, `priceMax`, `areaMin`, `areaMax` | Numeric bounds in BRL and square metres. |\n| `sortBy` | Relevance, newest, price ascending/descending, area ascending/descending. |\n| `ownerType` | All advertisers, direct with owner, or agencies only. |\n| `maxItems` | Total listings to save (1–1000). |\n| `maxPages` | Pages to request per search, 30 listings each. |\n| `includeDetails` | Add one detail request per listing for the richer fields. |\n| `listingUrls` | Optional ChavesNaMão search URLs, used verbatim. Any city or neighbourhood reachable on the site can be scraped this way. |\n\n### Property details\n\nSet `collectionMode` to `details` and provide `propertyIds`, `propertyUrls`, or both. Each ad is fetched from ChavesNaMão's detail endpoint and returned once. This is the cheapest way to refresh a known shortlist.\n\n## Output per listing\n\n| Field | Description |\n| --- | --- |\n| `propertyId` | ChavesNaMão listing ID. |\n| `title` | Listing title as published. |\n| `transactionType` | `SELL` or `RENT`. |\n| `price`, `priceCurrency`, `priceDisplay` | Numeric asking price, currency and the original formatted text. |\n| `condominiumFee`, `condominiumFeeValue` | Monthly condominium fee text and numeric value when available. |\n| `iptuValue`, `iptuValueNumeric` | Annual IPTU property-tax text and numeric value when available. |\n| `propertyType`, `propertyTypeId`, `propertyTypeSlug` | Property category. |\n| `bedrooms`, `bedroomsMax` | Bedrooms (minimum and maximum when the ad publishes a range). |\n| `bathrooms`, `bathroomsMax` | Bathrooms. |\n| `suites`, `suitesMax` | En-suite bedrooms. |\n| `garages`, `garagesMax` | Garage or parking spaces. |\n| `commercialRooms`, `commercialRoomsMax` | Commercial rooms when applicable. |\n| `areaSqM`, `usableAreaSqM`, `totalAreaSqM` | Primary, usable and total area in square metres. |\n| `street`, `addressNumber`, `neighborhood`, `neighborhoodId` | Address details. |\n| `city`, `cityId`, `stateAcronym`, `state`, `zipCode` | Location details. |\n| `latitude`, `longitude` | Coordinates when the ad or neighbourhood supplies them. |\n| `publicAddress` | Whether the full street address is public on the ad. |\n| `description` | Full description (HTML stripped, up to 5,000 characters). |\n| `reference` | Advertiser's internal reference code. |\n| `petFriendly`, `acceptTrade`, `active`, `highlighted` | Booleans published by the ad. |\n| `publisherName`, `publisherType`, `publisherCreci`, `publisherVerified` | Advertiser identity. |\n| `publisherPhone`, `publisherWhatsApp`, `publisherUrl` | Advertiser contact details and profile link. |\n| `imageCount`, `featuredImage`, `imageUrls` | Photo count and full-resolution image links. |\n| `videoUrl`, `tour360Url` | Video and virtual-tour links. |\n| `amenities`, `buildingAmenities` | Private and common-area features from the detail page. |\n| `createdAt`, `updatedAt` | Publication and last-update timestamps. |\n| `propertyUrl` | Direct link to the ad. |\n| `scrapedAt` | ISO timestamp of collection. |\n\n## Examples\n\nThree apartments for sale in São Paulo with the daily-test prefill:\n\n```json\n{\n  \"collectionMode\": \"listings\",\n  \"transactionType\": \"sell\",\n  \"city\": \"sao-paulo\",\n  \"maxItems\": 3,\n  \"maxPages\": 1\n}\n```\n\nRentals in Rio de Janeiro between R$ 2,000 and R$ 4,000, at least two bedrooms, newest first, with full details:\n\n```json\n{\n  \"collectionMode\": \"listings\",\n  \"transactionType\": \"rent\",\n  \"city\": \"rio-de-janeiro\",\n  \"bedroomsMin\": 2,\n  \"priceMin\": 2000,\n  \"priceMax\": 4000,\n  \"sortBy\": \"newest\",\n  \"maxItems\": 50,\n  \"includeDetails\": true\n}\n```\n\nHouses for sale in a neighbourhood using the site's own URL:\n\n```json\n{\n  \"collectionMode\": \"listings\",\n  \"listingUrls\": [\"https://www.chavesnamao.com.br/casas-a-venda/sp-sao-paulo/pinheiros/\"],\n  \"maxItems\": 100\n}\n```\n\nFull details for known ads:\n\n```json\n{\n  \"collectionMode\": \"details\",\n  \"propertyUrls\": [\"https://www.chavesnamao.com.br/imovel/apartamento-a-venda-2-quartos-sp-sao-paulo-pinheiros-90m2-RS750000/id-26583048/\"]\n}\n```\n\n## Compatibility with older tasks\n\nOlder tasks that send `mode` as `sell` or `rent`, plus `city` and `maxItems`, keep working: the actor reads those hidden legacy keys and maps them to `transactionType` and listings mode. The schema exposes `collectionMode` for new tasks. Existing output fields are unchanged; the revamp only adds fields beside them.\n\n## FAQ\n\n**Do I need a ChavesNaMão account or cookies?**\nNo. The actor reads the same public pages and JSON endpoints shown to any visitor, with no login, cookie or proxy input.\n\n**Can I search several cities at once?**\nYes. Pass several `listingUrls` (one per city) in a single run. When no URL is supplied, one city is searched from the `city` control.\n\n**How many listings can one search return?**\nChavesNaMão reports hundreds of thousands of ads per large city and currently exposes up to 333 pages (about 10,000 rows) per search. Set `maxItems` and `maxPages` to the depth you need. Larger total volumes are reached by splitting the query with price, area or neighbourhood filters.\n\n**Why are some fields missing from a row?**\nChavesNaMão does not publish every detail for every ad. Empty values are omitted rather than fabricated. Turn on `includeDetails` to fill the detail-only fields for the listings that have them.\n\n**Are condominium fee and IPTU numbers or text?**\nBoth are kept as the original display text (`condominiumFee`, `iptuValue`) and, when parseable, also as numbers (`condominiumFeeValue`, `iptuValueNumeric`).\n\n**What does `publicAddress` mean?**\nWhen true, the ad shows the street and number publicly. When false or absent, the portal hides the exact address even though the neighbourhood is known.\n\n**Is this affiliated with ChavesNaMão?**\nNo. This is an independent data tool and is not affiliated with, endorsed by or sponsored by ChavesNaMão.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "chavesnamao-city-property-listings-extractor",
      "title": "ChavesNaMao City Property Listings Extractor",
      "description": "Search ChavesNaMão sale and rental listings by city, type, price, rooms and area, with sorting and pagination, or fetch full details for known properties.",
      "version": "2.0",
      "buildTag": "latest",
      "dockerfile": "../Dockerfile",
      "readme": "# ChavesNaMao City Property Listings Extractor\n\nChavesNaMão is one of Brazil's busiest property portals, with hundreds of thousands of sale and rental ads in a single city. This actor reads those listings without cookies or login, applies the portal's own filters, walks its result pages, and can open each ad to return the full published details.\n\n## What it collects\n\n- Sale (venda) and rental (aluguel) listings in 17 major Brazilian cities.\n- Structured search by property type, price range, area range, minimum bedrooms, bathrooms and parking spaces, advertiser type and sort order.\n- Every result page, with duplicate listing IDs removed, up to the requested limit.\n- Optional detail enrichment for each listing: full description, publisher name, CRECI and phone, complete photo list, amenities, video and 360° tour links, publication and update dates.\n\nFields are omitted when ChavesNaMão does not publish them for a particular ad. The actor never writes null, empty-string or placeholder values.\n\n## Input defaults\n\n| Input | Default | Notes |\n| --- | --- | --- |\n| `collectionMode` | `listings` | `details` for known ads. |\n| `transactionType` | `sell` | `rent` for aluguel. |\n| `city` | `sao-paulo` | One of 17 built-in city slugs. |\n| `propertyType` | `all` | Every type when not restricted. |\n| `bedroomsMin` | 0 | No minimum. |\n| `bathroomsMin` | 0 | No minimum. |\n| `garagesMin` | 0 | No minimum. |\n| `priceMin` | – | No minimum. |\n| `priceMax` | – | No maximum. |\n| `areaMin` | – | No minimum. |\n| `areaMax` | – | No maximum. |\n| `sortBy` | `relevance` | Site default order. |\n| `ownerType` | `all` | All advertisers. |\n| `maxItems` | 20 | Daily-test prefill uses 3. |\n| `maxPages` | 34 | 30 rows per page. |\n| `includeDetails` | false | One extra request per listing. |\n| `listingUrls` | – | Any ChavesNaMão search URL. |\n| `propertyUrls` | – | Details mode only. |\n| `propertyIds` | – | Details mode only. |\n\n## Collection modes\n\n### Search listings\n\nChoose a transaction, city and any combination of filters. The actor translates them into the same filter syntax the ChavesNaMão website uses, then follows the selected sort order across pages.\n\n| Input | Meaning |\n| --- | --- |\n| `transactionType` | `sell` for venda, `rent` for aluguel. |\n| `city` | One of the 17 built-in city slugs. |\n| `propertyType` | All types or one of apartments, houses, gated houses, kitnets, penthouses, flats, lofts, commercial rooms/houses/points, buildings, warehouses, land, chácaras, farms or garages. |\n| `bedroomsMin`, `bathroomsMin`, `garagesMin` | Minimum room counts. 0 means no minimum. |\n| `priceMin`, `priceMax`, `areaMin`, `areaMax` | Numeric bounds in BRL and square metres. |\n| `sortBy` | Relevance, newest, price ascending/descending, area ascending/descending. |\n| `ownerType` | All advertisers, direct with owner, or agencies only. |\n| `maxItems` | Total listings to save (1–1000). |\n| `maxPages` | Pages to request per search, 30 listings each. |\n| `includeDetails` | Add one detail request per listing for the richer fields. |\n| `listingUrls` | Optional ChavesNaMão search URLs, used verbatim. Any city or neighbourhood reachable on the site can be scraped this way. |\n\n### Property details\n\nSet `collectionMode` to `details` and provide `propertyIds`, `propertyUrls`, or both. Each ad is fetched from ChavesNaMão's detail endpoint and returned once. This is the cheapest way to refresh a known shortlist.\n\n## Output per listing\n\n| Field | Description |\n| --- | --- |\n| `propertyId` | ChavesNaMão listing ID. |\n| `title` | Listing title as published. |\n| `transactionType` | `SELL` or `RENT`. |\n| `price`, `priceCurrency`, `priceDisplay` | Numeric asking price, currency and the original formatted text. |\n| `condominiumFee`, `condominiumFeeValue` | Monthly condominium fee text and numeric value when available. |\n| `iptuValue`, `iptuValueNumeric` | Annual IPTU property-tax text and numeric value when available. |\n| `propertyType`, `propertyTypeId`, `propertyTypeSlug` | Property category. |\n| `bedrooms`, `bedroomsMax` | Bedrooms (minimum and maximum when the ad publishes a range). |\n| `bathrooms`, `bathroomsMax` | Bathrooms. |\n| `suites`, `suitesMax` | En-suite bedrooms. |\n| `garages`, `garagesMax` | Garage or parking spaces. |\n| `commercialRooms`, `commercialRoomsMax` | Commercial rooms when applicable. |\n| `areaSqM`, `usableAreaSqM`, `totalAreaSqM` | Primary, usable and total area in square metres. |\n| `street`, `addressNumber`, `neighborhood`, `neighborhoodId` | Address details. |\n| `city`, `cityId`, `stateAcronym`, `state`, `zipCode` | Location details. |\n| `latitude`, `longitude` | Coordinates when the ad or neighbourhood supplies them. |\n| `publicAddress` | Whether the full street address is public on the ad. |\n| `description` | Full description (HTML stripped, up to 5,000 characters). |\n| `reference` | Advertiser's internal reference code. |\n| `petFriendly`, `acceptTrade`, `active`, `highlighted` | Booleans published by the ad. |\n| `publisherName`, `publisherType`, `publisherCreci`, `publisherVerified` | Advertiser identity. |\n| `publisherPhone`, `publisherWhatsApp`, `publisherUrl` | Advertiser contact details and profile link. |\n| `imageCount`, `featuredImage`, `imageUrls` | Photo count and full-resolution image links. |\n| `videoUrl`, `tour360Url` | Video and virtual-tour links. |\n| `amenities`, `buildingAmenities` | Private and common-area features from the detail page. |\n| `createdAt`, `updatedAt` | Publication and last-update timestamps. |\n| `propertyUrl` | Direct link to the ad. |\n| `scrapedAt` | ISO timestamp of collection. |\n\n## Examples\n\nThree apartments for sale in São Paulo with the daily-test prefill:\n\n```json\n{\n  \"collectionMode\": \"listings\",\n  \"transactionType\": \"sell\",\n  \"city\": \"sao-paulo\",\n  \"maxItems\": 3,\n  \"maxPages\": 1\n}\n```\n\nRentals in Rio de Janeiro between R$ 2,000 and R$ 4,000, at least two bedrooms, newest first, with full details:\n\n```json\n{\n  \"collectionMode\": \"listings\",\n  \"transactionType\": \"rent\",\n  \"city\": \"rio-de-janeiro\",\n  \"bedroomsMin\": 2,\n  \"priceMin\": 2000,\n  \"priceMax\": 4000,\n  \"sortBy\": \"newest\",\n  \"maxItems\": 50,\n  \"includeDetails\": true\n}\n```\n\nHouses for sale in a neighbourhood using the site's own URL:\n\n```json\n{\n  \"collectionMode\": \"listings\",\n  \"listingUrls\": [\"https://www.chavesnamao.com.br/casas-a-venda/sp-sao-paulo/pinheiros/\"],\n  \"maxItems\": 100\n}\n```\n\nFull details for known ads:\n\n```json\n{\n  \"collectionMode\": \"details\",\n  \"propertyUrls\": [\"https://www.chavesnamao.com.br/imovel/apartamento-a-venda-2-quartos-sp-sao-paulo-pinheiros-90m2-RS750000/id-26583048/\"]\n}\n```\n\n## Compatibility with older tasks\n\nOlder tasks that send `mode` as `sell` or `rent`, plus `city` and `maxItems`, keep working: the actor reads those hidden legacy keys and maps them to `transactionType` and listings mode. The schema exposes `collectionMode` for new tasks. Existing output fields are unchanged; the revamp only adds fields beside them.\n\n## FAQ\n\n**Do I need a ChavesNaMão account or cookies?**\nNo. The actor reads the same public pages and JSON endpoints shown to any visitor, with no login, cookie or proxy input.\n\n**Can I search several cities at once?**\nYes. Pass several `listingUrls` (one per city) in a single run. When no URL is supplied, one city is searched from the `city` control.\n\n**How many listings can one search return?**\nChavesNaMão reports hundreds of thousands of ads per large city and currently exposes up to 333 pages (about 10,000 rows) per search. Set `maxItems` and `maxPages` to the depth you need. Larger total volumes are reached by splitting the query with price, area or neighbourhood filters.\n\n**Why are some fields missing from a row?**\nChavesNaMão does not publish every detail for every ad. Empty values are omitted rather than fabricated. Turn on `includeDetails` to fill the detail-only fields for the listings that have them.\n\n**Are condominium fee and IPTU numbers or text?**\nBoth are kept as the original display text (`condominiumFee`, `iptuValue`) and, when parseable, also as numbers (`condominiumFeeValue`, `iptuValueNumeric`).\n\n**What does `publicAddress` mean?**\nWhen true, the ad shows the street and number publicly. When false or absent, the portal hides the exact address even though the neighbourhood is known.\n\n**Is this affiliated with ChavesNaMão?**\nNo. This is an independent data tool and is not affiliated with, endorsed by or sponsored by ChavesNaMão.\n",
      "input": {
        "title": "ChavesNaMão City Property Listings Extractor",
        "description": "Scrape sale and rental property listings from ChavesNaMão with city, price, room, area, type and sorting filters, or fetch full details for known listings.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "collectionMode": {
            "title": "What to collect",
            "type": "string",
            "description": "Search listings by city and filters, or fetch full details for specific ChavesNaMão listings.",
            "editor": "select",
            "enum": [
              "listings",
              "details"
            ],
            "enumTitles": [
              "Search listings",
              "Property details"
            ],
            "default": "listings",
            "prefill": "listings",
            "sectionCaption": "Collection mode"
          },
          "transactionType": {
            "title": "Sale or rent",
            "type": "string",
            "description": "Whether to search properties for sale (venda) or for rent (aluguel).",
            "editor": "select",
            "enum": [
              "sell",
              "rent"
            ],
            "enumTitles": [
              "For sale (Venda)",
              "For rent (Aluguel)"
            ],
            "default": "sell",
            "prefill": "sell"
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "Brazilian city to search in listings mode. For any other city, paste one of its ChavesNaMão search URLs into Listing URLs.",
            "editor": "select",
            "enum": [
              "sao-paulo",
              "rio-de-janeiro",
              "belo-horizonte",
              "porto-alegre",
              "curitiba",
              "brasilia",
              "salvador",
              "fortaleza",
              "recife",
              "campinas",
              "manaus",
              "belem",
              "goiania",
              "florianopolis",
              "vitoria",
              "praia-grande",
              "joao-pessoa"
            ],
            "enumTitles": [
              "São Paulo",
              "Rio de Janeiro",
              "Belo Horizonte",
              "Porto Alegre",
              "Curitiba",
              "Brasília",
              "Salvador",
              "Fortaleza",
              "Recife",
              "Campinas",
              "Manaus",
              "Belém",
              "Goiânia",
              "Florianópolis",
              "Vitória",
              "Praia Grande",
              "João Pessoa"
            ],
            "default": "sao-paulo",
            "prefill": "sao-paulo"
          },
          "propertyType": {
            "title": "Property type",
            "type": "string",
            "description": "Restrict the search to one property type, or search every type.",
            "editor": "select",
            "enum": [
              "all",
              "apartments",
              "houses",
              "gated-houses",
              "kitnets",
              "penthouses",
              "flats",
              "lofts",
              "commercial-rooms",
              "commercial-houses",
              "commercial-points",
              "buildings",
              "warehouses",
              "land",
              "gated-land",
              "commercial-land",
              "farms",
              "rural-farms",
              "garages"
            ],
            "enumTitles": [
              "All property types",
              "Apartments",
              "Houses and townhouses",
              "Houses in gated communities",
              "Kitnets",
              "Penthouses",
              "Flats",
              "Lofts",
              "Commercial rooms",
              "Commercial houses",
              "Commercial points",
              "Buildings",
              "Warehouses",
              "Land",
              "Land in gated communities",
              "Commercial land",
              "Chácaras",
              "Farms",
              "Garages"
            ],
            "default": "all",
            "sectionCaption": "Listing filters",
            "sectionDescription": "These filters apply when mode is Search listings. Any value left at zero or empty is not sent to ChavesNaMão."
          },
          "bedroomsMin": {
            "title": "Minimum bedrooms",
            "type": "integer",
            "description": "Minimum number of bedrooms (quartos). Use 0 for no minimum.",
            "minimum": 0,
            "maximum": 20,
            "default": 0
          },
          "bathroomsMin": {
            "title": "Minimum bathrooms",
            "type": "integer",
            "description": "Minimum number of bathrooms (banheiros). Use 0 for no minimum.",
            "minimum": 0,
            "maximum": 20,
            "default": 0
          },
          "garagesMin": {
            "title": "Minimum parking spaces",
            "type": "integer",
            "description": "Minimum number of garage or parking spaces (vagas). Use 0 for no minimum.",
            "minimum": 0,
            "maximum": 20,
            "default": 0
          },
          "priceMin": {
            "title": "Minimum price (BRL)",
            "type": "integer",
            "description": "Minimum asking price in Brazilian reais. Leave empty for no minimum.",
            "minimum": 0,
            "maximum": 1000000000
          },
          "priceMax": {
            "title": "Maximum price (BRL)",
            "type": "integer",
            "description": "Maximum asking price in Brazilian reais. Leave empty for no maximum.",
            "minimum": 0,
            "maximum": 1000000000
          },
          "areaMin": {
            "title": "Minimum area (m²)",
            "type": "integer",
            "description": "Minimum usable area in square metres. Leave empty for no minimum.",
            "minimum": 0,
            "maximum": 1000000
          },
          "areaMax": {
            "title": "Maximum area (m²)",
            "type": "integer",
            "description": "Maximum usable area in square metres. Leave empty for no maximum.",
            "minimum": 0,
            "maximum": 1000000
          },
          "sortBy": {
            "title": "Sort order",
            "type": "string",
            "description": "Order of the listing results.",
            "editor": "select",
            "enum": [
              "relevance",
              "newest",
              "priceAsc",
              "priceDesc",
              "areaAsc",
              "areaDesc"
            ],
            "enumTitles": [
              "Relevance (site default)",
              "Newest first",
              "Lowest price first",
              "Highest price first",
              "Smallest area first",
              "Largest area first"
            ],
            "default": "relevance"
          },
          "ownerType": {
            "title": "Advertiser",
            "type": "string",
            "description": "Show every advertiser, only listings direct from the owner, or only real-estate agencies.",
            "editor": "select",
            "enum": [
              "all",
              "owner",
              "agency"
            ],
            "enumTitles": [
              "All advertisers",
              "Direct with owner",
              "Real-estate agencies only"
            ],
            "default": "all"
          },
          "maxItems": {
            "title": "Maximum listings",
            "type": "integer",
            "description": "Maximum number of listings to save across all selected searches (1–1000).",
            "minimum": 1,
            "maximum": 1000,
            "default": 20,
            "prefill": 3,
            "sectionCaption": "Result limits"
          },
          "maxPages": {
            "title": "Maximum pages per search",
            "type": "integer",
            "description": "Maximum result pages to request for each search (30 listings per page). Stops earlier when the source runs out.",
            "minimum": 1,
            "maximum": 100,
            "default": 34,
            "prefill": 1
          },
          "includeDetails": {
            "title": "Fetch full details",
            "type": "boolean",
            "description": "Fetch each listing's detail page data: full description, publisher phone and CRECI, photo list, amenities, video and tour links, created and updated dates. Costs one extra request per listing.",
            "default": false,
            "prefill": false
          },
          "listingUrls": {
            "title": "Listing URLs",
            "type": "array",
            "description": "Optional ChavesNaMão search URLs to scrape exactly as configured on the site. Use this for cities, neighbourhoods or filter combinations not covered by the controls above.",
            "editor": "stringList",
            "items": {
              "type": "string"
            },
            "sectionCaption": "Advanced"
          },
          "propertyUrls": {
            "title": "Property detail URLs",
            "type": "array",
            "description": "ChavesNaMão property URLs to fetch in details mode (they contain an id-<number> segment).",
            "editor": "stringList",
            "items": {
              "type": "string"
            }
          },
          "propertyIds": {
            "title": "Property IDs",
            "type": "array",
            "description": "ChavesNaMão listing IDs to fetch in details mode. Property URLs also work.",
            "editor": "stringList",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "ChavesNaMão City Property Listings Extractor Output",
        "description": "ChavesNaMão property listings with price, condominium fee, IPTU, rooms, area, address, coordinates, publisher contact and optional full details.",
        "properties": {
          "listings": {
            "type": "string",
            "title": "Property listings",
            "description": "Dataset containing every scraped ChavesNaMão property listing.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Property Listings",
              "transformation": {
                "fields": [
                  "title",
                  "price",
                  "priceCurrency",
                  "propertyType",
                  "bedrooms",
                  "areaSqM",
                  "neighborhood",
                  "city",
                  "stateAcronym",
                  "publisherName",
                  "propertyUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "2.0.1",
    "imageDigest": "f6f5f51e0076e8cdd9f4fc15853fe8ab96c9730b14584d5a6a671e313f7e46af",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "2.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.0035366666666666667
    }
  }
}