← ScrollToBuy

Developer property feed guide

← Agency connection options

This guide describes the supported CSV/JSON import and inbound JSON feed. Jupix XML cannot be sent directly to this endpoint; a separate importer must be arranged and tested.

Upload an export from your agency software rather than retyping each property. Use an account belonging to the agency authorised to market the homes.

Import a CSV or JSON export

  1. Sign in to your estate-agent workspace and complete your agency contact details.
  2. Download the CSV template and replace the example row with your own authorised property information. Use a stable, unique reference for each home.
  3. Choose the file in Import your properties. Review the preview and correct any invalid rows.
  4. Confirm permission, then import. The result identifies successful and failed rows. Properties from agencies awaiting approval stay as drafts.

CSV and JSON imports accept up to 250 properties and 2 MB per request. Matching references update the same agency’s previously imported home. A reference belonging to another agency cannot update that agency’s listing. Missing properties are not removed: send a deliberate status change when a home is no longer available.

Core fields

FieldMeaning
referenceRequired stable agency property reference.
title, area, address, descriptionRequired accurate marketing details.
price, bedrooms, typeTotal asking price, whole-number bedrooms (0 for studio), and house, flat, studio or bungalow.
statusdraft, available, under-offer, sold-stc or sold. Omitted status defaults to draft.
postcode, tenureOptional additional property details.
image, websiteOptional public HTTPS links. Image permission remains the agency’s responsibility.
parking, gardentrue/false or yes/no. Confirm features from the property information.
latitude, longitudeOptional accurate coordinate pair used for map search.

Automated JSON feed

A secure inbound endpoint is provided for agencies or their software providers to connect after a feed token has been issued. It is not a pre-authorised connection to every CRM. Your provider must support sending the format below, and the ScrollToBuy team must activate your agency’s feed access.

POST https://www.scrolltobuy.co.uk/api/crm-feed
Content-Type: application/json
Authorization: Bearer YOUR_PRIVATE_AGENCY_FEED_TOKEN

{"properties":[{
  "reference":"YOUR-REFERENCE-001",
  "title":"Authorised property title",
  "price":250000,
  "bedrooms":3,
  "area":"Chester",
  "address":"Actual property address",
  "description":"Authorised property description.",
  "type":"house",
  "status":"draft"
}]}

Keep feed tokens on your provider’s server. Never add one to a public website, screenshot or browser script. Request revocation if a token is exposed. Feed responses return one outcome per property; retain those outcomes and use the same references when retrying.

Connecting your agency software

For Reapit, Alto, Street or another provider, send our team the provider name and ask the provider whether it supports an authorised export or custom feed. Credentials, access permissions and any provider charges must be agreed before a direct connection can be activated. Contact info@scrolltobuy.co.uk.