Un sitio web inmobiliario suele tener tres tipos de página, y cada uno recibe su propia descripción de Schema.org. Marque la página de la inmobiliaria u oficina con RealEstateAgent, el perfil de cada agente con Person conectado a la inmobiliaria, y cada página de propiedad con RealEstateListing, un tipo de propiedad como House o Apartment, y una Offer para las condiciones de venta o renta.

Agregue BreadcrumbList en cualquier página donde aparezca una ruta de navegación visible. Cada precio, número de recámaras, dirección y dato del agente que aparezca en el marcado también debe aparecer en la página, y la redacción de los anuncios merece una revisión de vivienda justa antes de publicarse.

Los ejemplos de JSON-LD usan una inmobiliaria ficticia en example.com. Las funciones que Google documenta para un sitio como este son Negocio local (Local Business) y Ruta de navegación (Breadcrumb), así que los tipos de anuncio conviene tratarlos como una descripción precisa de la página, no como una vía para obtener un resultado especial.

Puntos clave

  1. Un tipo por páginaUse RealEstateAgent para la inmobiliaria, Person para cada agente y RealEstateListing con un tipo de propiedad y Offer para cada página de anuncio.
  2. Conecte con @idAsigne valores @id estables a la inmobiliaria, los agentes, los anuncios y las ofertas, y apunte worksFor, affiliation y offeredBy hacia ellos para que las entidades se conecten.
  3. Funciones de Google que aplicanLas funciones de Google Negocio local y Migas de pan aplican aquí. Los tipos de anuncio y de propiedad son vocabulario de Schema.org sin requisitos de Google.
  4. Coincidir con la página visibleCada precio, número de recámaras, dirección y dato del agente en el marcado debe aparecer en la página, y ambos cambian juntos.
  5. Redacción sobre vivienda justaDescriba datos objetivos de la propiedad, no a quién le conviene una vivienda, y consulte con un profesional calificado en vivienda la redacción dudosa.
  6. Pruebe después de publicarEjecute el Schema Markup Validator y la Prueba de resultados enriquecidos (Rich Results Test), luego inspeccione la página en vivo en Google Search Console y Bing Webmaster Tools.

Qué tipo corresponde a cada página

La página decide el tipo, así que primero nombre la página. Cuatro tipos de página cubren la mayoría de los sitios inmobiliarios.

  • La página de la inmobiliaria u oficina usa RealEstateAgent, el subtipo de Schema.org para un agente o una agencia inmobiliaria.
  • El perfil de un agente usa Person, vinculado a la inmobiliaria con worksFor o affiliation.
  • Una página de propiedad usa RealEstateListing para la página, un tipo de propiedad como House, Apartment o SingleFamilyResidence para la vivienda, y Offer para las condiciones.
  • Cualquier página con una ruta de navegación visible usa BreadcrumbList.

Una inmobiliaria puede elegir entre RealEstateAgent y Organization simple. En Schema.org, RealEstateAgent es un subtipo tanto de LocalBusiness como de Organization, así que conserva todo lo que una organización puede decir y agrega qué tipo de negocio es. Úselo cuando la página describa visiblemente el negocio inmobiliario. La guía de schema de organización cubre el caso general.

Un negocio que vende algo distinto de propiedades tiene sus propias páginas. Consulte las guías para despachos de abogados, restaurantes, consultorios médicos, servicios del hogar y tiendas en línea.

Marcar la inmobiliaria con RealEstateAgent

Coloque el bloque de la inmobiliaria en la página de inicio o en la página de la oficina, la que describa visiblemente el negocio. Los campos que debe completar son el nombre, la dirección, el teléfono, la URL, el logotipo, el horario y el área de servicio, y cada uno debe coincidir con lo que un visitante lee en la página.

La documentación de Negocio local de Google indica que name y address son obligatorios para su función de negocio local. Recomienda otros campos, como telephone, la URL, logo, el horario de atención y las coordenadas geográficas. Como RealEstateAgent es un subtipo de LocalBusiness, se aplican los mismos campos.

