Publica en Raizia desde tu CRMPublish to Raizia from your CRM

Conectar una inmobiliariaConnecting a brokerage

AutenticaciónAuthentication

Envía la clave en cada solicitud, por HTTPS:

Send the key with every request, over HTTPS:

Authorization: Bearer rz_live_…

Las claves de prueba empiezan por rz_test_. Sin clave, o con una que Raizia no reconoce, la respuesta es 401.

Test keys start with rz_test_. Without a key, or with one Raizia does not recognise, the answer is 401.

curl https://api.raizia.co/v1/connection \
  -H "Authorization: Bearer $RAIZIA_API_KEY"

{"brokerage":{"id":"…","name":"Inmobiliaria Ejemplo"},"sandbox":false,"apiVersion":"v1","formats":["wasi","raizia"]}

RutasRoutes

Cada CRM envía su propio formato. /v1/crm/wasi/… recibe el JSON de inmuebles de WASI tal como lo devuelve su API. /v1/listings recibe el formato propio de Raizia, para cualquier otro CRM. Un CRM con un formato distinto puede tener su propio adaptador en /v1/crm/{crm}/… sin afectar a los demás.

Each CRM sends its own format. /v1/crm/wasi/… takes WASI's property JSON exactly as its API returns it. /v1/listings takes Raizia's own format, for any other CRM. A CRM with a different format can get its own adapter at /v1/crm/{crm}/… without affecting the others.

Publicar y actualizarPublishing and updating

curl -X PUT https://api.raizia.co/v1/crm/wasi/properties/10562861 \
  -H "Authorization: Bearer $RAIZIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d @property-10562861.json

HTTP/1.1 202 Accepted
Location: /v1/crm/wasi/properties/10562861

{"source":"wasi","externalId":"10562861","propertyId":10562861,"status":"processing",
 "message":"Raizia está guardando el anuncio.","offers":[],"url":"/v1/crm/wasi/properties/10562861",
 "receivedAt":"2026-11-13T15:04:05Z","processedAt":null}

El cuerpo es el inmueble tal como lo devuelve WASI. Raizia usa, entre otros: for_sale, for_rent, sale_price, rent_price (en COP, desde COP 1.000.000), id_property_type, title, observations, address, city_label, region_label, zone_label, las áreas, bedrooms, bathrooms, garages, latitude, longitude, id_publish_on_map, main_image, galleries, features, video, id_status_on_page e id_availability. Un inmueble inactivo o vendido en WASI se retira de Raizia.

The body is the property as WASI returns it. Raizia uses, among others: for_sale, for_rent, sale_price, rent_price (in COP, from COP 1,000,000), id_property_type, title, observations, address, city_label, region_label, zone_label, the areas, bedrooms, bathrooms, garages, latitude, longitude, id_publish_on_map, main_image, galleries, features, video, id_status_on_page and id_availability. A property that is inactive or sold in WASI is removed from Raizia.

Varios a la vezSeveral at once

POST /v1/crm/wasi/properties acepta un inmueble, una lista de hasta 50, o la lista de WASI ({"0": {…}, "1": {…}, "total": 2}). Responde 200 con un resultado por inmueble, en el mismo orden: su estado con "accepted": true, o "accepted": false con el error.

POST /v1/crm/wasi/properties takes one property, a list of up to 50, or WASI's own list ({"0": {…}, "1": {…}, "total": 2}). It answers 200 with one result per property, in the same order: its status with "accepted": true, or "accepted": false with the error.

EstadoStatus

GET /v1/crm/wasi/properties/{id} dice qué hizo Raizia con el inmueble y con cada oferta. El message es una frase para mostrar a la inmobiliaria, en español salvo que pidas inglés con Accept-Language: en.

GET /v1/crm/wasi/properties/{id} says what Raizia did with the property and each offer. The message is a sentence to show the brokerage, in Spanish unless you ask for English with Accept-Language: en.

