SnapListly API
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.
| Field | Meaning |
|---|---|
photos[] | 1–40 JPEG or PNG room shots. Required. |
title | Project name on the agency account. Required. Unique for that account. |
address | Property address. Required. The plan zone comes from this address. |
lang | Language of the returned text, for example en or pl. |
mode | now waits. queue saves the project and finishes later. |
quality | fast is shorter. full is the longer listing text. |
type, price, area, year | Facts 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