json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "RealEstateAgent",
      "@id": "https://example.com/#brokerage",
      "name": "Harborline Realty",
      "url": "https://example.com/",
      "logo": "https://example.com/images/harborline-logo.png",
      "telephone": "+1-555-010-0142",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "100 Example Avenue",
        "addressLocality": "Example City",
        "addressRegion": "IL",
        "postalCode": "60601",
        "addressCountry": "US"
      },
      "openingHoursSpecification": {
        "@type": "OpeningHoursSpecification",
        "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
        "opens": "09:00",
        "closes": "17:00"
      },
      "areaServed": {
        "@type": "AdministrativeArea",
        "name": "Example County"
      }
    }
  ]
}

Reemplace Harborline Realty, la dirección, el número de teléfono, el horario y el condado por sus propios datos, y elimine cualquier propiedad que la página no muestre. El @id es un identificador estable de la inmobiliaria. Asígnele un fragmento en la URL de su página de inicio y use el mismo valor cada vez que otro bloque se refiera a la inmobiliaria.

El generador de schema de negocio local crea este tipo de bloque a partir de un formulario, y la guía de schema de negocio local explica cada campo. Una inmobiliaria con varias oficinas puede seguir la guía de varias ubicaciones.

Conectar a cada agente con Person

Una página de perfil de agente describe a una persona, así que usa Person. Complete solo lo que muestra el perfil. El tipo Person de Schema.org ofrece estas propiedades para un agente:

  • name, jobTitle, image y url
  • telephone, y email solo cuando la página lo muestre
  • worksFor o affiliation, que apuntan a la inmobiliaria
  • sameAs, para enlaces a perfiles profesionales que identifican a la misma persona
  • knowsAbout y knowsLanguage

Use worksFor cuando el agente trabaje para la inmobiliaria. Use affiliation cuando la relación sea más amplia y la persona esté asociada con la organización. En ambos casos, apunte a la inmobiliaria con su @id para que las dos descripciones se conecten.

json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Person",
      "@id": "https://example.com/agents/jordan-lee#person",
      "name": "Jordan Lee",
      "url": "https://example.com/agents/jordan-lee",
      "image": "https://example.com/images/jordan-lee.jpg",
      "jobTitle": "Real Estate Agent",
      "worksFor": {
        "@id": "https://example.com/#brokerage"
      },
      "knowsLanguage": ["en", "es"]
    }
  ]
}

Reemplace el nombre del agente, la URL de su perfil, la foto y el cargo por los suyos. Los valores de knowsLanguage son códigos de idioma, así que enumere solo los idiomas en que el agente trabaja realmente y que menciona el perfil. Google no tiene un requisito de resultado enriquecido específico para un Person usado de esta manera, pero el nodo sigue dando a Bing y a otros sistemas que leen Schema.org una descripción clara de quién es el agente.

La guía de schema de persona y autor va más allá, y el generador de schema de persona crea el bloque. Para sameAs, consulte SEO de entidades con sameAs.

Describir un anuncio con RealEstateListing, un tipo de propiedad y Offer

Una página de anuncio necesita tres descripciones conectadas. RealEstateListing describe la página en sí y puede incluir datePosted, name, url, image, description y un enlace a la oferta. Un subtipo específico de Accommodation, como House, Apartment o SingleFamilyResidence, describe la vivienda física. Offer contiene las condiciones: price, priceCurrency, availability, businessFunction y url.

Los datos de la propiedad van en el nodo de la propiedad. PostalAddress, GeoCoordinates, floorSize, numberOfBedrooms, numberOfBathroomsTotal, yearBuilt y amenityFeature encajan ahí, siempre que los datos sean visibles en la página y precisos. El vocabulario Accommodation de Schema.org también cubre mascotas, ocupación y uso permitido, y RealEstateListing define el tipo a nivel de página.

