PropDesc-AI Documentation - Getting Started

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: Click "Try Free Tier"

On oculix.io, click "Try Free Tier" or "Get Started" to open the signup form.

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 a POST request with whatever property details you have — there's no fixed schema, just a JSON object of attributes:

curl -X POST https://propdesc-api-885208777871.us-central1.run.app/v1/propdesc/generate \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "propertyAttributes": {
      "address": "1250 Oak Ridge Drive, Atlanta, GA",
      "beds": 4,
      "baths": 3,
      "sqft": 3200,
      "year_built": 2015,
      "lot_size": "0.5 acres"
    },
    "targetAudience": "investor",
    "locationArea": "in_town"
  }'
    

targetAudience and locationArea are both optional — omit either (or both) for the default neutral voice.

targetAudience: investor, primary_home_owner, commercial, or rental_tenant — shifts the description's focus (ROI language for investors, lifestyle language for homeowners, and so on).
locationArea: in_town, suburbs, or rural — shifts which surroundings get emphasized (walkability vs. schools vs. privacy).

The Response

This is the real, live endpoint — same one the widget below calls. You get the generated description directly in the response, synchronously, no polling:

{
  "status": "success",
  "generatedListing": "Welcome to this stunning 4-bedroom, 3-bath home in Oak Ridge. Built in 2015, this 3,200 sq ft residence sits on a half-acre lot..."
}
    

PropDesc-AI writes from exactly the attributes you send — it doesn't invent details you didn't provide. More attributes in, more specific copy out.

Usage Limits

Each call generates one description. Your plan sets how many you can generate per month:

      Free Tier: 5 descriptions/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

Troubleshooting

Q: "Invalid API Key" Error

A: Re-copy the key from your original verification email — it's only shown once and there's no Settings page to view it again yet. Make sure there are no extra spaces. API keys are case-sensitive.

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: Key rotation isn't self-serve yet — contact support to have your key reissued.

Next Steps

Batch generation: on the roadmap — not live yet. Every call today generates one description at a time.
Usage tracking: call GET /v1/usage on the auth service with your x-api-key header 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.

Ready to try it? Start with 5 free descriptions to test. No credit card. Upgrade when you're ready.

Subscribe: Growth $59/mo → Subscribe: Scale $249/mo →

← Back to Home

🏠 PropDesc-AI Getting Started