GET /api/action/mapaprop-chat-ai-v1/featureds

BETA

Devuelve las propiedades destacadas configuradas en el sitio web del cliente. customerId y websiteId se resuelven del access token.

Información del recurso
Autenticación	Requerida (Token de API, Bearer)
HTTP Method	GET
Response	JSON
Version	1
Cache	1 hora

URL del recurso

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

Parámetros

Key	Type	Required	Descripción
max	int	no	Cantidad máxima de destacados a devolver. Por defecto `150`

Código de ejemplo

GET /api/action/mapaprop-chat-ai-v1/featureds?max=10 HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}

Respuesta

Objeto	Campo	Tipo	Requerido	Descripción
Response	featureds	Array of Featured	yes	Propiedades destacadas del sitio web
Featured	featuredId	int	yes	ID del registro de destacado
	propertyId	int	yes	ID de la propiedad
	code	string	yes	Código de la propiedad, con prefijo de cuenta (ej: `11099-casas236516`)
	seoUrl	string	yes	Ruta SEO de la propiedad
	title	string	yes	Título de la propiedad
	description	string	yes	Descripción de la propiedad
	typeDesc	string	yes	Descripción traducida del tipo de propiedad
	propertyTypeDesc	string	yes	Descripción traducida del tipo de propiedad (alias de `typeDesc`)
	operationDesc	string	yes	Descripción traducida de la operación
	propertyOperationDesc	string	yes	Descripción traducida de la operación (alias de `operationDesc`)
	showPrice	boolean	yes	Si el cliente decidió mostrar el precio de esta propiedad destacada
	price	number	yes	Precio de la propiedad
	currency	string	yes	Moneda del precio
	occupancy	int	no	Cantidad máxima de ocupantes (alquiler temporal)
	ambiences	int	no	Cantidad de ambientes
	rooms	int	no	Cantidad de dormitorios
	bathrooms	int	no	Cantidad de baños (solo si está declarada)
	buildingArea	int	no	Superficie cubierta en m² (solo si está declarada)
	landArea	int	no	Superficie de terreno en m² (solo si está declarada)
	sold	boolean	no	Presente solo si la propiedad está marcada como vendida
	rented	boolean	no	Presente solo si la propiedad está marcada como alquilada
	suspended	boolean	no	Presente solo si la publicación está suspendida
	reserved	boolean	no	Presente solo si la propiedad está reservada
	address	string	no	Dirección de la propiedad
	addressDesc	string	no	Combinación de provincia, partido y ciudad (según disponibilidad)
	zone1	string	no	Nombre de la provincia
	zone2	string	no	Nombre del partido/barrio
	zone3	string	no	Nombre de la ciudad
	thumbnail	string	yes	URL completa de la imagen thumbnail
	customerCountryDesc	string	yes	Nombre del país de la cuenta del cliente

Ejemplo de respuesta

{
    "featureds": [
        {
            "featuredId": 40063,
            "propertyId": 2600144,
            "code": "11099-casas236516",
            "seoUrl": "venta-de-departamento-en-palermo-capital-federal-11099-2600144",
            "title": "Departamento 2 ambientes en Palermo",
            "description": "Excelente departamento a estrenar...",
            "typeDesc": "Departamento",
            "propertyTypeDesc": "Departamento",
            "operationDesc": "Venta",
            "propertyOperationDesc": "Venta",
            "showPrice": true,
            "price": 210000,
            "currency": "USD",
            "ambiences": 2,
            "rooms": 2,
            "addressDesc": "Palermo,Capital Federal",
            "zone1": "Capital Federal",
            "zone2": "Palermo",
            "thumbnail": "https://s3.amazonaws.com/mapaprop-dev-image/photos/11099/2600144/1t.jpg",
            "customerCountryDesc": "Argentina"
        }
    ]
}