Una tarjeta de página de anuncio unida con líneas rectas a una tarjeta de propiedad con íconos de casa, cama y baño, y a una etiqueta separada con un ícono de moneda
Figura 1. Una página de anuncio, la propiedad que describe y las condiciones de la oferta son tres descripciones conectadas.
json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "RealEstateListing",
      "@id": "https://example.com/listings/example-house#listing",
      "url": "https://example.com/listings/example-house",
      "name": "Example House in Example City",
      "description": "Casa ficticia de tres recámaras, con cochera para dos autos y patio cercado.",
      "datePosted": "2026-10-15",
      "image": [
        "https://example.com/images/example-house-front.jpg",
        "https://example.com/images/example-house-kitchen.jpg"
      ],
      "mainEntity": { "@id": "https://example.com/listings/example-house#property" },
      "offers": { "@id": "https://example.com/listings/example-house#offer" }
    },
    {
      "@type": "House",
      "@id": "https://example.com/listings/example-house#property",
      "name": "Example House",
      "url": "https://example.com/listings/example-house",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "200 Sample Street",
        "addressLocality": "Example City",
        "addressRegion": "IL",
        "postalCode": "60602",
        "addressCountry": "US"
      },
      "numberOfBedrooms": 3,
      "numberOfBathroomsTotal": 2,
      "floorSize": { "@type": "QuantitativeValue", "value": 1800, "unitCode": "FTK" },
      "yearBuilt": 2018
    },
    {
      "@type": "Offer",
      "@id": "https://example.com/listings/example-house#offer",
      "url": "https://example.com/listings/example-house",
      "businessFunction": "https://schema.org/Sell",
      "price": 425000,
      "priceCurrency": "USD",
      "availability": "https://schema.org/InStock",
      "itemOffered": { "@id": "https://example.com/listings/example-house#property" },
      "offeredBy": { "@id": "https://example.com/agents/jordan-lee#person" }
    }
  ]
}

Cada @id de este bloque es una etiqueta que usted elige, y las referencias entre ellos son lo que une la página, la vivienda y las condiciones. Reemplace la dirección ficticia, el número de recámaras, la superficie y el año por las cifras que muestre su página de anuncio, cambie House por Apartment u otro subtipo cuando corresponda a la vivienda, y ajuste el precio y la moneda a los montos que ve un visitante. El valor unitCode FTK significa pies cuadrados.

La referencia offeredBy de la oferta apunta al @id del agente a cargo del anuncio. Mantenga legible el bloque de cada página por separado: si la página del anuncio no define también al agente, incluya el nombre y el @id del agente en el grafo de esa página para que la referencia tenga a qué apuntar. La guía del grafo JSON-LD explica cómo funcionan los enlaces mediante @id.

Agregar BreadcrumbList a las páginas con una ruta visible

Una ruta de navegación como Inicio, Anuncios y luego el nombre de la propiedad vale la pena marcarla cuando los visitantes la pueden ver. La documentación de ruta de navegación de Google exige un BreadcrumbList con al menos dos entradas ListItem. La propiedad itemListElement es obligatoria para esa función, cada ListItem necesita position y name, y item es obligatoria salvo en la última migaja cuando la URL de la página puede inferirse.

json
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://example.com/" },
    { "@type": "ListItem", "position": 2, "name": "Listings", "item": "https://example.com/listings/" },
    { "@type": "ListItem", "position": 3, "name": "Example House in Example City" }
  ]
}

Haga que los nombres y el orden coincidan con la ruta de su página. La guía de schema de ruta de navegación y el generador de schema de ruta de navegación cubren rutas más largas y rutas por categoría.

Elegir propiedades según el propósito de la página

Qué propiedades corresponden a cada página depende de la página y de lo que documenta cada consumidor. La función Negocio local de Google tiene campos obligatorios, la función Ruta de navegación tiene los suyos, y los tipos de anuncio y de propiedad son vocabulario de Schema.org sin requisitos de ninguna función de Google. Etiquete las propiedades de anuncio como propiedades de Schema.org, nunca como requisitos de Google.

Propiedades por tipo de página

Pase el cursor o toque una fila para resaltarla. En pantallas pequeñas la tabla se desplaza de lado.

