Skip to content
PT Start free

// docs

Chaves na Mão: Get listing details

Extracts detailed data from a real estate listing from Chaves na Mão using the property's public URL.

chavesnamao.com.br:pdp · 1 credit per request

Standard credit cost. Your account pricing is shown in the sandbox.

Try this operation in the sandbox

HTTP request

cURL 
curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "chavesnamao.com.br",
  "type": "pdp",
  "url": "https://www.chavesnamao.com.br/imovel/apartamento-a-venda-4-quartos-com-garagem-sc-balneario-picarras-centro-496m2-RS5990000/id-29279133/"
}'

Keep your API key on your server. See the quickstart for authentication and response handling.

MCP request

The hosted MCP tool fixes target and type for this operation. Its remaining arguments use the same input rules as Extract.

POST /v1/mcp · Bearer or X-API-Key authentication

chavesnamao_com_br_pdp · tools/call 
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "chavesnamao_com_br_pdp",
    "arguments": {
      "url": "https://www.chavesnamao.com.br/imovel/apartamento-a-venda-4-quartos-com-garagem-sc-balneario-picarras-centro-496m2-RS5990000/id-29279133/",
      "executionId": "exec_example_123"
    }
  }
}

Supported inputs

Conditional fields depend on the alternatives and constraints in the rule column. Fields marked unsupported are omitted.

FieldTypeRequirementRuleDefaultExample
url
URL extraction target. For some PLPs it can be omitted when API assembles URL from other fields.
 string (URL) Required URL public ad in domain chavesnamao.com.br. The worker extracts listingId from segment `/id-<numero>/`. - https://www.chavesnamao.com.br/imovel/apartamento-a-venda-4-quartos-com-garagem-sc-balneario-picarras-centro-496m2-RS5990000/id-29279133/
target
Target source for extraction.
 enum Required Always required and must be chavesnamao.com.br. - chavesnamao.com.br
type
Extraction type: pdp, idp, plp, ilp, quote, review or places.
 enum Required Always required and must be pdp. - pdp

Request examples

PDP by public URL

Send ad public URL. The worker validates the page against the chavesnamao.com.br domain and resolves listingId to the internal details endpoint.

PDP by public URL 
{
  "target": "chavesnamao.com.br",
  "type": "pdp",
  "url": "https://www.chavesnamao.com.br/imovel/apartamento-a-venda-4-quartos-com-garagem-sc-balneario-picarras-centro-496m2-RS5990000/id-29279133/"
}

Response schema

Leaf paths and expected types. Field names and enum values are part of the API contract.

responseSchema 
{
  "source": "\"chavesnamao.com.br\"",
  "type": "\"pdp\"",
  "parser": "\"1.0.0\"",
  "requestUrl": "string",
  "apiUrl": "string",
  "extractedAt": "string (ISO datetime)",
  "data": "object"
}

Example response

Illustrative response. Product names, reviews and other source content retain their original language. Missing and null values do not imply zero stock, free shipping or zero reviews.

