Saved list items

Inspect the items stored inside a saved list.

The saved list item model

Saved list items are snapshots of a spot at the time it was saved. Use them to sync saved content to external tools.

Properties

Name
id
Type
integer
Description
Unique identifier for the saved item.
Name
list_id
Type
integer
Description
Identifier of the saved list that contains this item.
Name
spot_url
Type
string
Description
Canonical spot URL on Twentybaan.
Name
title
Type
string|null
Description
Spot title at time of save.
Name
location
Type
string|null
Description
Location string at time of save.
Name
price_text
Type
string|null
Description
Rendered price label at time of save.
Name
beds_text
Type
string|null
Description
Beds label at time of save.
Name
area_sqm
Type
integer|null
Description
Floor area in square meters when available.
Name
image_url
Type
string|null
Description
Primary image URL at time of save.
Name
created_at
Type
timestamp
Description
Timestamp of when the item was saved.

GET/v1/saved-list-items?list_id=:list_id

List saved list items

Retrieve items for a single saved list.

Required attributes

Name
list_id
Type
integer
Description
The saved list id to fetch items from.

Optional attributes

Name
limit
Type
integer
Description
Limit the number of items returned (default 50, max 200).
Name
before_id
Type
integer
Description
Return items with id less than this value.

Required scope

Tokens must include read:saved_list_items.

Request

GET

/v1/saved-list-items?list_id=12

curl -G https://api.twentybaan.com/v1/saved-list-items/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d list_id=12 \
  -d limit=10

GET

/v1/saved-list-items?list_id=12

const token = process.env.TWENTYBAAN_API_KEY;

const url = new URL("https://api.twentybaan.com/v1/saved-list-items/");
url.searchParams.set("list_id", "12");
url.searchParams.set("limit", "10");

const res = await fetch(url.toString(), {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
  },
});

if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());

GET

/v1/saved-list-items?list_id=12

type TwentybaanSavedListItem = {
  id: number;
  list_id: number;
  spot_url: string;
  title: string | null;
  location: string | null;
  price_text: string | null;
  beds_text: string | null;
  area_sqm: number | null;
  image_url: string | null;
  created_at: string;
};

type TwentybaanSavedListItemsResponse =
  | { ok: true; items: TwentybaanSavedListItem[]; next_before_id: number | null }
  | { ok: false; error: string };

const token = process.env.TWENTYBAAN_API_KEY!;

const url = new URL("https://api.twentybaan.com/v1/saved-list-items/");
url.searchParams.set("list_id", "12");
url.searchParams.set("limit", "10");

const res = await fetch(url.toString(), {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
  },
});

const data = (await res.json()) as TwentybaanSavedListItemsResponse;
if (!res.ok || !data.ok) throw new Error("Request failed");

console.log(data.items);

GET

/v1/saved-list-items?list_id=12

import os
import requests

token = os.environ["TWENTYBAAN_API_KEY"]

res = requests.get(
  "https://api.twentybaan.com/v1/saved-list-items/",
  headers={
    "Accept": "application/json",
    "Authorization": f"Bearer {token}",
  },
  params={"list_id": 12, "limit": 10},
  timeout=30,
)
res.raise_for_status()
print(res.json())

GET

/v1/saved-list-items?list_id=12

<?php

$token = getenv('TWENTYBAAN_API_KEY') ?: '';

$url = "https://api.twentybaan.com/v1/saved-list-items/" . '?' . http_build_query([
  'list_id' => 12,
  'limit' => 10,
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer " . $token,
  ],
]);

$body = curl_exec($ch);
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "HTTP {$status}\n";
echo $body;

GET

/v1/saved-list-items?list_id=12

using System;
using System.Net.Http;
using System.Net.Http.Headers;

var token = Environment.GetEnvironmentVariable("TWENTYBAAN_API_KEY") ?? "";
var url = "https://api.twentybaan.com/v1/saved-list-items/?list_id=12&limit=10";

using var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);

var res = await client.GetAsync(url);
var body = await res.Content.ReadAsStringAsync();

Console.WriteLine((int)res.StatusCode);
Console.WriteLine(body);

GET

/v1/saved-list-items?list_id=12

require "net/http"
require "json"

token = ENV.fetch("TWENTYBAAN_API_KEY")
uri = URI("https://api.twentybaan.com/v1/saved-list-items/")
uri.query = URI.encode_www_form({ list_id: 12, limit: 10 })

req = Net::HTTP::Get.new(uri)
req["Accept"] = "application/json"
req["Authorization"] = "Bearer #{token}"

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(req)
end

puts res.code
puts res.body

GET

/v1/saved-list-items?list_id=12

package main

import (
  "fmt"
  "io"
  "net/http"
  "net/url"
  "os"
  "time"
)

func main() {
  token := os.Getenv("TWENTYBAAN_API_KEY")

  u, err := url.Parse("https://api.twentybaan.com/v1/saved-list-items/")
  if err != nil {
    panic(err)
  }

  q := u.Query()
  q.Set("list_id", "12")
  q.Set("limit", "10")
  u.RawQuery = q.Encode()

  req, err := http.NewRequest("GET", u.String(), nil)
  if err != nil {
    panic(err)
  }

  req.Header.Set("Accept", "application/json")
  req.Header.Set("Authorization", "Bearer "+token)

  client := &http.Client{Timeout: 30 * time.Second}
  res, err := client.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()

  body, _ := io.ReadAll(res.Body)
  fmt.Println(res.Status)
  fmt.Println(string(body))
}

Response

{
  "ok": true,
  "items": [
    {
      "id": 345,
      "list_id": 12,
      "spot_url": "/listings/modern-condo-sukhumvit/",
      "title": "Modern condo near BTS",
      "location": "Bangkok • Sukhumvit",
      "price_text": "฿35,000 / month",
      "beds_text": "2",
      "area_sqm": 62,
      "image_url": "https://...",
      "created_at": "2026-01-06T03:12:00Z"
    }
  ],
  "next_before_id": null
}

GET/v1/saved-list-items?list_id=:list_id&id=:id

Retrieve a saved list item

Fetch a single item from a saved list.

Required attributes

Name
list_id
Type
integer
Description
Saved list id that owns the item.
Name
id
Type
integer
Description
Item id to retrieve.