AI Listing Generation

Category: Selling & Developers Last updated: 2026-07-12

Owning's AI listing generation feature analyzes your photos and automatically creates a complete listing draft — title, description, category, price estimate, condition, tags, and attributes. It's the fastest way to go from "I have something to sell" to a published listing.

How it works

The AI generate flow is image-first: you upload photos first, then let the AI do the heavy lifting.

1. Upload photos of your item in the sell wizard
2. Click "Generate with AI"
3. The AI analyzes your images and returns a structured draft:

• Title — specific and descriptive
• Description — a detailed write-up
• Category — automatically detected
• Estimated price range — min, max, and currency
• Condition — assessed from the photos
• Tags — relevant keywords
• Attributes — brand, model, color, type, and more

1. Review and edit the pre-filled fields
2. Publish when you're satisfied

Generation takes about 8–12 seconds. You'll see a progress indicator while it works.

Using AI generate in the sell wizard

The sell wizard at owning.pro/sell has AI generate built in. After uploading photos, click the "Generate with AI" button. The wizard will show loading stages ("Analyzing your photos…", "Identifying the item…", "Writing a description…", "Estimating a fair price…") and then populate the form fields.

If AI generate fails or you'd rather fill in details yourself, click "Fill manually" to switch to the standard form.

Using AI generate via the API

Developers can use the AI generate endpoint directly:

curl -X POST https://api.owning.pro/api/listings/ai-generate \
  -H "Authorization: Bearer <your_jwt_token>" \
  -H "Content-Type: application/json" \
  -d '{"images": ["https://example.com/your-image.jpg"]}'

The response includes all the draft fields:

{
  "title": "Canon EOS Rebel T3i DSLR Camera",
  "description": "Detailed description...",
  "category": "electronics",
  "estimatedPriceRange": { "min": 150, "max": 300, "currency": "EUR" },
  "condition": "good",
  "tags": ["canon", "dslr", "camera"],
  "attributes": { "brand": "Canon", "model": "EOS Rebel T3i" }
}

Note: AI generate requires JWT authentication (not API keys). Log in via POST /api/auth/login to get a JWT token first.

Rate limiting

AI generation is limited to 5 requests per hour per user. This limit is enforced at the database level using a sliding UTC hour window.

If you exceed the limit, you'll receive a 429 response:

{
  "error": {
    "code": "rate_limited",
    "message": "Limit exceeded for ai_generate. Limit: 5/hour."
  }
}

In the sell wizard, you'll see: "You've used all 5 AI generations this hour. Try again later or fill manually."

How the AI works

Owning uses Claude (via OpenRouter) as the vision model. The AI receives your images and returns structured JSON that's validated against our schema before being presented to you. The AI doesn't publish anything — you always review and approve the draft before it goes live.

Tips for best results

• Use clear, well-lit photos — the AI analyzes what it can see
• Show the whole item in at least one photo
• Include close-ups of brand labels or model numbers for accurate attributes
• Avoid cluttered backgrounds — they can confuse the AI
• One item per listing — if you're selling multiple items, create separate listings

Limitations

• AI generate works with any publicly accessible image URL
• The estimated price range is a suggestion — always review it against your knowledge of the item
• AI generate is currently available for the sell wizard and the API (not the MCP server)

See the Image-First Listing Guide for full technical details.