TipoPropiedades que conviene incluirEstado en las funciones de Google
RealEstateAgentname, address, telephone, url, logo, openingHoursSpecification, areaServedNegocio local de Google: name y address obligatorios; telephone, URL, logo y horario recomendados.
Personname, jobTitle, image, url, telephone, worksFor, sameAs, knowsLanguageSin requisito de resultado enriquecido específico de Google para este uso.
RealEstateListingname, url, image, description, datePosted y un enlace a la ofertaPropiedades de vocabulario de Schema.org, no requisitos de Google.
House o Apartmentaddress, numberOfBedrooms, numberOfBathroomsTotal, floorSize, yearBuilt, amenityFeaturePropiedades de vocabulario de Schema.org, no requisitos de Google.
Offerprice, priceCurrency, availability, businessFunction, url, itemOfferedPropiedades de Schema.org sin requisitos de funciones inmobiliarias de Google.
BreadcrumbListitemListElement con position, name e item en cada ListItemMigas de pan de Google: itemListElement, position y name obligatorios; item obligatorio excepto en la última migaja.

Qué muestra Google y qué siguen haciendo los tipos

La galería de datos estructurados de Google incluye funciones como Negocio local, Organización, Ruta de navegación, Producto, Evento, Artículo y Vacation Rental. En un sitio inmobiliario, Negocio local aplica a la inmobiliaria y Ruta de navegación aplica a las rutas. RealEstateListing, House, Apartment y Accommodation son vocabulario válido de Schema.org, y las funciones de búsqueda de Google para un sitio así son Negocio local y Ruta de navegación, así que una página de anuncio no debe esperar obtener un resultado de anuncio específico.

Google dice que los datos estructurados le ayudan a entender el contenido de la página, que la presentación es discrecional y que el marcado válido no garantiza un resultado enriquecido ni una mejora de posicionamiento (pautas generales de datos estructurados). También indica que sus funciones de búsqueda generativa no necesitan marcado especial de Schema.org, aunque sigue recomendando datos estructurados para las funciones de búsqueda que sean elegibles (funciones de IA y su sitio web).

El soporte de las funciones cambia, así que lea las fechas. Las actualizaciones de documentación de Google registran que el resultado enriquecido de preguntas frecuentes dejó de mostrarse en la Búsqueda el 7 de mayo de 2026, y que la documentación de preguntas frecuentes se eliminó en junio de 2026. FAQPage sigue siendo un tipo válido de Schema.org, y el contenido de preguntas frecuentes sigue ayudando a los lectores, pero hoy no es una oportunidad de resultado enriquecido de preguntas frecuentes en Google. La guía de resultados enriquecidos explica la diferencia entre el marcado válido y una visualización.

Haga que el marcado sea legible para Bing, Yandex y Apple

Bing dice que admite Schema.org en JSON-LD, Microdata y RDFa, y su documentación de datos estructurados cubre negocios y organizaciones, personas, productos y ofertas, lo que corresponde a los nodos de inmobiliaria, agente y oferta descritos arriba. Yandex documenta JSON-LD dentro de una etiqueta script y un validador, y no todos los tipos de Schema.org son compatibles con sus servicios (uso de Schema.org en Yandex).

Acerca de Applebot explica que Applebot rastrea páginas web públicas para Apple Search, Siri y Spotlight, y que las páginas marcadas con noindex no aparecen en Spotlight ni en las Sugerencias de Siri. Para DuckDuckGo, mantenga la página rastreable e inspecciónela en Bing Webmaster Tools, porque otros servicios pueden usar los resultados de Bing. Consulte si los sistemas de IA usan el marcado schema.

Mantener el marcado y el texto del anuncio precisos

Las pautas de Google vinculan los datos estructurados con el contenido visible. Cada precio, número de recámaras, dirección y dato del agente en el JSON-LD debe aparecer en la página que lee el visitante, y ambos deben cambiar juntos. Wix dice lo mismo de su marcado manual, que debe corresponder al contenido visible de la página. Omita los datos personales, las amenidades que no existen, las afirmaciones no verificadas sobre el vecindario y el texto oculto.

Un hábito útil es leer el anuncio impreso junto con el marcado, línea por línea, antes de publicar.

Una mujer de cabello oscuro con mechas grises sostiene un bolígrafo sobre una hoja impresa de anuncio, junto a una laptop abierta en un escritorio de una pequeña oficina inmobiliaria
Figura 2. Leer el anuncio impreso junto con el marcado muestra si el precio, las recámaras y la dirección coinciden.

