🏠 PropDesc-AI Getting Started
AI-powered property description generator for real estate platforms. Create compelling listing copy in seconds, not hours.
What is PropDesc-AI?
PropDesc-AI turns property attributes (beds, baths, square footage, and whatever other details you have) into a ready-to-publish listing description. One API call in, real generated copy out.
It's metadata-only — PropDesc-AI never sees photos or processes file uploads. Just the facts you give it.
Sign Up (Free)
Getting started takes under a minute — no password required:
Step 1: Sign Up
Get your free API key in 30 seconds. No credit card required.
Free API keys are valid for 14 days, and each free account can create one free replacement key. Paid plans’ keys do not expire.
Step 2: Enter Your Name and Email
No credit card, no password. Just your name and email.
Step 3: Verify Your Email
We'll send a verification link to your inbox. Click it to activate your account — no password to set.
Step 4: Copy Your API Key
Your key is shown once on the verification page — copy it right away. Use it as the x-api-key header on every request.
Generate Your First Description
You can also just use the live widget below instead of calling the API directly.
The Request
Send structured facts about the property, plus optional controls for purpose, tone, channel and emphasis. PropDesc-AI writes only from the facts and features you provide.
curl -X POST https://api.propdescai.io/v1/propdesc/generate \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"propertyAttributes": {
"address": "1250 Oak Ridge Drive",
"city": "Atlanta", "state": "GA",
"beds": 4, "baths": 3, "sqft": 3200, "yearBuilt": 2015,
"amenities": ["garage", "fenced yard", "updated kitchen"]
},
"controls": {
"listingPurpose": "sale",
"tone": "polished",
"channel": "mls",
"length": 100,
"emphasis": ["layout", "kitchen"]
}
}'
- propertyAttributes (required):
beds,baths,sqft,yearBuilt,stories,parkingSpaces,lotSqft,hoaMonthly,address,city,state,zip,propertyType,recentUpdates([{"item","year"}]), andamenitieschosen from a fixed list (garage, patio, fenced yard, hardwood floors, updated kitchen, and similar). Unknown fields are ignored and reported inignoredFields. - controls (optional):
listingPurpose(sale,rent,investment,open_house),readerGoal(move_in_ready,low_maintenance,work_from_home_space,entertaining_outdoor,commute_access,value_focused,investment_returns),tone,channel,length(50, 100, 200 or 300),emphasis(up to 3), andlanguageLevel. These describe the listing, never who it is for. - verifiedPoi (optional): places you have verified, each with
name,category(transit, park, grocery, trail, and similar),distanceMilesandsource. Location lines are written only from these. - additionalContext (optional, up to 500 characters): wording preferences only. Facts come from
propertyAttributes. targetAudienceandlocationAreawere retired. They are ignored, and the response says so.
The Response
This is the real, live endpoint, the same one the widget below calls. You get the generated description synchronously, with no polling:
{
"status": "success",
"generatedListing": "This 4-bedroom, 3-bath home offers 3,200 square feet and was built in 2015...",
"disclosure": "Review before publishing. Agent is responsible for compliance with fair housing laws.",
"rulesVersion": "2026-10-14.1"
}
What PropDesc-AI will not write
Every listing is screened before it is returned. PropDesc-AI does not describe the people a property might suit, and it does not comment on a neighborhood's character, safety, or schools. A draft that fails the checks, or that states a feature or number you did not provide, is not returned and does not use a credit. It is an aid, not legal advice: you are responsible for reviewing every listing for compliance with federal, state and local fair housing law before you publish it.
Usage Limits
Each call generates one description. Your plan sets how many you can generate per month:
Agent Tier ($59/mo): 100 descriptions/month
Brokerage Tier ($249/mo): 1,000 descriptions/month
Common Use Cases
Weekly Listing Batch
Every new listing gets a call to PropDesc-AI instead of an hour with a copywriter.
Relisting Refresh
A property didn't sell. Regenerate the description with slightly different attributes emphasized — fresh copy, same property, better chance.
Cost Comparison
A single professionally written listing description typically runs $50–100 from a copywriter. PropDesc-AI's Agent tier ($59/mo for 100 descriptions) pays for itself after the first one.
Pricing
| Plan | Descriptions/Month | Cost | Best For |
|---|---|---|---|
| Free | 5 | $0 | Testing, individual agents |
| Agent | 100 | $59/month | Active agents, regular listings |
| Brokerage | 1,000 | $249/month | Brokerages, high listing volume |
Free API keys are valid for 14 days, and each free account can create one free replacement key. Paid plans’ keys do not expire.
Troubleshooting
Q: "Invalid API Key" Error
A: Your API key is shown once, on your dashboard right after you verify your email, and we can’t display it again. If it’s lost, enter your email in the sign-up form on this page and we’ll email a one-time sign-in link to create a replacement. Otherwise check for extra spaces; API keys are case-sensitive.
Q: My Key Stopped Working: “API key expired”
A: Free API keys are valid for 14 days from the day they are issued, and calls with an expired key return 401 “API key expired”. We email a reminder during the key’s first week (you can unsubscribe from reminders). To keep going, enter your email in the sign-up form on this page to create your one free replacement key. After that replacement expires, upgrade to a paid plan to keep using PropDesc-AI. Paid plans’ keys do not expire.
Q: Generated description sounds generic
A: Add more attributes. PropDesc-AI only writes from what you send it — the more specific detail in propertyAttributes, the more specific the output.
Q: Can I control tone or writing style?
A: Not yet — every description is generated in the same factual, professional style today. Style/tone selection (luxury, casual, investment-focused) is on the roadmap but not live.
Q: How Do I Update My API Key?
A: Enter your email in the sign-up form on this page. We email a one-time sign-in link (valid for 30 minutes) that lets you create a new key. The new key replaces the old one immediately, so update every app that uses it. Free accounts can create one free replacement key; once it is used, upgrade to a paid plan to keep going. Paid plans can replace their key at any time.
Next Steps
- Batch generation: on the roadmap — not live yet. Every call today generates one description at a time.
- OpenAPI spec: /docs/propdesc/openapi.json (OpenAPI 3.0, for client generators and API tools).
- Usage tracking: call
GET /v1/usageon the auth service with yourx-api-keyheader for your remaining quota and a call-count breakdown by endpoint. A full self-serve dashboard is still on the roadmap. - Upgrade to Agent or Brokerage tier when you're ready to scale past the free tier.