Documentación del uso de la API
Conoce como usar la API de Top Propiedades en sistemas externos.
Para interactuar con la API debes tener una cuenta en el Plan Web o Plan Corredor de esta manera puedes obtener el token privado necesario para realizar las consultas a los endpoints disponibles.
Si no tienes tu cuenta puedes crear una aquí, si ya tienes una cuenta puedes acceder aquí.
Primeros pasos con la API
Accede a tu intranet con tu usuario y contraseña (debes ser usuario administrador de la cuenta) y ubica en la configuración de la cuenta el token de tu corredora, con el podrás validarte frente al sistema y realizar las peticiones o consultas a la API.
En cada solicitud a la API, debes incluir tu token en el encabezado (header) de la petición, utilizando el formato Authorization: Bearer {token}.
Importante: considera utilizar metodos de cache y/o llamadas por períodos para evitar bloqueos.
curl -X GET "https://api.toppropiedades.cl/v1/{endpoint}" \
-H "Authorization: Bearer {token}"
Consultas generales
Consulta de operaciones
Podrás consultar por todas las operaciones disponibles o por una operación en particular, el resultado de la consulta será en formato json.
Consulta por todas las operaciones:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
GET: https://api.toppropiedades.cl/v1/operaciones
Resultado json esperado:
[
{
"id_operacion": "1",
"operacion": "Arriendo",
"url": "arriendo"
},
{
"id_operacion": "2",
"operacion": "Venta",
"url": "venta"
},
{
"id_operacion": "3",
"operacion": "Arriendo Diario",
"url": "arriendo-diario"
}
]
Consulta por una operación:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
| id | GET | Int | Con el valor numérico de id_operacion |
GET: https://api.toppropiedades.cl/v1/operaciones?id={parametro}
Resultado json esperado:
{
"id_operacion": "2",
"operacion": "Venta",
"url": "venta"
}
Consulta de categorías
Podrás consultar por todas las categorías disponibles o por una categoría en particular, el resultado de la consulta será en formato json.
Consulta por todas las categorías:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
GET: https://api.toppropiedades.cl/v1/categorias
Resultado json esperado:
[
{
"id_categoria": "3",
"categoria": "Oficina",
"url": "oficina"
},
{
"id_categoria": "4",
"categoria": "Local Comercial",
"url": "local-comercial"
},
{
"id_categoria": "13",
"categoria": "Bodega",
"url": "bodega"
},
{
"id_categoria": "16",
"categoria": "Casa",
"url": "casa"
},
{
"id_categoria": "17",
"categoria": "Departamento",
"url": "departamento"
},
{
"id_categoria": "25",
"categoria": "Parcela",
"url": "parcela"
},
...
]
Consulta por una categoría:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
| id | GET | Int | Con el valor numérico de id_categoria |
GET: https://api.toppropiedades.cl/v1/categorias?id={parametro}
Resultado json esperado:
{
"id_categoria": "17",
"categoria": "Departamento",
"url": "departamento"
}
Consulta de ubicación (regiones y ciudades)
Podrás consultar por todas las ciudades disponibles o por una ciudad en particular, el resultado de la consulta será en formato json.
Consulta por todas las ubicaciones:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
GET: https://api.toppropiedades.cl/v1/ubicaciones
Resultado json esperado:
[
{
"id_ciudad": "8",
"id_region": "2",
"ciudad": "Antofagasta",
"region": "Región de Antofagasta",
"latitud": "-23.64637410",
"longitud": "-70.39800330"
},
{
"id_ciudad": "9",
"id_region": "2",
"ciudad": "Calama",
"region": "Región de Antofagasta",
"latitud": "-22.46239170",
"longitud": "-68.92721810"
},
{
"id_ciudad": "10",
"id_region": "2",
"ciudad": "María Elena",
"region": "Región de Antofagasta",
"latitud": "-22.34516100",
"longitud": "-69.66181810"
},
...
]
Consulta por una ubicación:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
| id | GET | Int | Con el valor numérico de id_ciudad |
GET: https://api.toppropiedades.cl/v1/ubicaciones?id={parametro}
Resultado json esperado:
{
"id_ciudad": "9",
"id_region": "2",
"ciudad": "Calama",
"region": "Región de Antofagasta",
"latitud": "-22.46239170",
"longitud": "-68.92721810"
}
Consulta de índicadores económicos
Podrás consultar por los índicadores económicos del día, el resultado de la consulta será en formato json.
Consulta por los índicadores económicos:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
GET: https://api.toppropiedades.cl/v1/indicadores
Resultado json esperado:
{
"uf": "$36.085,87",
"utm": "$63.263,00",
"dolar": "$808,21",
"euro": "$880,31",
"ipc": "0.1",
"tasa_interes": "5"
}
Consultas a tu cuenta
Consulta de usuarios
Podrás consultar por todos los usuarios disponibles de tu cuenta o por un usuario en particular de tu cuenta, el resultado de la consulta será en formato json.
Consulta de todos los usuarios de tu cuenta:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
GET: https://api.toppropiedades.cl/v1/usuarios
Resultado json esperado:
[
{
"id_usuario": "123",
"agente": "Nombre Apellido",
"telefono": "+569 9999 9999",
"usuario": "correo@dominio.cl",
"cargo": "Agente",
"ciudad": "Viña del Mar",
"foto": "https://www.toppropiedades.cl/imagenes/foto.jpg"
},
{
"id_usuario": "456",
"agente": "Nombre Apellido",
"telefono": "+569 9999 9999",
"usuario": "correo@dominio.cl",
"cargo": "Agente",
"ciudad": "Osorno",
"foto": "https://www.toppropiedades.cl/imagenes/foto.jpg"
},
{
"id_usuario": "789",
"agente": "Nombre Apellido",
"telefono": "+569 9999 9999",
"usuario": "correo@dominio.cl",
"cargo": "Agente",
"ciudad": "Santiago",
"foto": "https://www.toppropiedades.cl/imagenes/foto.jpg"
},
...
]
Consulta por un usuario:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
| id | GET | Int | Con el valor numérico de id_usuario |
GET: https://api.toppropiedades.cl/v1/usuarios?id={parametro}
Resultado json esperado:
{
"id_usuario": "456",
"agente": "Nombre Apellido",
"telefono": "+569 9999 9999",
"usuario": "correo@dominio.cl",
"cargo": "Agente",
"ciudad": "Osorno",
"foto": "https://www.toppropiedades.cl/imagenes/foto.jpg"
}
Consulta de búsqueda por filtros
Podrás consultar mediante filtros un resultado específico de propiedades, el resultado de la consulta será en formato json.
Consulta de búsqueda por filtros:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
| usuario | GET | Int | Adjunta el campo id_usuario, permite el campo vacío. |
| operacion | GET | Int | Adjunta el campo id_operacion, permite el campo vacío. |
| categoria | GET | Int | Adjunta el campo id_categoria, permite el campo vacío. |
| region | GET | Int | Adjunta el campo id_region, permite el campo vacío. |
| ciudad | GET | Int | Adjunta el campo id_ciudad, permite el campo vacío. |
| terreno | GET | Num | Adjunta valores numéricos enteros, permite el campo vacío. |
| construccion | GET | Num | Adjunta valores numéricos enteros, permite el campo vacío. |
| habitaciones | GET | Num | Adjunta valores numéricos enteros, permite el campo vacío. |
| banos | GET | Num | Adjunta valores numéricos enteros, permite el campo vacío. |
| estacionamientos | GET | Num | Adjunta valores numéricos enteros, permite el campo vacío. |
| desde | GET | Num | Adjunta valores numéricos enteros, permite el campo vacío. |
| hasta | GET | Num | Adjunta valores numéricos enteros, permite el campo vacío. |
| orden | GET | Num | Adjunta valores numéricos enteros: 1 para ordenamiento descendiente. 2 para ordenamiento ascendente |
GET: https://api.toppropiedades.cl/v1/filtros?{parametros}
Resultado json esperado:
[
{
"id_propiedad": 117639,
"id_usuario": 6669,
"id_estado": 1,
"estado": "Disponible",
"id_operacion": 2,
"operacion": "Venta",
"id_categoria": 25,
"categoria": "Parcela",
"id_ciudad": 41,
"ciudad": "Algarrobo",
"id_region": 5,
"region": "Región de Valparaíso",
"realtime": "1677500511",
"publicacion": "1732547660",
"gestionada": "",
"latitud": "-33.35479965",
"longitud": "-71.64751053",
"mapa": 1,
"uf": 1,
"valor": 9600,
"canje": 0,
"destacado": 2,
"propiedad": "Vendo Parcela Algarrobo /MIrasol 4 HA",
"terreno": 38910,
"construido": 120,
"habitaciones": 3,
"banos": 2,
"estacionamiento": 7,
"url": "117639-vendo-parcela-algarrobo-mirasol-4-ha",
"url_op": "venta",
"url_cat": "parcela",
"url_ci": "algarrobo",
"foto_principal_s": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"foto_principal_b": "https://www.toppropiedades.cl/imagenes/foto.jpg"
},
{
"id_propiedad": 126428,
"id_usuario": 6669,
"id_estado": 1,
"estado": "Disponible",
"id_operacion": 2,
"operacion": "Venta",
"id_categoria": 4,
"categoria": "Local Comercial",
"id_ciudad": 312,
"ciudad": "La Reina",
"id_region": 99,
"region": "Región Metropolitana",
"realtime": "1686743222",
"publicacion": "1686743222",
"gestionada": "",
"latitud": "-33.45180542",
"longitud": "-70.55140696",
"mapa": 1,
"uf": 1,
"valor": 22000,
"canje": 0,
"destacado": 1,
"propiedad": "En Plena Avenida Larraín Comercial !!!",
"terreno": 800,
"construido": 268,
"habitaciones": 10,
"banos": 6,
"estacionamiento": 4,
"url": "126428-en-plena-avenida-larrain-comercial-",
"url_op": "venta",
"url_cat": "local-comercial",
"url_ci": "la-reina",
"foto_principal_s": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"foto_principal_b": "https://www.toppropiedades.cl/imagenes/foto.jpg"
},
{
"id_propiedad": 131304,
"id_usuario": 6669,
"id_estado": 1,
"estado": "Disponible",
"id_operacion": 2,
"operacion": "Venta",
"id_categoria": 37,
"categoria": "Terreno Industrial",
"id_ciudad": 333,
"ciudad": "Quinta Normal",
"id_region": 99,
"region": "Región Metropolitana",
"realtime": "1692059465",
"publicacion": "1692059465",
"gestionada": "",
"latitud": "-33.42694662",
"longitud": "-70.69002116",
"mapa": 1,
"uf": 1,
"valor": 7400,
"canje": 0,
"destacado": 1,
"propiedad": "Autopista costanera Norte / General Velásquez",
"terreno": 430,
"construido": 60,
"habitaciones": 2,
"banos": 2,
"estacionamiento": 5,
"url": "131304-autopista-costanera-norte-general-velasquez",
"url_op": "venta",
"url_cat": "terreno-industrial",
"url_ci": "quinta-normal",
"foto_principal_s": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"foto_principal_b": "https://www.toppropiedades.cl/imagenes/foto.jpg"
},
...
]
Consulta de propiedades
Podrás consultar por todas tus propiedades disponibles y no disponibles de tu cuenta o por una propiedad en particular de tu cuenta, el resultado de la consulta será en formato json.
Consulta de todas las propiedades de tu cuenta:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
GET: https://api.toppropiedades.cl/v1/propiedades
Resultado json esperado:
[
{
"id_propiedad": 166501,
"id_usuario": 6669,
"id_estado": 1,
"estado": "Disponible",
"realtime": "1739378180",
"publicacion": "1747961564",
"gestionada": "1747961564",
"visitas": 39,
"id_operacion": 2,
"operacion": "Venta",
"id_categoria": 16,
"categoria": "Casa",
"id_ciudad": 308,
"ciudad": "La Cisterna",
"id_region": 99,
"region": "Región Metropolitana",
"latitud": "-33.52007924",
"longitud": "-70.64683002",
"mapa": 1,
"sector": "jose ureta 1171",
"direccion": "José Ureta 1171, la",
"uf": 0,
"valor": 150000000,
"rol": "",
"canje": 0,
"destacado": 1,
"propiedad": "Casa en venta de 3 dorm. en La Cisterna para Remodelar",
"terreno": 500,
"construido": 123,
"habitaciones": 3,
"banos": 1,
"estacionamiento": 0,
"descripcion": "Descripción o detalle de la propiedad",
"url": "166501-casa-en-venta-de-3-dorm-en-la-cisterna-para-remodelar",
"url_op": "venta",
"url_cat": "casa",
"url_ci": "la-cisterna",
"foto_principal_s": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"foto_principal_b": "https://www.toppropiedades.cl/imagenes/foto.jpg"
},
{
"id_propiedad": 163678,
"id_usuario": 6669,
"id_estado": 1,
"estado": "Disponible",
"realtime": "1736373601",
"publicacion": "1736373601",
"gestionada": "",
"visitas": 40,
"id_operacion": 1,
"operacion": "Arriendo",
"id_categoria": 16,
"categoria": "Casa",
"id_ciudad": 322,
"ciudad": "Ñuñoa",
"id_region": 99,
"region": "Región Metropolitana",
"latitud": "-33.45765675",
"longitud": "-70.60001180",
"mapa": 1,
"sector": "José Domingo Cañas",
"direccion": "José Domingo Cañas 2809, ñuñoa",
"uf": 1,
"valor": 118,
"rol": "",
"canje": 0,
"destacado": 1,
"propiedad": "Casa en arriendo de 5 dorm. en Ñuñoa",
"terreno": 442,
"construido": 250,
"habitaciones": 5,
"banos": 4,
"estacionamiento": 4,
"descripcion": "Descripción o detalle de la propiedad",
"url": "163678-casa-en-arriendo-de-5-dorm-en-nunoa",
"url_op": "arriendo",
"url_cat": "casa",
"url_ci": "nunoa",
"foto_principal_s": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"foto_principal_b": "https://www.toppropiedades.cl/imagenes/foto.jpg"
},
{
"id_propiedad": 163197,
"id_usuario": 6669,
"id_estado": 1,
"estado": "Disponible",
"realtime": "1735347630",
"publicacion": "1735347630",
"gestionada": "",
"visitas": 36,
"id_operacion": 1,
"operacion": "Arriendo",
"id_categoria": 17,
"categoria": "Departamento",
"id_ciudad": 342,
"ciudad": "Santiago",
"id_region": 99,
"region": "Región Metropolitana",
"latitud": "-33.42695377",
"longitud": "-70.67785870",
"mapa": 1,
"sector": "Parque Los Reyes",
"direccion": "Presidente Balmaceda 2914, Santiago",
"uf": 0,
"valor": 225000,
"rol": "",
"canje": 0,
"destacado": 1,
"propiedad": "Departamento Arriendo 1 dorm. Parque Los Reyes",
"terreno": 0,
"construido": 40,
"habitaciones": 1,
"banos": 1,
"estacionamiento": 0,
"descripcion": "Descripción o detalle de la propiedad",
"url": "163197-departamento-arriendo-1-dorm-parque-los-reyes",
"url_op": "arriendo",
"url_cat": "departamento",
"url_ci": "santiago",
"foto_principal_s": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"foto_principal_b": "https://www.toppropiedades.cl/imagenes/foto.jpg"
},
...
]
Consulta por una propiedad:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
| id | GET | Int | Con el valor numérico de id_propiedad |
GET: https://api.toppropiedades.cl/v1/propiedades?id={parametro}
Resultado json esperado:
{
"0": {
"id_propiedad": 163196,
"id_usuario": 6669,
"id_estado": 1,
"estado": "Disponible",
"realtime": "1735347209",
"publicacion": "1735347209",
"gestionada": "",
"visitas": 24,
"id_operacion": 2,
"operacion": "Venta",
"id_categoria": 17,
"categoria": "Departamento",
"id_ciudad": 342,
"ciudad": "Santiago",
"id_region": 99,
"region": "Región Metropolitana",
"latitud": "-33.42695377",
"longitud": "-70.67785870",
"mapa": 1,
"sector": "Parque Los Reyes",
"direccion": "Presidente Balmaceda 2914, Santiago",
"uf": 0,
"valor": 58000000,
"rol": "",
"canje": 1,
"destacado": 1,
"propiedad": "Vendo Depto Parque Los Reyes 1 Dormitorio",
"terreno": 0,
"construido": 30,
"habitaciones": 1,
"banos": 1,
"estacionamiento": 0,
"descripcion": "Descripción o detalle de la propiedad",
"url": "163196-vendo-depto-parque-los-reyes-1-dormitorio",
"foto_principal_s": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"foto_principal_b": "https://www.toppropiedades.cl/imagenes/foto.jpg"
"orden_fotos": ""
},
"fotos": [
{
"id_fotografia": 2394263,
"foto": "https://www.toppropiedades.cl/imagenes/foto1.jpg",
"orden": 0
},
{
"id_fotografia": 2394264,
"foto": "https://www.toppropiedades.cl/imagenes/foto2.jpg",
"orden": 0
},
{
"id_fotografia": 2394265,
"foto": "https://www.toppropiedades.cl/imagenes/foto3.jpg",
"orden": 0
},
...
]
}
Consulta de servicios
Podrás consultar por todos los servicios disponibles de tu cuenta o por un servicio en particular de tu cuenta, el resultado de la consulta será en formato json.
Consulta de todos los servicios de tu cuenta:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
GET: https://api.toppropiedades.cl/v1/servicios
Resultado json esperado:
[
{
"id_servicio": 30,
"titulo": "Título del servicio de prueba 1",
"descripcion": "Detalle del servicio",
"publicacion": "1550774657",
"foto": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"url": "titulo-del-servicio-de-prueba-1"
},
{
"id_servicio": 323,
"titulo": "Título del servicio de prueba 2",
"descripcion": "Detalle del servicio",
"publicacion": "1550774657",
"foto": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"url": "titulo-del-servicio-de-prueba-2"
},
{
"id_servicio": 1230,
"titulo": "Título del servicio de prueba 3",
"descripcion": "Detalle del servicio",
"publicacion": "1550774657",
"foto": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"url": "titulo-del-servicio-de-prueba-3"
},
...
]
Consulta por un servicio:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
| id | GET | Int | Con el valor numérico de id_servicio |
GET: https://api.toppropiedades.cl/v1/servicios?id={parametro}
Resultado json esperado:
{
"id_servicio": 30,
"titulo": "Título del servicio de prueba 1",
"descripcion": "Detalle del servicio",
"publicacion": "1550774657",
"foto": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"url": "titulo-del-servicio-de-prueba-1"
}
Consulta de noticias o blog
Podrás consultar por todas las noticias disponibles de tu cuenta o por una noticia en particular de tu cuenta, el resultado de la consulta será en formato json.
Consulta de todas las noticias de tu cuenta:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
GET: https://api.toppropiedades.cl/v1/noticias
Resultado json esperado:
[
{
"id_noticia": 30,
"titulo": "Título de la noticia de prueba 1",
"descripcion": "Detalle de la noticia",
"publicacion": "1550774657",
"foto": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"url": "titulo-de-la-noticia-de-prueba-1"
},
{
"id_noticia": 303,
"titulo": "Título de la noticia de prueba 2",
"descripcion": "Detalle de la noticiao",
"publicacion": "1550774657",
"foto": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"url": "titulo-de-la-noticia-de-prueba-2"
},
{
"id_noticia": 3330,
"titulo": "Título de la noticia de prueba 3",
"descripcion": "Detalle de la noticia",
"publicacion": "1550774657",
"foto": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"url": "titulo-de-la-noticia-de-prueba-3"
},
...
]
Consulta por una noticia:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
| id | GET | Int | Con el valor numérico de id_noticia |
GET: https://api.toppropiedades.cl/v1/noticias?id={parametro}
Resultado json esperado:
{
"id_noticia": 303,
"titulo": "Título de la noticia de prueba 2",
"descripcion": "Detalle de la noticiao",
"publicacion": "1550774657",
"foto": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"url": "titulo-de-la-noticia-de-prueba-2"
}
Consulta de testimonios
Podrás consultar por todos los testimonios disponibles de tu cuenta o por un testimonio en particular de tu cuenta, el resultado de la consulta será en formato json.
Consulta de todos los testimonios de tu cuenta:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
GET: https://api.toppropiedades.cl/v1/testimonios
Resultado json esperado:
[
{
"id_testimonio": 21,
"nombre_cliente": "Carmen Gloria Rodríguez",
"testimonio": "Testimonio de prueba.",
"publicacion": "1472740568"
},
{
"id_testimonio": 22,
"nombre_cliente": "Ana Maria Barros Silva",
"testimonio": "Testimonio de prueba.",
"publicacion": "1472758956"
},
{
"id_testimonio": 23,
"nombre_cliente": "Antonio Ortega Sepúlveda",
"testimonio": "Testimonio de prueba",
"publicacion": "1472826995"
},
...
]
Consulta por un testimonio:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
| id | GET | Int | Con el valor numérico de id_testimonio |
GET: https://api.toppropiedades.cl/v1/testimonios?id={parametro}
Resultado json esperado:
{
"id_testimonio": 22,
"nombre_cliente": "Ana Maria Barros Silva",
"testimonio": "Testimonio de prueba.",
"publicacion": "1472758956"
}
Consulta de portadas o carrusel
Podrás consultar por todas las portadas o carrusel disponibles de tu cuenta o por una portada o carrusel en particular de tu cuenta, el resultado de la consulta será en formato json.
Consulta de todas las portadas o carrusel de tu cuenta:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
GET: https://api.toppropiedades.cl/v1/portadas
Resultado json esperado:
[
{
"id_carrusel": 1300,
"carrusel": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"leyenda": "Busca en nuestro portal inmobiliario tu propiedad ideal",
"publicacion": "1546919293",
"link": ""
},
{
"id_carrusel": 1301,
"carrusel": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"leyenda": "Busca en nuestro portal inmobiliario tu propiedad ideal",
"publicacion": "1546919293",
"link": ""
},
{
"id_carrusel": 1302,
"carrusel": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"leyenda": "Busca en nuestro portal inmobiliario tu propiedad ideal",
"publicacion": "1546919293",
"link": ""
},
...
]
Consulta por una portada o carrusel:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
| id | GET | Int | Con el valor numérico de id_carrusel |
GET: https://api.toppropiedades.cl/v1/portadas?id={parametro}
Resultado json esperado:
{
"id_carrusel": 1300,
"carrusel": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"leyenda": "Busca en nuestro portal inmobiliario tu propiedad ideal",
"publicacion": "1546919293",
"link": ""
}
Consulta de leads o contactos
Podrás consultar por todos los leads o contactos que has recibido, de propiedades, de corredora y de agente, el resultado de la consulta será en formato json.
Consulta de todos los leads o contactos de tu cuenta:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
| fu | GET | Int | Con el valor numérico de: 1 para leads o contactos de propiedades. 2 para leads o contactos de corredora. 3 para leads o contactos de usuarios. |
GET: https://api.toppropiedades.cl/v1/contactos?fu={parametro}
Resultado json esperado:
[
{
"id_mensaje": 26,
"id_propiedad": 435,
"nombre": "Nombre Apellido",
"telefono": "+569 9999 9999",
"correo": "correo@dominio.cl",
"asunto": "HERMOSA CASA, LOMAS DE MAIPU",
"mensaje": "Deseo visitar casa muy interesado",
"publicacion": "1467206955"
},
{
"id_mensaje": 27,
"id_propiedad": 4355,
"nombre": "Nombre Apellido",
"telefono": "+569 9999 9999",
"correo": "correo@dominio.cl",
"asunto": "HERMOSA CASA, LOMAS DE MAIPU",
"mensaje": "Deseo visitar casa muy interesado",
"publicacion": "1467206955"
},
{
"id_mensaje": 126,
"id_propiedad": 10435,
"nombre": "Nombre Apellido",
"telefono": "+569 9999 9999",
"correo": "correo@dominio.cl",
"asunto": "HERMOSA CASA, LOMAS DE MAIPU",
"mensaje": "Deseo visitar casa muy interesado",
"publicacion": "1467206955"
},
...
]
Consulta por un lead o contacto:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
| fu | GET | Int | Con el valor numérico de: 1 para contactos de propiedades. 2 para contactos de corredora. 3 para contactos de usuarios. |
| id | GET | Int | Con el valor numérico de acuerdo a la función: id_mensaje id_contacto id_contacto_agente |
GET: https://api.toppropiedades.cl/v1/contactos?fu={parametro}&id={parametro}
Resultado json esperado:
{
"id_mensaje": 27,
"id_propiedad": 4355,
"nombre": "Nombre Apellido",
"telefono": "+569 9999 9999",
"correo": "correo@dominio.cl",
"asunto": "HERMOSA CASA, LOMAS DE MAIPU",
"mensaje": "Deseo visitar casa muy interesado",
"publicacion": "1467206955"
}
Consulta de tu cuenta o configuración
Podrás consultar la información de tu cuenta o configuración, el resultado de la consulta será en formato json.
Consulta de tu cuenta:
| Parámetro | Método | Tipo | Descripción |
|---|---|---|---|
| token | HEADER | String | Token de autorización obligatorio. |
GET: https://api.toppropiedades.cl/v1/cuentas
Resultado json esperado:
{
"cliente": "Nombre de la corredora o agencia",
"correo": "correo@dominio.cl",
"telefono1": "+569 9999 9999",
"telefono2": "+569 8888 8888",
"direccion": "Direccion de la oficina",
"oficina": "Numero de oficina",
"ciudad": "Viña del Mar",
"region": "Región de Valparaíso",
"logotipo": "https://www.toppropiedades.cl/imagenes/logo.png",
"icono": "https://www.toppropiedades.cl/imagenes/icono.png",
"favicon": "https://www.toppropiedades.cl/imagenes/favicon.ico",
"descripcion": "Descripción del sitio web para buscadores.",
"keywords": "",
"lista": "12";
"facebook": "https://www.facebook.com/usuario",
"twitter": "https://www.twitter.com/usuario",
"instagram": "https://www.instagram.com/usuario",
"linkedin": "https://www.linkedin.com/usuario",
"nosotros": "Información de nosotros.",
"nosotros_img": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"contacto": "Información de contacto.",
"contacto_img": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"entreguenos_su_propiedad": "Información de captación.",
"entreguenos_su_propiedad_img": "https://www.toppropiedades.cl/imagenes/foto.jpg",
"privacidad": "Informacion de privacidad.",
"privacidad_img": "https://www.toppropiedades.cl/imagenes/foto.jpg"
}
Si tienes dudas sobre el uso de nuestra API puedes enviar un correo a contacto@toppropiedades.cl
Top Propiedades es un portal inmobiliario en Chile y desarrolladores de sitios web para corredores de propiedades.
Usamos cookies para mejorar la experiencia, Aceptas el uso de cookies?