Back to Flow Platform

Listing API

For Link-Out advanced or API integrations, listings can be individually added to flow through the listing API.

This allows a just-in-time listing creation and publishing, without needing to wait for a feed synchronisation cycle to complete.

The Listing API requires authentication, using the Client ID and the API Key provided by your Flow account manager. Once authenticated, a listing can be created on the process-listing endpoint

Authentication

GET https://api.flowliving.com/auth/access-key/publickey?organisationId={{Client ID}}&apiKey={{API Key}}&requestType=propertyAPI

This endpoint will return the authentication token to be used in the following listing creation calls

Response

{
    "accessToken": "…"
}

Create a new listing

POST https://api.flowliving.com/v3/properties-api/process-listing?organisation={{Client ID}}

The listing API accepts a POST request with the body structured according to the standard listing used in the feed configuration

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <accessToken>

Accept-version

v1

Response

The below body example uses a Flow CSV example with a property listing structure

Response

Last updated