El cuidado por la vivienda justa aplica a las palabras de la página, y los datos estructurados no hacen aceptable un texto que no sería aceptable en el anuncio. Las reglas de publicidad de HUD en 24 CFR Part 109 identifican palabras, frases y símbolos que pueden transmitir preferencias o limitaciones discriminatorias, y la Ley de Vivienda Justa (Fair Housing Act) nombra las clases protegidas. Describa la vivienda con datos objetivos, como:

  • cantidad de recámaras y baños, y superficie
  • estacionamiento, características de accesibilidad y características del edificio
  • distancia al transporte público y a las instalaciones públicas cercanas
  • condiciones de venta o de renta, y la política sobre mascotas

La redacción sobre a quién le conviene una vivienda, como «perfecta para familias», «ideal para cristianos» o «comunidad para adultos», y las afirmaciones no verificadas, como «vecindario seguro», o los descriptores raciales y étnicos, son el tipo de lenguaje que conviene someter primero a un profesional calificado en vivienda. Las leyes estatales y locales pueden agregar requisitos además de las reglas federales, así que pida a un profesional calificado en vivienda o en asuntos legales locales que revise la redacción siempre que tenga dudas.

Agregar el marcado en su plataforma

Revise qué genera ya su plataforma antes de agregar una segunda descripción del mismo negocio. En WordPress, use el sistema de SEO o de schema del sitio cuando ya emita marcado de Organization, WebSite y Breadcrumb, y agregue datos personalizados de anuncios y agentes solo donde el plugin lo admita, para que ningún nodo aparezca dos veces. El comportamiento de los plugins cambia según el desarrollador y la versión, así que lea el HTML renderizado y no solo el editor. La guía de WordPress y la guía de marcado duplicado ayudan en este punto.

El filtro Liquid structured_data de Shopify se aplica a los objetos product y article, así que el marcado de anuncios necesita una implementación personalizada de tema o de app, y solo cuando el contenido del anuncio sea visible y se mantenga sincronizado. Wix admite JSON-LD personalizado mediante la configuración de SEO de la página. Debe ser válido, debe coincidir con el contenido visible y está limitado a 7,000 caracteres, con hasta cinco marcados por página en el flujo de trabajo manual. Consulte las guías de Wix y Shopify.

Squarespace emite datos estructurados automáticamente para publicaciones de blog, eventos, negocios locales, organizaciones, productos y sitios web, y dice que esos esquemas integrados no se pueden editar ni eliminar con los controles estándar. Lea la página renderizada antes de agregar JSON-LD personalizado para que la inmobiliaria no se describa dos veces. La guía de Squarespace tiene los pasos.

Webflow ofrece un campo de marcado Schema a nivel de página para JSON-LD manual, y las páginas de colección pueden vincular campos como name, address, price e image. Mantenga una sola vía de implementación por página. En Next.js, la guía de JSON-LD recomienda una etiqueta script en layout.js o page.js y reemplazar < por \u003c al serializar con JSON.stringify. En HubSpot, use la inyección en el head o una plantilla que administre un desarrollador, y luego confirme que la página publicada contiene el JSON-LD previsto. Las guías de Webflow, Next.js y React y HubSpot profundizan en cada caso.

Probar el marcado en los sistemas de búsqueda

Pruebe la página renderizada, no la plantilla. El Schema Markup Validator revisa la validez del vocabulario, y la Prueba de resultados enriquecidos de Google revisa la elegibilidad para las funciones que Google admite, que aquí significa Negocio local y Ruta de navegación. Ninguna de las dos herramientas garantiza que algo se vaya a mostrar. El validador de schema de Schema Nova puede revisar un bloque pegado, y la comparación entre la Prueba de resultados enriquecidos y el validador explica cuándo usar cada uno.

