Public Products catalog
PUBLIC endpoint — NO authentication required. Company is resolved
from the request subdomain. Returns ONLY live products (active +
resolved-published) that have an active variant in the requested
country. Non-live rows never leak.
Product price is COUNTRY-RELATIVE: the country parameter selects
which per-country variant price/currency is rendered (and drops
products with no active variant in that country). When country is
omitted, pricing falls back to the company’s default country.
Attribution params (e.g. fluid_rep_id) may be accepted as
cache-neutral pass-through but never change the response body.
Filters, search, and pagination are documented on each parameter.
curl --request GET \
--url https://api.fluid.app/api/v202604/productsimport requests
url = "https://api.fluid.app/api/v202604/products"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.fluid.app/api/v202604/products', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v202604/products",
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/products"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/v202604/products")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/products")
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,
"products": [
{
"id": 60311,
"slug": "scrute-farms-beet-blend",
"title": "Schrute Farms Beet Blend",
"canonical_url": "https://acme.fluid.app/home/products/scrute-farms-beet-blend",
"images": {
"thumb": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-200,c-at_max,f-auto,q-70/products/60311.png",
"width": 200
},
"medium": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/products/60311.png",
"width": 600
},
"large": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-1200,c-at_max,f-auto,q-80/products/60311.png",
"width": 1200
}
},
"active": true,
"status": "published",
"publish_at": null,
"metafields": [],
"languages": [
"en",
"fr"
],
"sku": "SCRUTE-BEET-001",
"is_bundle": false,
"in_stock": true,
"has_subscription_plans": true,
"pricing": {
"price": "29.99",
"currency_code": "USD",
"compare_at": "39.99",
"subscription_price": "26.99",
"display_price": "$29.99"
},
"default_variant": {
"id": 880912,
"sku": "SCRUTE-BEET-001-12OZ"
},
"skus": [
"SCRUTE-BEET-001-12OZ"
]
}
],
"meta": {
"request_id": "7f3c2a90-1c2b-4d5e-9aaa-112233445566",
"timestamp": "2026-07-15T12:34:56Z",
"pagination": {
"cursor": null,
"next_cursor": "eyJpZCI6NjAzMTF9",
"prev_cursor": null,
"limit": 25
}
}
}{
"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
Response locale. ISO code (e.g. fr, de). When omitted,
responds in the company's default locale. On reads an
unsupported or unknown locale is ignored — the response comes
back in the default locale, never a 422. Any translated field
with no value in the requested locale falls back to its en
value.
"fr"
ISO-2 country code that selects COUNTRY-RELATIVE Product pricing.
Product-only — Categories and other storefront resources use
filter[country] as an access-list visibility filter instead.
For Products, country drives the pricing block and each
variant's variant_countries: it picks which per-country variant
price and currency are rendered. On the catalog it also drops
products with no active variant in the requested country. When
omitted, falls back to the company's default country.
"GB"
Free-text search over
translation-aware title and description fields, plus slug.
On /products it additionally matches the product-level sku and
every variant SKU.
On /products the match is TIERED: the term is matched first against
the fields that NAME a product — title in every locale, slug, sku
and every variant SKU — and description / metafields answer only when
no name match survives the other filters on the request. A bundle's copy
lists the products it contains, so matching name and copy in one pass
returned every pack that merely mentions a product ahead of the product
itself.
Substring-aware (word_middle), so partial terms match. Results are
returned in the requested sort order, not by relevance — search
resolves to an id set that the ordinary paginated query then filters,
and that id set is capped at 1000 matches per request.
Opaque cursor returned in meta.pagination.next_cursor (or
prev_cursor). Omit on the first page.
Page size. Default 25. Max 100. Requests above 100 return 422.
1 <= x <= 100Stock filter. in_stock restricts to purchasable products;
all (default) imposes no stock constraint.
all, in_stock true returns only bundle products; false returns only
non-bundle products.
true returns only products that have at least one active
subscription plan; false returns only products that have none.
Matches the has_subscription_plans field on each product in the
response exactly — a product whose only plan link is inactive, or
whose only plan has been deactivated, reads false and is
returned by false. Omit the parameter to apply no subscription
constraint.
Restrict to products in any of these category ids.
Restrict to products assigned any of these tag IDs, regardless of tag source. Other filters are combined using AND. Unknown IDs match no products; an empty list applies no tag filter.
Restrict to products in any of these collection ids.
Single sort key. Prefix with - for descending. Default
priority then id.
priority, -priority, title, -title, created_at, -created_at, updated_at, -updated_at Response
A page of live products with country-relative pricing.
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.
curl --request GET \
--url https://api.fluid.app/api/v202604/productsimport requests
url = "https://api.fluid.app/api/v202604/products"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.fluid.app/api/v202604/products', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v202604/products",
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/products"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/v202604/products")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/products")
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,
"products": [
{
"id": 60311,
"slug": "scrute-farms-beet-blend",
"title": "Schrute Farms Beet Blend",
"canonical_url": "https://acme.fluid.app/home/products/scrute-farms-beet-blend",
"images": {
"thumb": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-200,c-at_max,f-auto,q-70/products/60311.png",
"width": 200
},
"medium": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/products/60311.png",
"width": 600
},
"large": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-1200,c-at_max,f-auto,q-80/products/60311.png",
"width": 1200
}
},
"active": true,
"status": "published",
"publish_at": null,
"metafields": [],
"languages": [
"en",
"fr"
],
"sku": "SCRUTE-BEET-001",
"is_bundle": false,
"in_stock": true,
"has_subscription_plans": true,
"pricing": {
"price": "29.99",
"currency_code": "USD",
"compare_at": "39.99",
"subscription_price": "26.99",
"display_price": "$29.99"
},
"default_variant": {
"id": 880912,
"sku": "SCRUTE-BEET-001-12OZ"
},
"skus": [
"SCRUTE-BEET-001-12OZ"
]
}
],
"meta": {
"request_id": "7f3c2a90-1c2b-4d5e-9aaa-112233445566",
"timestamp": "2026-07-15T12:34:56Z",
"pagination": {
"cursor": null,
"next_cursor": "eyJpZCI6NjAzMTF9",
"prev_cursor": null,
"limit": 25
}
}
}{
"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>"
}
}
}