Busca propriedades do cliente aplicando filtros e retorna os IDs correspondentes junto com agregações (quantidade de propriedades por operação, tipo, zona, moeda e faixa de preço). É pensado para o fluxo guiado do chat: permite mostrar contagens como "Venda (150) · Aluguel (75)" sem gastar tokens de IA, e sem trazer o detalhe completo de cada propriedade.

customerId é resolvido a partir do access token. Para obter o detalhe das propriedades encontradas, pegue os propertyIds da resposta e consulte GET /api/action/mapaprop-chat-ai-v1/properties (unindo os IDs com vírgula).

URL do recurso

https://mapaprop.app/api/action/mapaprop-chat-ai-v1/search

Parâmetros

Somente são buscadas propriedades publicadas da conta autenticada. A busca sempre limita a um máximo de 100 resultados internamente (não é paginável a partir deste endpoint; para percorrer resultados em páginas, use os propertyIds retornados junto com properties).

Código de exemplo

GET /api/action/mapaprop-chat-ai-v1/search?operation=1&type=1&zone1=1&priceMin=50000&priceMax=300000&currency=USD HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}

Resposta

Exemplo de resposta

{
    "total": 18,
    "propertyIds": [2600144, 2600145, 2600150, 2600151],
    "aggregations": {
        "operations": [
            { "id": 1, "description": "Venta", "count": 18 }
        ],
        "types": [
            { "id": 1, "description": "Departamento", "count": 12 },
            { "id": 2, "description": "Casa", "count": 6 }
        ],
        "states": [
            { "id": 1, "count": 18 }
        ],
        "counties": [
            { "id": 46, "count": 10 }
        ],
        "cities": [],
        "currencies": [
            { "currency": "USD", "count": 18, "priceMin": 55000, "priceMax": 295000, "priceAvg": 165000 }
        ],
        "priceRanges": [
            { "currency": "USD", "label": "50000-100000", "count": 5, "from": 50000, "to": 100000 },
            { "currency": "USD", "label": "100000-300000", "count": 13, "from": 100000, "to": 300000 }
        ]
    }
}