responseExample 
{
  "source": "chavesnamao.com.br",
  "type": "pdp",
  "parser": "1.0.0",
  "requestUrl": "https://www.chavesnamao.com.br/imovel/apartamento-a-venda-4-quartos-com-garagem-sc-balneario-picarras-centro-496m2-RS5990000/id-29279133/",
  "apiUrl": "https://www.chavesnamao.com.br/api/realestate/details/?id=29279133",
  "extractedAt": "2026-04-14T14:30:00.000Z",
  "data": {
    "url": "https://www.chavesnamao.com.br/imovel/apartamento-a-venda-4-quartos-com-garagem-sc-balneario-picarras-centro-496m2-RS5990000/id-29279133/",
    "listingId": "29279133",
    "title": "Apartamento com 4 quartos à venda na Avenida Nereu Ramos, 2310, Centro, Balneário Piçarras",
    "metaTitle": "Apartamento em Balneário Piçarras",
    "metaDescription": "Descrição meta do imóvel.",
    "description": "Descrição completa do anúncio.",
    "reference": "RS5990000",
    "category": "residential",
    "businessType": "sale",
    "transaction": "SELL",
    "realtyType": {
      "id": 1,
      "name": "Apartamento",
      "pluralName": "Apartamentos",
      "slug": "apartamentos",
      "prefix": "deste"
    },
    "prices": {
      "main": "R$ 5.990.000",
      "rawPrice": 5990000,
      "maxPrice": 5990000,
      "condominiumFee": 0,
      "iptuValue": 0
    },
    "area": {
      "useful": 496,
      "usefulMax": 496,
      "total": 496,
      "totalMax": 496
    },
    "counts": {
      "bedrooms": {
        "count": 4,
        "max": 4
      },
      "bathrooms": {
        "count": 5,
        "max": 5
      },
      "suites": {
        "count": 2,
        "max": 2
      },
      "garages": {
        "count": 3,
        "max": 3
      },
      "commercialRooms": {
        "count": 0,
        "max": 0
      }
    },
    "address": {
      "street": "Avenida Nereu Ramos, 2310",
      "neighborhood": "Centro",
      "city": "Balneário Piçarras",
      "state": "SC",
      "zipCode": "88380-000",
      "addressComplement": "",
      "publicAddress": true,
      "latitude": -26.7403845,
      "longitude": -48.6810012
    },
    "advertiser": {
      "id": "602848",
      "name": "TOLENTINO IMÓVEIS",
      "url": "https://www.chavesnamao.com.br/imobiliaria/tolentino-imoveis/id-602848/",
      "type": "PJ",
      "category": 0,
      "contractDate": "2024-07-30T03:00:00.000Z",
      "creci": "J-0000",
      "stockCount": 48,
      "logoUrl": "https://www.chavesnamao.com.br/imn/0850x0450/N/60/imoveis/logo-tolentino.png",
      "phones": {
        "cellphone": "(47) 99999-0000",
        "landline": "(47) 3344-5500",
        "commercial": "(47) 3344-5501",
        "public": true
      },
      "address": {
        "city": "Balneário Piçarras",
        "state": "SC"
      }
    },
    "images": [
      "https://www.chavesnamao.com.br/imn/0850x0450/N/60/imoveis/602848/29279133/sc-balneario-picarras-centro-avenida-nereu-ramos-apartamento-a-venda-4-quartos-01.jpg"
    ],
    "featuredImage": "https://www.chavesnamao.com.br/imn/0850x0450/N/60/imoveis/602848/29279133/sc-balneario-picarras-centro-avenida-nereu-ramos-apartamento-a-venda-4-quartos-01.jpg",
    "imageCount": 15,
    "privativeAmenities": [
      "Varanda gourmet",
      "Churrasqueira"
    ],
    "commonAmenities": [
      "Piscina",
      "Academia"
    ],
    "proximities": {
      "schools": [
        "Escola Exemplo"
      ]
    },
    "gmb": {
      "totalReviews": 29,
      "rating": 5,
      "url": "https://www.google.com/maps?cid=123"
    },
    "media": {
      "videoUrl": "",
      "tour360": ""
    },
    "acceptTrade": true,
    "acceptTrades": true,
    "petFriendly": false,
    "highlighted": false,
    "active": true,
    "updatedAt": "2026-04-14T00:00:00.000Z",
    "status": "ACTIVE",
    "score": 9.3,
    "launchStatus": ""
  }
}

Complete field reference