Después de publicar, inspeccione la página en vivo en Google Search Console y en Bing Webmaster Tools. La herramienta de inspección de URL en Bing Webmaster Tools incluye una tarjeta «Markup» (marcado) que puede inspeccionar JSON-LD y otro marcado reconocido. Use el validador de Yandex cuando le importe la visibilidad en Yandex. Actualice el marcado cada vez que cambie el anuncio visible.

Orden de configuración para el marcado inmobiliario

  1. Nombre la páginaDecida si es la inmobiliaria, un perfil de agente, un anuncio o un artículo, y luego elija el tipo más específico.
  2. Escriba los datos visiblesAgregue solo datos que muestre la página y conecte las entidades con valores @id estables.
  3. Agregue el JSON-LDUse el campo o la plantilla que admita su plataforma y evite duplicar lo que la plataforma ya genera.
  4. Valide el códigoRevise la sintaxis JSON y el vocabulario de Schema.org con el Schema Markup Validator.
  5. Inspeccione la página en vivoEjecute la Prueba de resultados enriquecidos para Negocio local y Migas de pan, luego inspeccione en Google Search Console y Bing Webmaster Tools.
  6. Manténgalo actualizadoActualice el marcado cada vez que cambie el anuncio visible, incluidos el precio y la disponibilidad.

Mantener abiertas las páginas de anuncios a los rastreadores de búsqueda con IA

OpenAI dice que un sitio web debe permitir a OAI-SearchBot rastrearlo para ser elegible para su inclusión en la búsqueda de ChatGPT, y que la aparición en la búsqueda no está garantizada. Su documentación de rastreadores separa OAI-SearchBot, que se usa para la búsqueda, de GPTBot, que se usa para un posible uso en entrenamiento. Perplexity describe la búsqueda web como recuperar, leer y sintetizar fuentes.

Google dice que sus AI Overviews y AI Mode no tienen requisitos técnicos adicionales más allá de la elegibilidad normal para la Búsqueda de Google. Para las experiencias con tecnología de Bing, use el manejo de datos estructurados de Bing y la inspección en Bing Webmaster Tools. Ningún marcado garantiza citas, así que mantenga las páginas públicas de anuncios rastreables, con datos completos y actuales de la propiedad en el texto visible. La guía de búsqueda con IA cubre el panorama más amplio.

Preguntas frecuentes

¿Google garantiza un resultado enriquecido cuando el marcado valida?

No. Google dice que el marcado válido no garantiza un resultado enriquecido ni una mejora de posicionamiento, y que la visualización queda a su criterio. Una prueba aprobada confirma el análisis o la elegibilidad para una función, lo cual es distinto de que el resultado se muestre.

¿Cómo debe manejar el marcado de un anuncio un precio que cambió?

Cambie el precio visible y el valor de price en Offer juntos, y actualice availability cuando cambie el estatus. El marcado que no coincide con la página entra en conflicto con la regla de Google de que los datos estructurados describan el contenido visible.

Bing dice que admite JSON-LD de Schema.org y que usa los datos estructurados para entender el contenido de la página. Yandex documenta JSON-LD y un validador, y dice que no todos los tipos de Schema.org son compatibles. Para la búsqueda de ChatGPT, OpenAI dice que la elegibilidad depende de permitir OAI-SearchBot, con la aparición no garantizada.

¿Qué problemas de vivienda justa aplican a las descripciones de anuncios?

Las reglas de publicidad de HUD identifican palabras, frases y símbolos que pueden transmitir preferencias o limitaciones discriminatorias, y las leyes estatales y locales pueden agregar reglas. Describa datos objetivos de la propiedad y consulte con un profesional calificado en vivienda la redacción que no tenga clara.

Comprobación rápida

Elija una respuesta para ver comentarios. Nada se califica ni se guarda.

Pregunta 1 de 3

¿Qué tipo describe la vivienda física en una página de anuncio?

Pregunta 2 de 3

¿Qué propiedad vincula el nodo Person de un agente empleado con la inmobiliaria?

Pregunta 3 de 3

¿Puede el marcado contener un precio que no es visible en la página?

Glosario

Seleccione un término para ver su definición.

RealEstateAgent. Un tipo de Schema.org para un agente o una agencia inmobiliaria, y subtipo de LocalBusiness y Organization.