{"source":"wasi","externalId":"10562861","propertyId":10562861,"status":"published",
 "message":"El anuncio está publicado en Raizia.",
 "offers":[{"listingType":"sale","status":"published","url":"https://raizia.co/es/propiedad/apartaestudio-en-venta-laureles-medellin-100231"}],
 "url":"/v1/crm/wasi/properties/10562861","receivedAt":"2026-11-13T15:04:05Z","processedAt":"2026-11-13T15:04:09Z"}

GET /v1/crm/wasi/properties lista todos los inmuebles, del más reciente al más antiguo, con status, page y pageSize (hasta 100) opcionales. Pueden aparecer estados nuevos; trata los que no conozcas como pendientes.

GET /v1/crm/wasi/properties lists every property, newest first, with optional status, page and pageSize (up to 100). New status values may appear; treat ones you don't know as pending.

RetirarRemoving

DELETE /v1/crm/wasi/properties/{id} retira el inmueble de inmediato y responde con su estado. Enviarlo de nuevo más adelante lo vuelve a publicar. Para varios, usa DELETE /v1/crm/wasi/properties?ids=10562861,10562862 (hasta 50).

DELETE /v1/crm/wasi/properties/{id} removes the property at once and answers with its status. Sending it again later publishes it again. For several, use DELETE /v1/crm/wasi/properties?ids=10562861,10562862 (up to 50).

ErroresErrors

Los errores tienen un code estable y un message para mostrar. details dice qué oferta o campo falló.

Errors have a stable code and a message to show. details says which offer or field failed.

HTTP/1.1 422 Unprocessable Entity

{"error":{"code":"invalid_property","message":"Raizia no puede publicar este inmueble.",
 "details":[{"listingType":"sale","message":"El precio no está en pesos colombianos."}]}}

Formato RaiziaRaizia format

Para CRMs distintos de WASI. Las rutas son las mismas en /v1/listings, y el código del inmueble es externalId (letras, números, ., - o _, hasta 80). Un lote es una lista o {"listings": […]}.

For CRMs other than WASI. The routes are the same under /v1/listings, and the property's id is externalId (letters, digits, ., - or _, up to 80). A batch is a list or {"listings": […]}.

{"externalId":"A-1001","title":"Apartamento en venta en Laureles","description":"Luminoso, con balcón.",
 "propertyType":"apartment","address":"Circular 73 # 39-20","city":"Medellín","department":"Antioquia",
 "neighborhood":"Laureles","latitude":6.2447,"longitude":-75.5967,"showExactLocation":true,
 "areaM2":98,"bedrooms":3,"bathrooms":2,"parkingSpaces":1,"floor":5,"administrationFeeCop":420000,
 "features":["elevator","balcony"],"videoUrl":"https://www.youtube.com/watch?v=…",
 "photos":[{"url":"https://cdn.ejemplo.com/a1001/sala.jpg","caption":"Sala"}],
 "agent":{"email":"agente@ejemplo.com","phone":"+57 300 000 0000"},
 "offers":[{"type":"sale","priceCop":680000000},{"type":"rent","priceCop":4200000}]}

Cuando un campo no sirve, la respuesta 422 los lista todos en details, con field y message.

When fields are unusable, the 422 answer lists all of them in details, with field and message.

Límites y versionesLimits and versions

• Cuerpo de hasta 6 MB y lotes de hasta 50 inmuebles.
• 5 solicitudes por segundo por IP, con picos de hasta 50. Si te pasas, la respuesta es 429.
• La versión mayor va en la ruta (/v1). Campos opcionales, rutas y estados nuevos no la cambian, así que ignora lo que no conozcas. Un cambio incompatible será /v2, y /v1 seguirá funcionando al menos 12 meses.

• Bodies up to 6 MB and batches up to 50 properties.
• 5 requests per second per IP, with bursts up to 50. Beyond that the answer is 429.
• The major version is in the path (/v1). New optional fields, routes and statuses don't change it, so ignore what you don't know. An incompatible change will be /v2, and /v1 will keep working for at least 12 months.

Sandbox

¿Preguntas? Escríbenos aQuestions? Write to support@raizia.co.