0%
SnapListly

SnapListly API

Same reference as api.snaplistly.com. For agencies that already run listing software.

Send room photos. Get a listing draft back as JSON: a short overview, a long description, one text per room, and tags.

Who it is for, and why

Broker platforms, agency CRMs and listing apps that already store photos. You keep the client. SnapListly writes the description, the same draft the agent sees after Analyze, without a second vision pipeline.

What the request means

One call is one property. Photos are the evidence. The other fields set the market, the language of the text, and whether to answer now or queue the job.

FieldMeaning
photos[]1–40 JPEG or PNG room shots. Required.
titleProject name on the agency account. Required. Unique for that account.
addressProperty address. Required. The plan zone comes from this address.
langLanguage of the returned text, for example en or pl.
modenow waits. queue saves the project and finishes later.
qualityfast is shorter. full is the longer listing text.
type, price, area, yearFacts stored with the listing. They do not replace the photos.

API key

The key belongs on the agency server. Never in a public page and never in a phone app.

Authorization: Bearer

Issue the key in Agency, under My details. It is stored as a hash and works for the domain you enter. A new key turns the previous one off. The key is also emailed to the account address, or to a client email already stored for this agent. The message includes the domain and a curl example. A call from another website is rejected.

Client request

Live URL: POST https://agency.snaplistly.com/analyze.php

curl -sS https://agency.snaplistly.com/analyze.php \
  -H "Authorization: Bearer $SNAPLISTLY_API_KEY" \
  -F "title=Ocean Drive house" \
  -F "lang=en" \
  -F "mode=now" \
  -F "quality=full" \
  -F "address=1200 Ocean Drive, Miami Beach, FL, USA" \
  -F "type=House" \
  -F "price=890000 USD" \
  -F "photos[]=@living.jpg" \
  -F "photos[]=@kitchen.jpg"

Response

mode=now returns the draft in result. shareUrl is the page the client can open.

{
  "lang": "en",
  "quality": "full",
  "mode": "now",
  "photoCount": 2,
  "savedId": 1042,
  "shareUrl": "https://agency.snaplistly.com/s/EXAMPLE",
  "result": {
    "shortOverview": "A bright house a short walk from the beach.",
    "overallDescription": "Longer listing text, in the requested language.",
    "rooms": [
      {"name": "Living room", "description": "What is visible in that room."},
      {"name": "Kitchen", "description": "What is visible in that room."}
    ],
    "tags": ["house", "bright", "kitchen"]
  }
}

mode=queue does not wait. The description is filled in later.

{
  "queued": true,
  "jobId": 88,
  "savedId": 1042,
  "mode": "queue",
  "quality": "fast",
  "photoCount": 2,
  "message": "Project saved. Job queued."
}

Errors

Errors are JSON too: {"error":"..."}. 400 missing photos or address. 401 no session and no valid key. 403 the plan does not cover this zone or the limits are too small. 409 this account already has that project name.

SnapListly agency · api.snaplistly.com