Two POST endpoints to start and monitor imports. An API key is required. Imports run asynchronously — after /start, poll status with /latest-log.
POST /rest-api/import/start → import-in-queue.POST /rest-api/import/latest-log until completed.curl -X POST 'https://realistimo.com/rest-api/import/start' \
-H 'Accept: application/json' \
-H 'API-KEY: YourApiKeyHere'
curl -X POST 'https://realistimo.com/rest-api/import/latest-log' \
-H 'Accept: application/json' \
-H 'API-KEY: YourApiKeyHere'<updated> (unchanged value skips the feed).<last_update> on changed offers.POST /start. On cooldown or an in-progress import, wait and retry./latest-log and fix offers with errors.API-KEY (recommended)apikey| Response | When |
|---|---|
| HTTP 401 | Missing or empty API key |
{"status":"error","message":"API key could not be found"} | Unknown key |
{"status":"error","message":"API key is inactive"} | Disabled key |
{"status":"error","message":"API key is expired"} | Expired key |
{"status":"error","message":"User is inactive"} / User account is expired | User account issue |
POST /rest-api/import/start| message | Meaning |
|---|---|
import-in-queue | Accepted; import is queued or already waiting |
import-is-allowed-between-the-time | Outside the 08:00–20:59 window (server time) |
import-in-progress | An import is already running |
import-request-cooldown-is-time-given | Wait 30 minutes between requests (production) |
error-while-importing | No feed configured for the agency |
error: Agency not found | Key is not linked to an agency |
POST /rest-api/import/latest-logmessage is the import status: pending | in_progress | completed (or null if none yet). When a log is available: logDate, logResult, logOffers (uuid, createdAt, errors, offerSourceData).
{
"message": "completed",
"logDate": "2024-09-18T01:51:14+03:00",
"logResult": { "found_offers": 228, "updated_offers": 228, "not_published": 10 },
"logOffers": [{ "uuid": "…", "errors": [], "offerSourceData": { "offer_uid": "2080525" } }]
}<updated>): XML specificationresult_url)After import, Realistimo POSTs latest-log-shaped JSON to the XML result_url. Failed callbacks are not automatically retried.
Let Realistimo track for you instead
😃 Install the app and we'll notify you first when a suitable listing appears.
Stay updated on what's new in real estate, statistics, and news from Realistimo, without spam:
