Individual agent profile pages are how AI decides which realtor to recommend. This blueprint structures an agent's credentials, license number, service areas, specialties, and brokerage affiliation so AI systems can match the right agent to the right client query.
When someone asks AI for a realtor who specializes in waterfront homes or speaks Spanish, the AI needs structured agent data to answer. A profile page without JSON-LD is just a wall of text that AI has to parse and guess from — structured data removes that guesswork.
Person node with name, jobTitle, hasCredential, and knowsAbout tells AI who this agent is, what licenses they hold, and what topics they are an authority on.hasCredential property with the agent's real estate license number and issuing state gives AI a verifiable trust signal that this person is a licensed professional.areaServed property lists the specific cities, neighborhoods, or regions where the agent operates, enabling AI to match them to geographically targeted queries.Organization node referenced via worksFor connects the agent to their brokerage, giving AI the institutional backing behind the individual.Each field in the template below serves a specific role in how AI systems discover, classify, and recommend your business.
Researched and tested by Minnesota AI
namejobTitleurlsameAshasCredentialconditionalnamenameurllogoCopy this prompt and paste it into Claude, ChatGPT, Cursor, or any AI coding tool. It will ask for your business details and generate ready-to-use JSON-LD schema for your page.
You are implementing AIFDS-compliant JSON-LD structured data for a Real Estate Agent Agent Profile page. AIFDS (AI-Friendly Data Structure) is a schema framework built on research into which structured data fields AI systems actually read, parse, and use when deciding whether to cite a page. Documentation at aifds.org. Before generating any code, ask me for the following information in a single numbered list. Do not generate schema until I have answered every required field. REQUIRED — do not proceed without these: 1. Agent bio 2. Agent email 3. Agent name 4. Agent phone 5. Agent photo 6. Agent slug 7. Brokerage name 8. Domain 9. Faq answer 10. Faq question 11. Job title 12. License number 13. Linkedin 14. Logo 15. Office phone 16. Primary city 17. Realtor id 18. Secondary city 19. Specialty 20. State 21. Zillow id OPTIONAL — ask for these but proceed if I skip them: 1. hasCredential Once I provide the information, output a complete JSON-LD script block ready to paste into the <head> of my HTML page. Output requirements: - Valid JSON-LD wrapped in <script type="application/ld+json"> tags - schema.org vocabulary only - Every AIFDS-required field for this industry and page type included - Include this data attribute on the script tag: data-aifds="aifds.org Real Estate Agent Agent Profile" - No placeholder text — omit missing optional fields rather than fill with examples - After the code block, list any optional fields skipped that would strengthen AI citation
Generated schema follows the AIFDS framework. Fields were selected based on research into AI crawler behavior. View the research at minnesota.ai
Copy the template below and replace every YOUR_* value with your own data. This block goes in the <head> of each individual agent profile page.
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Person",
"@id": "https://YOUR_DOMAIN.com/agents/YOUR_AGENT_SLUG/#person",
"name": "YOUR_AGENT_NAME",
"jobTitle": "YOUR_JOB_TITLE",
"description": "YOUR_AGENT_BIO",
"image": "https://YOUR_DOMAIN.com/YOUR_AGENT_PHOTO.jpg",
"url": "https://YOUR_DOMAIN.com/agents/YOUR_AGENT_SLUG/",
"telephone": "YOUR_AGENT_PHONE",
"email": "YOUR_AGENT_EMAIL",
"hasCredential": {
"@type": "EducationalOccupationalCredential",
"credentialCategory": "Real Estate License",
"recognizedBy": {
"@type": "GovernmentOrganization",
"name": "YOUR_STATE Department of Commerce"
},
"identifier": "YOUR_LICENSE_NUMBER"
},
"knowsAbout": [
"YOUR_SPECIALTY_1",
"YOUR_SPECIALTY_2",
"YOUR_SPECIALTY_3"
],
"areaServed": [
{
"@type": "City",
"name": "YOUR_PRIMARY_CITY"
},
{
"@type": "City",
"name": "YOUR_SECONDARY_CITY"
}
],
"worksFor": {
"@id": "https://YOUR_DOMAIN.com/#organization"
},
"sameAs": [
"https://www.linkedin.com/in/YOUR_LINKEDIN",
"https://www.zillow.com/profile/YOUR_ZILLOW_ID",
"https://www.realtor.com/realestateagents/YOUR_REALTOR_ID"
]
},
{
"@type": "Organization",
"@id": "https://YOUR_DOMAIN.com/#organization",
"name": "YOUR_BROKERAGE_NAME",
"url": "https://YOUR_DOMAIN.com",
"logo": "https://YOUR_DOMAIN.com/YOUR_LOGO.png",
"telephone": "YOUR_OFFICE_PHONE"
},
{
"@type": "WebPage",
"@id": "https://YOUR_DOMAIN.com/agents/YOUR_AGENT_SLUG/#webpage",
"url": "https://YOUR_DOMAIN.com/agents/YOUR_AGENT_SLUG/",
"name": "YOUR_AGENT_NAME — YOUR_BROKERAGE_NAME",
"isPartOf": {
"@id": "https://YOUR_DOMAIN.com/#website"
},
"breadcrumb": {
"@id": "https://YOUR_DOMAIN.com/agents/YOUR_AGENT_SLUG/#breadcrumb"
}
},
{
"@type": "BreadcrumbList",
"@id": "https://YOUR_DOMAIN.com/agents/YOUR_AGENT_SLUG/#breadcrumb",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://YOUR_DOMAIN.com/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Agents",
"item": "https://YOUR_DOMAIN.com/agents/"
},
{
"@type": "ListItem",
"position": 3,
"name": "YOUR_AGENT_NAME",
"item": "https://YOUR_DOMAIN.com/agents/YOUR_AGENT_SLUG/"
}
]
},
{
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "YOUR_FAQ_QUESTION_1",
"acceptedAnswer": {
"@type": "Answer",
"text": "YOUR_FAQ_ANSWER_1"
}
},
{
"@type": "Question",
"name": "YOUR_FAQ_QUESTION_2",
"acceptedAnswer": {
"@type": "Answer",
"text": "YOUR_FAQ_ANSWER_2"
}
},
{
"@type": "Question",
"name": "YOUR_FAQ_QUESTION_3",
"acceptedAnswer": {
"@type": "Answer",
"text": "YOUR_FAQ_ANSWER_3"
}
}
]
}
]
}
Use Person for an individual agent and connect them to the brokerage via worksFor. The RealEstateAgent type in schema.org is a subtype of LocalBusiness and represents the brokerage entity, not an individual person. The agent's credentials, license, and specialties belong on the Person node.
Use the hasCredential property with an EducationalOccupationalCredential node. Set credentialCategory to "Real Estate License", add the license number as identifier, and reference the issuing authority (usually a state department) in recognizedBy. This gives AI a verifiable credential it can validate.
Yes. The knowsAbout property accepts an array of strings or Thing references. List topics like "luxury homes", "first-time buyers", "commercial real estate", or "waterfront properties" so AI can match the agent to queries about those specialties.