storefront

List playlists (public storefront catalog)

PUBLIC endpoint — NO authentication required. Company is resolved from the request subdomain. Returns only live playlists: active == true (inactive/ draft playlists are excluded). Cursor-paginated. Supports lang, q, filter[country], filter[language], and sort.

The same payload is available at /home/libraries.json on the storefront domain for AEO crawlers. canonical_url always points at the /home/libraries/:slug path family on the primary store domain.

GET

api

v202604

playlists

List playlists (public storefront catalog)

curl --request GET \
  --url https://api.fluid.app/api/v202604/playlists

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/v202604/playlists",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/v202604/playlists"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/v202604/playlists")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "status": 200,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  },
  "playlists": [
    {
      "id": 3812,
      "slug": "primex-wellness-playlist",
      "title": "Primex Wellness Playlist",
      "description": "A curated collection of wellness resources for Primex members.",
      "image_url": "https://cdn.fluid.app/libraries/3812.png",
      "canonical_url": "https://acme.fluid.app/home/libraries/primex-wellness-playlist",
      "images": {
        "thumb": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
          "width": 600
        },
        "medium": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
          "width": 600
        },
        "large": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
          "width": 600
        }
      },
      "active": true,
      "status": "published",
      "publish_at": null,
      "seo": {
        "title": "Summer Sale — Up to 40% Off",
        "description": "Shop the July clearance event before it ends.",
        "image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/seo/9215.png",
        "block_crawler": false,
        "id": 9215
      },
      "metafields": [
        {
          "namespace": "custom",
          "key": "material",
          "value": "<unknown>",
          "value_type": "single_line_text_field",
          "description": "The primary material used in this product",
          "created_at": "2026-05-01T12:00:00Z",
          "updated_at": "2026-05-01T12:00:00Z",
          "locked": false
        }
      ],
      "languages": [
        "en",
        "fr"
      ],
      "kind": "manual",
      "countries": [
        "GB",
        "US"
      ],
      "total_items_count": 5,
      "library_items": [
        {
          "id": 123,
          "relateable_type": "<string>",
          "relateable_id": 123,
          "order": 123
        }
      ]
    }
  ]
}

{
  "error": {
    "message": "<string>",
    "details": {}
  },
  "status": 123,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  }
}

{
  "error": {
    "message": "<string>",
    "details": {}
  },
  "status": 123,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  }
}

Query Parameters

lang

string

ISO locale code. Defaults to the store's default locale. Falls back to en for missing translations.

string

Free-text search over title and description (Elasticsearch).

page[cursor]

string

Opaque Rotulus cursor from the previous response's meta.pagination.next_cursor.

page[limit]

integer

default:25

Page size. Default 25, max 100; a larger value returns 422.

Required range: 1 <= x <= 100

filter[country]

string

ISO-2 country code. Returns unrestricted playlists plus those restricted to this country.

filter[language]

string

ISO locale. Restricts to playlists translated in this locale.

sort

enum<string>

Sort axis. Prefix - for descending. Default is -created_at.

Available options:

title,

-title,

created_at,

-created_at

Response

A page of live playlists.

Shared success envelope for list / show / create / update responses: the resource payload is returned alongside a top-level integer status and meta. Composed onto each resource response via allOf.

status

integer

required

Example:

200

meta

object

required

Response metadata included on every successful response body. request_id and timestamp are always present; list endpoints also add pagination.

Show child attributes

playlists

object[]

required

Show child attributes

Public Page by slug

Show a playlist (public, by slug)

List playlists (public storefront catalog)

curl --request GET \
  --url https://api.fluid.app/api/v202604/playlists

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/v202604/playlists",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/v202604/playlists"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/v202604/playlists")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "status": 200,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  },
  "playlists": [
    {
      "id": 3812,
      "slug": "primex-wellness-playlist",
      "title": "Primex Wellness Playlist",
      "description": "A curated collection of wellness resources for Primex members.",
      "image_url": "https://cdn.fluid.app/libraries/3812.png",
      "canonical_url": "https://acme.fluid.app/home/libraries/primex-wellness-playlist",
      "images": {
        "thumb": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
          "width": 600
        },
        "medium": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
          "width": 600
        },
        "large": {
          "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
          "width": 600
        }
      },
      "active": true,
      "status": "published",
      "publish_at": null,
      "seo": {
        "title": "Summer Sale — Up to 40% Off",
        "description": "Shop the July clearance event before it ends.",
        "image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/seo/9215.png",
        "block_crawler": false,
        "id": 9215
      },
      "metafields": [
        {
          "namespace": "custom",
          "key": "material",
          "value": "<unknown>",
          "value_type": "single_line_text_field",
          "description": "The primary material used in this product",
          "created_at": "2026-05-01T12:00:00Z",
          "updated_at": "2026-05-01T12:00:00Z",
          "locked": false
        }
      ],
      "languages": [
        "en",
        "fr"
      ],
      "kind": "manual",
      "countries": [
        "GB",
        "US"
      ],
      "total_items_count": 5,
      "library_items": [
        {
          "id": 123,
          "relateable_type": "<string>",
          "relateable_id": 123,
          "order": 123
        }
      ]
    }
  ]
}

{
  "error": {
    "message": "<string>",
    "details": {}
  },
  "status": 123,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  }
}

{
  "error": {
    "message": "<string>",
    "details": {}
  },
  "status": 123,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  }
}

Overview

Task guides

Endpoints

Auth endpoints

Checkout endpoints

Public SDK endpoints

Payment gateway endpoints

Cart payment endpoints

Commerce endpoints

Webhooks endpoints

List playlists (public storefront catalog)

Query Parameters

Response