PathTypeDescriptionExample
apiUrl string URL from the internal endpoint `/api/realestate/details/` used to get the structured JSON of the ad. https://www.chavesnamao.com.br/api/realestate/details/?id=29279133
data object Standardized detailed real estate ad payload. {"url":"https://www.chavesnamao.com.br/imovel/apartamento-a-venda-4-quartos-com-garagem-sc-balneario-picarras-centro-496m2-RS5990000/id-29279133/","listingId":"29279133","title":"Apartamento com 4 quartos à venda na Avenida Nereu Ramos, 2310, Centro, Balneário Piçarras","metaTitle":"Apartamento em Balneário Piçarras","metaDescription":"Descrição meta do imóvel.","description":"Descrição completa do anúncio.","reference":"RS5990000","category":"residential","businessType":"sale","transaction":"SELL","realtyType":{"id":1,"name":"Apartamento","pluralName":"Apartamentos","slug":"apartamentos","prefix":"deste"},"prices":{"main":"R$ 5.990.000","rawPrice":5990000,"maxPrice":5990000,"condominiumFee":0,"iptuValue":0},"area":{"useful":496,"usefulMax":496,"total":496,"totalMax":496},"counts":{"bedrooms":{"count":4,"max":4},"bathrooms":{"count":5,"max":5},"suites":{"count":2,"max":2},"garages":{"count":3,"max":3},"commercialRooms":{"count":0,"max":0}},"address":{"street":"Avenida Nereu Ramos, 2310","neighborhood":"Centro","city":"Balneário Piçarras","state":"SC","zipCode":"88380-000","addressComplement":"","publicAddress":true,"latitude":-26.7403845,"longitude":-48.6810012},"advertiser":{"id":"602848","name":"TOLENTINO IMÓVEIS","url":"https://www.chavesnamao.com.br/imobiliaria/tolentino-imoveis/id-602848/","type":"PJ","category":0,"contractDate":"2024-07-30T03:00:00.000Z","creci":"J-0000","stockCount":48,"logoUrl":"https://www.chavesnamao.com.br/imn/0850x0450/N/60/imoveis/logo-tolentino.png","phones":{"cellphone":"(47) 99999-0000","landline":"(47) 3344-5500","commercial":"(47) 3344-5501","public":true},"address":{"city":"Balneário Piçarras","state":"SC"}},"images":["https://www.chavesnamao.com.br/imn/0850x0450/N/60/imoveis/602848/29279133/sc-balneario-picarras-centro-avenida-nereu-ramos-apartamento-a-venda-4-quartos-01.jpg"],"featuredImage":"https://www.chavesnamao.com.br/imn/0850x0450/N/60/imoveis/602848/29279133/sc-balneario-picarras-centro-avenida-nereu-ramos-apartamento-a-venda-4-quartos-01.jpg","imageCount":15,"privativeAmenities":["Varanda gourmet","Churrasqueira"],"commonAmenities":["Piscina","Academia"],"proximities":{"schools":["Escola Exemplo"]},"gmb":{"totalReviews":29,"rating":5,"url":"https://www.google.com/maps?cid=123"},"media":{"videoUrl":"","tour360":""},"acceptTrade":true,"acceptTrades":true,"petFriendly":false,"highlighted":false,"active":true,"updatedAt":"2026-04-14T00:00:00.000Z","status":"ACTIVE","score":9.3,"launchStatus":""}
extractedAt string (ISO datetime) Timestamp ISO UTC when the extraction was completed. 2026-04-14T14:30:00.000Z
parser "1.0.0" Stable version of the API response format. 1.0.0
requestUrl string Same value as `data.url`; never exposes the queried internal endpoint. https://www.chavesnamao.com.br/imovel/apartamento-a-venda-4-quartos-com-garagem-sc-balneario-picarras-centro-496m2-RS5990000/id-29279133/
source "chavesnamao.com.br" Fixed identifier of the extracted source. chavesnamao.com.br
type "pdp" Type of extraction performed: pdp. pdp

Errors and missing data

When supported by this operation, an entity not found upstream can return HTTP 200 with data: null and notFound: true. Check the documented response fields before interpreting an empty result. Source-specific behavior and exceptions are described above.

HTTP statusError codeMeaning
400INVALID_PAYLOADInvalid JSON or a request that violates the documented validation rules.
401UNAUTHORIZEDMissing authorization or an invalid API key or token.
402INSUFFICIENT_CREDITSThe account has insufficient credits for this operation.
403FORBIDDENThe account does not have access, or the API is temporarily disabled.
409EXECUTION_CONFLICTThe execution identifier conflicts with an incompatible execution state.
429RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTSA rate limit or simultaneous request limit was exceeded.
5xxUPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_FUNCTION_ERRORAn upstream, worker or gateway failure. Failed requests follow the platform refund policy.

Other Chaves na Mão operations