Public Posts (blog) catalog

GET

api

v202604

posts

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/v202604/posts",
  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/posts"

	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/posts")

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>"
    }
  },
  "posts": [
    {
      "id": 7305,
      "slug": "how-we-shipped-the-summer-line",
      "title": "How We Shipped the Summer Line",
      "description": "A behind-the-scenes look at three months of work.",
      "image_url": "https://cdn.fluid.app/posts/7305.png",
      "canonical_url": "https://acme.fluid.app/home/blog/how-we-shipped-the-summer-line",
      "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"
      ],
      "countries": [
        "GB",
        "US"
      ],
      "summary": "A short lead paragraph shown on listing cards.",
      "post_date": "2026-05-01",
      "post_author": "Dwight Schrute",
      "category_id": 4821,
      "collection_ids": [
        5102,
        5103
      ]
    }
  ]
}

{
  "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

Response locale. ISO code (e.g. fr, de). When omitted, responds in the company's default locale. On the public surface, falls back to en for any translated field missing in the requested locale.

Example:

"fr"

string

Free-text search. Backed by Searchkick / Elasticsearch over translation-aware title and description fields.

page[cursor]

string

Rotulus cursor returned in meta.pagination.next_cursor (or prev_cursor). Omit on the first page.

page[limit]

integer

default:25

Page size. Default 25. Max 100. Requests above 100 return 422.

Required range: 1 <= x <= 100

filter[country]

string

ISO-2 country code. Restricts the catalog to resources available in that country — combining the with_country_iso scope's OR-empty semantics: unrestricted resources (no access_countries rows) match every country.

Example:

"GB"

filter[language]

string

ISO locale. Restricts the catalog to resources translated in that locale.

Example:

"fr"

filter[category_id]

integer

Restrict the catalog to posts filed under one Category.

filter[collection_id]

integer

Restrict the catalog to posts appearing in one Collection.

sort

enum<string>

Single sort key. Prefix with - for descending. Default sort is newest blog posts first (post_date DESC NULLS LAST).

Available options:

post_date,

-post_date,

title,

-title,

created_at,

-created_at

Response

A page of live posts.

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

posts

object[]

required

Show child attributes

Public Enrollment Pack by slug

Public Post by slug

Public Posts (blog) catalog

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/v202604/posts",
  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/posts"

	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/posts")

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>"
    }
  },
  "posts": [
    {
      "id": 7305,
      "slug": "how-we-shipped-the-summer-line",
      "title": "How We Shipped the Summer Line",
      "description": "A behind-the-scenes look at three months of work.",
      "image_url": "https://cdn.fluid.app/posts/7305.png",
      "canonical_url": "https://acme.fluid.app/home/blog/how-we-shipped-the-summer-line",
      "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"
      ],
      "countries": [
        "GB",
        "US"
      ],
      "summary": "A short lead paragraph shown on listing cards.",
      "post_date": "2026-05-01",
      "post_author": "Dwight Schrute",
      "category_id": 4821,
      "collection_ids": [
        5102,
        5103
      ]
    }
  ]
}

{
  "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

Public Posts (blog) catalog

Query Parameters

Response