Matchai Docs

Reorder a site’s listingsComing soon

Puts the site’s listings in a new order. Send every listing on the site.

Coming soon. This is documented ahead of launch so you can plan your integration; it is not available yet.
PUT
/sites/{site_id}/listings

Coming soon. Puts the site’s listings in a new order. Send every listing on the site.

Scopes: sites:write

Pricing: Included with the connection.

Authorization

headerAuthorizationBearer <matchai_<base62>>

A personal API key, sent as Authorization: Bearer matchai_…. Create keys in Matchai under Settings → Connectors → Advanced (for developers). A key starts with matchai_ followed by letters and digits, carries the scopes chosen when it was created, and can be revoked at any time. Keys reach only the account that created them: to serve other professionals, use Connect with Matchai.

Scope: sites:write

Path Parameters

site_id*string

Site id.

Length1 <= length <= 64

Request Body

application/json
  1. body
listing_ids*array<>

EVERY listing on the site, in the new order.

Items1 <= items

Response Body

Listings on the site, in the new order.

application/json
  1. response
data*array<>

In site order.

Example Request
curl -X PUT 'https://api.matchai.co/v1/sites/string/listings' \  -H 'Content-Type: application/json' \  -d '{  "listing_ids": [    "string"  ]}'
Example Response
{  "data": [    {      "listing": {        "id": "string",        "slug": "string",        "url": "http://example.com",        "title": "string",        "status": "draft",        "availability": "available",        "price": {          "amount": 1,          "currency": "string"        },        "city": "string",        "neighbourhood": "string",        "bedrooms": 0,        "bathrooms": 0,        "cover_image_url": "http://example.com"      },      "featured": true,      "position": 0,      "added_at": "2019-08-24T14:15:22Z"    }  ]}